Diff for /parser3/operators.ru.txt between versions 1.107.2.2 and 1.124

version 1.107.2.2, 2003/04/15 07:16:43 version 1.124, 2003/11/04 10:49:33
Line 92  Xне сделано, видимо, не будет сделано Line 92  Xне сделано, видимо, не будет сделано
         default as-is          default as-is
     !^taint[[lang]][код]      !^taint[[lang]][код]
         default "just tainted, language unknown"          default "just tainted, language unknown"
     !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}      !^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[во что переименовать @main]
       !^process..[путь][во что переименовать @main]
       по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]        по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}      !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?          !mysql://user:pass@{host[:port]|[/unix/socket]}/database?
Line 271  odbc    c:\drives\y\parser3project\odbc\ Line 272  odbc    c:\drives\y\parser3project\odbc\
         s singleline = $ считается концом всего текста          s singleline = $ считается концом всего текста
         m multiline = $ считается концом строки[\n], не концом всего текста          m multiline = $ считается концом строки[\n], не концом всего текста
         g найти все вхождения, а не одно          g найти все вхождения, а не одно
           ' создавать столбцы prematch, match, postmatch
     !^строка.match[шаблон][опции поиска]{замена}      !^строка.match[шаблон][опции поиска]{замена}
         опции поиска+=          опции поиска+=
         g заменить все вхождения, а не одно          g заменить все вхождения, а не одно
Line 301  odbc    c:\drives\y\parser3project\odbc\ Line 303  odbc    c:\drives\y\parser3project\odbc\
         логическое значение равно "не пуста?"          логическое значение равно "не пуста?"
         числовое значение равно count[]          числовое значение равно count[]
     !^table::create[[nameless]]{данные} старое имя "set"      !^table::create[[nameless]]{данные} старое имя "set"
     !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur]]]      !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
         клонирует таблицу              клонирует таблицу    
           reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает)
     !^table::load[[nameless;]путь[;опции]]      !^table::load[[nameless;]путь[;опции]]
         !если не nameless, названия колонок берутся из первой строки          !если не nameless, названия колонок берутся из первой строки
         !пустые строки, и строки в первой колонке содержащие '#', игнорируются                  !пустые строки, и строки в первой колонке содержащие '#', игнорируются        
           !$.separator[^#09]
           !$.encloser["] по-умолчанию, нет.
     !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]]      !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]]
     !^таблица.save[[nameless|append;]путь]      !^таблица.save[[nameless|append;]путь]
     !$таблица.поле      !$таблица.поле
Line 326  odbc    c:\drives\y\parser3project\odbc\ Line 331  odbc    c:\drives\y\parser3project\odbc\
     !^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]]     - добавляет записи из таблицы.       !^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]]     - добавляет записи из таблицы. 
         таблицы должны иметь одинаковую структуру.          таблицы должны иметь одинаковую структуру.
     !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать      !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать
     !^таблица.locate[поле;значение] передвигает текущую строку, если найдёт. выдаёт bool      !^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] 
     !^таблица.locate(логическое выражение) передвигает текущую строку, если найдёт. выдаёт bool          передвигает текущую строку, если найдёт. выдаёт bool
     !^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1)]]      !^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
           передвигает текущую строку, если найдёт. выдаёт bool
       !^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1) $.distinct[tables]]]
         значением $hash.ключ будет hash в котором поля значений будут ключами          значением $hash.ключ будет hash в котором поля значений будут ключами
         поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой          поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой
           если distinct содержит true, то не будет ошибки при повторяющихся ключах
           если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом
     !^таблица.columns[]+ таблица из одного столбца $column      !^таблица.columns[]+ таблица из одного столбца $column
     !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало      !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало
         $adults[^man.select($man.age>=18)]          $adults[^man.select($man.age>=18)]
Line 379  odbc    c:\drives\y\parser3project\odbc\ Line 388  odbc    c:\drives\y\parser3project\odbc\
 !cookie  !cookie
     !$cookie:имя считать старое или свежезаданное      !$cookie:имя считать старое или свежезаданное
     !$cookie:имя[значение] на 90 дней      !$cookie:имя[значение] на 90 дней
     !$cookie:имя[$.value[значение]  $.expires(дней, 0дней=session)]      !$cookie:имя[$.value[значение]  $.expires ЗНАЧЕНИЕ ]
       !значение поля expires может быть 'session', date, или число дней(0дней=session)
       ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
   
 !request  !request
     !$request:query          !$request:query    
     !$request:body unprocessed POST request body      !$request:body unprocessed POST request body
     !$request:uri      !$request:uri
       !$request:document-root
           каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT
           можно изменить, если на hosting что-то неудобно настроено
     X!$request:browser  это hash, поля:      X!$request:browser  это hash, поля:
         !$type = ie/nn и !$version = номер, скажем 5.5                 !$type = ie/nn и !$version = номер, скажем 5.5       
     X$request:user      X$request:user
Line 596  Xhashfile Line 610  Xhashfile
         если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif          если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif
     !^картинка.text(x;y)[текст_надписи] AS_IS      !^картинка.text(x;y)[текст_надписи] AS_IS
     !^картинка.length[текст_надписи] AS_IS      !^картинка.length[текст_надписи] AS_IS
     !^картинка.gif[] -- кодирует в FILE с content-type=image/gif      !^картинка.gif[возможно, имя файла] -- кодирует в FILE с content-type=image/gif
           имя файла будет использовано при $response:download
     !^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color)      !^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color)
     !^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color)      !^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color)
     !^картинка.circle(center x;center y;r;color)      !^картинка.circle(center x;center y;r;color)
Line 648  Xhashfile Line 663  Xhashfile
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif      !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif
   
   
 math  !math
     !$math:PI      !$math:PI
     !^math:round floor ceiling       !^math:round floor ceiling 
     !^math:trunc frac      !^math:trunc frac
Line 658  math Line 673  math
     !^math:degrees radians      !^math:degrees radians
     !^math:pow sqrt      !^math:pow sqrt
     !^math:random(ширина диапазона)      !^math:random(ширина диапазона)
     ^math:GUID[]      !^math:uuid[]
         C2C0983C-E26E-4169-BD07-77ECE9405BA5          22C0983C-E26E-4169-BD07-77ECE9405BA5
           win32: пользуется cryptapi
           unix: пользуется /dev/urandom, 
               если нет, /dev/random, 
               если нет, rand 
               [на solaris /dev/random можно добавить]
       !^math:uid64[]
          BA39BAB6340BE370
     !^math:md5[string]      !^math:md5[string]
         выдает digest строки, длиной 16 байт в виде строки,           выдает digest строки, длиной 16 байт в виде строки, 
         где байты digest выданы в hex виде, впритык, в нижнем регистре          где байты digest выданы в hex виде, впритык, в нижнем регистре
Line 684  math Line 706  math
         для удобного создания по значению из базы          для удобного создания по значению из базы
         формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]          формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
         формат2: %H:%M[:%S]          формат2: %H:%M[:%S]
     !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving      !^date::unix-timestamp()
       !^date.unix-timestamp[]
       !$date.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ
         read-only          read-only
           TZ="" << локальная зона
     !^date.roll[year|month|day](+-смещение) сдвигает дату      !^date.roll[year|month|day](+-смещение) сдвигает дату
       !^date.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour&co
     !^date.sql-string[] %Y-%m-%d %H:%M:%S      !^date.sql-string[] %Y-%m-%d %H:%M:%S
         where published='$дата.sql-string[]'          where published='$дата.sql-string[]'
     !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу       !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу 
Line 872  xdoc(xnode) Line 898  xdoc(xnode)
         attribute that is already inuse          attribute that is already inuse
         elsewhere          elsewhere
   
   !memory
       !^memory:compact[] собрать мусор, освободив место под новые данные
       (предупреждение: память процесса никогда не освобождается)
       полезно делать перед XSL transform.
   
 !status  !status
     !чтобы класс был доступен, в apache нужно сказать       !чтобы класс был доступен, в apache нужно сказать 
     <Location /parser-status.html>      <Location /parser-status.html>
Line 908  xdoc(xnode) Line 939  xdoc(xnode)
            $s[$status:rusage]             $s[$status:rusage]
            ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]             ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]
   
       !$status:memory hash
           !used
               Includes some pages that were allocated but never written.          
   
           !free
   
           !ever_allocated_since_compact
               Return the number of bytes allocated since the last collection.     
   
           !ever_allocated_since_start
               Return the total number of bytes [EVER(c)PAF] allocated in this process.            
               Never decreases.                                                    
   
   
 !DATA::=string | file  !DATA::=string | file
   
Line 942  xdoc(xnode) Line 986  xdoc(xnode)
   
 !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:  !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:
     !http://domain/document?params      !http://domain/document?params
     !для http:// можно, указать опции:      !а также, возможно, указать опции:
         !$.method[GET|HEAD]          !$.method[GET|HEAD]
         !$.timeout(3)  << в секундах, по-умолчанию =2          !$.timeout(3)  << в секундах, по-умолчанию =2
         !$.headers[          !$.headers[
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК          !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]          !]
         !по-умолчанию, user-agent=parser3          !по-умолчанию, user-agent=parser3
     !для не http:// можно, указать опции:          !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
         !$.offset(o)          !это можно отключить, передав
         !$.limit(l)          !$.any-status(1)
     !file::load в дополнительные поля записывает ПОЛЕ:значение (имена полей ответа заглавными буквами)          !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ
       !file::load в дополнительные поля записывает
           !ПОЛЕ:значение (имена полей ответа заглавными буквами)
           !tables << хеш их ПОЛЕ->table с единственным столбцом "value". 
               в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies
               todo:сделать отдельный cookies
   
 !системные типы ошибок:  !системные типы ошибок:
     !parser.compile       ^test[}                компиляция (непарная скобка, ...)      !parser.compile       ^test[}                компиляция (непарная скобка, ...)

Removed from v.1.107.2.2  
changed lines
  Added in v.1.124


E-mail: