Diff for /parser3/operators.ru.txt between versions 1.205 and 1.221

version 1.205, 2008/02/14 11:02:48 version 1.221, 2009/07/26 06:05:27
Line 62  Xне сделано, видимо, не будет сделано Line 62  Xне сделано, видимо, не будет сделано
     !^use[модуль]      !^use[модуль]
     !^try{      !^try{
         ...          ...
         !^throw[sql.connect;вася;болван] // был ^error[текст]          !^throw[sql.connect[;вася[;болван]]] // был ^error[текст]
           !^throw[
                   $.type[sql.connect]
                   $.source[вася]
                   $.comment[болван]
           ]
         ...          ...
     }{      }{
         ^if($exception.type eq sql){          ^if($exception.type eq "sql"){
             $exception.handled(1)  ^rem{флаг, что exception обработан}              $exception.handled(1|true)  ^rem{флаг, что exception обработан}
             ....              ....
         }          }
                   
         ^switch($exception.type){          ^switch[$exception.type]{
             ^case[sql;mail]{              ^case[sql;mail]{
                 $exception.handled(1)                  $exception.handled(1)
                 код, обрабатывающий sql ошибку                  код, обрабатывающий sql ошибку
                 $exception.type = sql.connect                  $exception.type = sql.connect
                 $exception.file $exception.lineno [если не запрещены при компиляции]                  $exception.file $exception.lineno $exception.colno [если не запрещены при компиляции]
                 $exception.source = вася                  $exception.source = вася
                 $exception.comment = болван                  $exception.comment = болван
             }              }
             ^case[DEFAULT]{              ^case[DEFAULT]{
                 код, обрабатывающий другую ошибку                  код, обрабатывающий другую ошибку
                 ^throw[$exception] << re-throw                  ^throw[$exception] << re-throw // DON'T! It's default behaviour!
             }              }
         }          }
     }      }
Line 91  Xне сделано, видимо, не будет сделано Line 96  Xне сделано, видимо, не будет сделано
         выдавая нестандартный результат          выдавая нестандартный результат
     !^break[] + - обрывает цикл      !^break[] + - обрывает цикл
     !^continue[] + - обрывает итерацию цикла      !^continue[] + - обрывает итерацию цикла
     !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html|regex]]{код}      !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html|regex|parser-code]]{код}
         default as-is          default as-is
     !^taint[[lang]][код]      !^taint[[lang]][код]
         default "just tainted, language unknown"          default "just tainted, language unknown"
Line 107  Xне сделано, видимо, не будет сделано Line 112  Xне сделано, видимо, не будет сделано
             ClientCharset=parser-charset << charset in which parser thinks client works              ClientCharset=parser-charset << charset in which parser thinks client works
             charset=cp1251_koi8&              charset=cp1251_koi8&
             timeout=3&              timeout=3&
             compress=1&              compress=0&
             named_pipe=1&              named_pipe=1&
               multi_statements=1& allow execute more then one query in one parser :sql{} request
             autocommit=1              autocommit=1
             autocommit если выставить в 0, будет делать commit/rollback              autocommit если выставить в 0, будет делать commit/rollback
   
Line 133  Xне сделано, видимо, не будет сделано Line 139  Xне сделано, видимо, не будет сделано
         !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset          !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset
             ClientCharset << charset in which parser thinks client works              ClientCharset << charset in which parser thinks client works
                           
         !sqlite://database          !sqlite://DBfile?
                   ClientCharset=parser-charset& << charset in which parser thinks client works
                   autocommit=1
   
         для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p)          для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p)
         была определена таблица          была определена таблица
 #sql drivers  #sql drivers
 $SQL[  $SQL[
     $.drivers[^table::create{protocol    driver    client      $.drivers[^table::create{protocol   driver  client
 mysql    /www/parser3/libparser3mysql.so    /usr/local/lib/mysql/libmysqlclient.so  mysql   /www/parser3/libparser3mysql.so /usr/local/lib/mysql/libmysqlclient.so
 pgsql    /www/parser3/libparser3pgsql.so    /usr/local/pgsql/lib/libpq.so  pgsql   /www/parser3/libparser3pgsql.so /usr/local/pgsql/lib/libpq.so
 oracle    /www/parser3/libparser3oracle.so    /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data  oracle  /www/parser3/libparser3oracle.so        /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data
 sqlite    /www/parser3/libparser3sqlite.so    /usr/local/sqlite/lib/sqlite3.so  sqlite  /www/parser3/libparser3sqlite.so        /usr/local/sqlite/lib/sqlite3.so
 odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll  odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll
 }]  }]
 ]  ]
         !в таблице у oracle в столбце клиентской библиотеки          !в таблице у oracle в столбце клиентской библиотеки
Line 296  odbc    c:\drives\y\parser3project\odbc\ Line 304  odbc    c:\drives\y\parser3project\odbc\
     !^строка.bool[] + .bool(default)  bool значение строки      !^строка.bool[] + .bool(default)  bool значение строки
         если ломается преобразование, берётся default          если ломается преобразование, берётся default
     !^строка.format[формат] %d  %.2f %02d...      !^строка.format[формат] %d  %.2f %02d...
     !^строка.match[шаблон][[опции поиска]]  $prematch $match $postmatch $1 $2...      !^строка.match[шаблон-строка|шаблон-regex][[опции поиска]]  $prematch $match $postmatch $1 $2...
         опции поиска=          опции поиска=
         i CASELESS          i CASELESS
         x whitespace in regex ignored          x whitespace in regex ignored
Line 305  odbc    c:\drives\y\parser3project\odbc\ Line 313  odbc    c:\drives\y\parser3project\odbc\
         g найти все вхождения, а не одно          g найти все вхождения, а не одно
         ' создавать столбцы prematch, match, postmatch          ' создавать столбцы prematch, match, postmatch
         n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами          n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами
     !^строка.match[шаблон][опции поиска]{замена}          U инвертировать смысл модификатора '?'
       !^строка.match[шаблон-строка|шаблон-regex][опции поиска]{замена}
         опции поиска+=          опции поиска+=
         g заменить все вхождения, а не одно          g заменить все вхождения, а не одно
     !^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]]      !^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]]
Line 323  odbc    c:\drives\y\parser3project\odbc\ Line 332  odbc    c:\drives\y\parser3project\odbc\
     !^строка.left(N)      !^строка.left(N)
     !^строка.right(N)      !^строка.right(N)
     !^строка.pos[подстрока]      !^строка.pos[подстрока]
       !^строка.pos[подстрока](позиция, с которой ищем)
         <0 = не найдено          <0 = не найдено
     !^строка.replace[$таблица_подстановок_строка_на_строку]      !^строка.replace[$таблица_подстановок_строка_на_строку]
     !^строка.save[[append;]путь]      !^строка.save[[append;]путь]
     !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены      !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены
         полезно делать перед сложными match операциями, если вы знаете, что входная строка          полезно делать перед сложными match операциями, если вы знаете, что входная строка
         состоит из большого числа фрагментов          состоит из большого числа фрагментов
     !^строка.trim[start|both|end[;chars]] выкидывает chars из начала/конца/и начала и конца      !^строка.trim[start|both|end|left|right[;chars]] выкидывает chars из начала/конца/и начала и конца
         default 'chars' -- whitespace chars          default 'chars' -- whitespace chars
     !^строка.append[string]      !^строка.append[string]
     !^строка.base64[] encode      !^строка.base64[] encode
Line 441  odbc    c:\drives\y\parser3project\odbc\ Line 451  odbc    c:\drives\y\parser3project\odbc\
     $sessions.$sid[$.value[$uid] $.expires(1)]      $sessions.$sid[$.value[$uid] $.expires(1)]
     $uid[$sessions.$sid]      $uid[$sessions.$sid]
   
   
 !form  !form
     [берётся первый элемент из одноимённых из GET, потом первый из POST]      [берётся первый элемент из одноимённых из GET, потом первый из POST]
     !$form:поле = string/file       !$form:поле = string/file 
Line 452  odbc    c:\drives\y\parser3project\odbc\ Line 463  odbc    c:\drives\y\parser3project\odbc\
     !$form:imap = хэш с ключами 'x' и 'y'      !$form:imap = хэш с ключами 'x' и 'y'
         со значением ?1,2 приписки при использовании server-site image map          со значением ?1,2 приписки при использовании server-site image map
   
   
 !env  !env
     !$env:переменная      !$env:переменная
     !$env:PARSER то же самое, что показывается при запуске parser.cgi      !$env:PARSER то же самое, что показывается при запуске parser.cgi
   
   
 !cookie  !cookie
     !$cookie:имя считать старое или свежезаданное      !$cookie:имя считать старое или свежезаданное
     !$cookie:имя[значение] на 90 дней      !$cookie:имя[значение] на 90 дней
Line 484  odbc    c:\drives\y\parser3project\odbc\ Line 497  odbc    c:\drives\y\parser3project\odbc\
         ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN          ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN
         поэтому необходимо задать $request/response:charset в одном из них. не после.          поэтому необходимо задать $request/response:charset в одном из них. не после.
   
   
 !response  !response
     !$response:поле[значение]  и можно считать старое -- $response:поле      !$response:поле[значение]  и можно считать старое -- $response:поле
         !значение может быть string а может быть hash:          !значение может быть string а может быть hash:
Line 506  odbc    c:\drives\y\parser3project\odbc\ Line 520  odbc    c:\drives\y\parser3project\odbc\
         ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN          ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN
         поэтому необходимо задать $request/response:charset в одном из них. не после.          поэтому необходимо задать $request/response:charset в одном из них. не после.
   
   
   !regex
       !в выражении 
           !логическое значение всегда равно true
           !числовое значение равно количеству байт скомпилированного шаблона.
       !^regex::create[шаблон-строка][[опции поиска]]
       !^шаблон.size[] количество байт скомпилированного шаблона
           если значение очень большое -- стоит почитать документацию по pcre и, возможно, переписать шаблон.
       !^шаблон.study_size[] размер study-структуры. если==0 -- шаблон не может быть "изучен"
       ^шаблон.save[filespec]
       ^шаблон.load[filespec]
   
   
   !reflection
       !^reflection:create[класс;конструктор[;пара;[мет[;ры]]]]  вызывает указанный конструктор класса
       !^reflection:class[объект]       класс переданного объекта
       !^reflection:class_name[объект]  имя класса переданного объекта
       !^reflection:base[объект]        класс переданного объекта
       !^reflection:base_name[объект]   имя класса переданного объекта
       !^reflection:methods[класс]              хеш со списком методов указанного класса, значения -- строки 'native' или 'parser'
       !^reflection:method_params[класс;метод]  хеш с параметрами указанного метода класса
            для native классов возвращается хеш:
                .min_params(минимально необходимое число параметров)
                .max_params(максимально возможное число параметров)
                .call_type[dynamic|static|any]
            для parser классов возвращается хеш:
                ключ -- номер параметра (0, 1, ...), значение - имя парметра
   
   
 !mail  !mail
     !$mail.received=MESSAGE:      !$mail.received=MESSAGE:
         .from          .from
Line 656  odbc    c:\drives\y\parser3project\odbc\ Line 699  odbc    c:\drives\y\parser3project\odbc\
     !^картинка.polyline+(цвет)[table x:y точки]      !^картинка.polyline+(цвет)[table x:y точки]
     !^картинка.polygon(цвет)[table x:y вершины_многоугольника]      !^картинка.polygon(цвет)[table x:y вершины_многоугольника]
     !^картинка.polybar(цвет)[table x;y вершины_многоугольника]      !^картинка.polybar(цвет)[table x;y вершины_многоугольника]
     !^картинка.font[набор_букв;имя_файла_шрифта.gif](ширина_пробела[;ширина_символа])      !^картинка.font[набор_букв;имя_файла_шрифта.gif][(ширина_пробела[;ширина_символа])]
         высота символа = высота картинки/количество букв в наборе          высота символа = высота картинки/количество букв в наборе
         если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif          если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif
       !^картинка.font[набор_букв;имя_файла_шрифта.gif;
              $.space(ширина_пробела)             // по умолчанию = ширине gif
              $.width(ширина_символа)             // см. выше, по умолчанию proportional
              $.spacing(расстояние между буквами) // по умолчанию = 1
        ]
     !^картинка.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
Line 679  odbc    c:\drives\y\parser3project\odbc\ Line 727  odbc    c:\drives\y\parser3project\odbc\
     !^картинка.pixel(x;y)[(color)]      !^картинка.pixel(x;y)[(color)]
         узнать или задать цвет пиксела          узнать или задать цвет пиксела
   
   
 !file  !file
     !$файл_из_post.name       !$файл_из_post.name 
     !$файл_из_post.size       !$файл_из_post.size 
Line 686  odbc    c:\drives\y\parser3project\odbc\ Line 735  odbc    c:\drives\y\parser3project\odbc\
     !^файл.save[text|binary;имя файла]      !^файл.save[text|binary;имя файла]
     !^file:delete[имя файла]      !^file:delete[имя файла]
     !^file:find[имя файла][{когда не нашли}]      !^file:find[имя файла][{когда не нашли}]
     !^file:list[путь[;шаблон]] = table с колонкой name      !^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонкой name
     !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]]      !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]]
     !^file::create[text;имя;^untaint[xml]{data}]      !^file::create[text;имя;^untaint[xml]{data}]
     !$файл_который_был_loaded.size      !$файл_который_был_loaded.size
       !$файл_который_был_loaded_или_created.mode = text/binary
     !^file::stat[имя файла]      !^file::stat[имя файла]
     !$файл_который_был_stated.size !.adate !.mdate !.cdate      !$файл_который_был_stated_или_loaded.size !.adate !.mdate !.cdate
     !^file::cgi[[text|binary;]имя файла[;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]]      !^file::cgi[[text|binary;]имя файла[;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]]
         возвращённый заголовок рассыпается на $поля          возвращённый заголовок рассыпается на $поля
         $status          $status
         $stderr          $stderr
     !^file::exec[[text|binary;]имя файла[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under win32 max 10 args]]]]]]]      !^file::exec[[text|binary;]имя файла[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under unix max 50 args]]]]]]]
         options:          options:
             $.stdin[текст]  если текст пуст, отключается автоматическое пересовывание данных HTTP-POST               $.stdin[текст]  если текст пуст, отключается автоматическое пересовывание данных HTTP-POST 
     !^file:move[старое имя файла;новое имя файла]       !^file:move[старое имя файла;новое имя файла] 
Line 740  odbc    c:\drives\y\parser3project\odbc\ Line 790  odbc    c:\drives\y\parser3project\odbc\
         выдает digest файла, длиной 16 байт в виде строки,           выдает digest файла, длиной 16 байт в виде строки, 
         где байты digest выданы в hex виде, впритык, в нижнем регистре          где байты digest выданы в hex виде, впритык, в нижнем регистре
   
   
 !math  !math
     !$math:PI      !$math:PI
     !^math:round floor ceiling       !^math:round floor ceiling 
Line 770  odbc    c:\drives\y\parser3project\odbc\ Line 821  odbc    c:\drives\y\parser3project\odbc\
     !^math:crc32[string]      !^math:crc32[string]
        вычисляет crc32 строки         вычисляет crc32 строки
     !^math:sha1[string]      !^math:sha1[string]
     !^math:long2ip(long)  
   
   !inet
       !^inet:ntoa(long)
       !^inet:aton[IP]
   
   
 !date  !date
     !время типа time можно использовать в выражениях, подставляет       !время типа time можно использовать в выражениях, подставляет 
Line 802  odbc    c:\drives\y\parser3project\odbc\ Line 858  odbc    c:\drives\y\parser3project\odbc\
         столбцы: year, month, day, weekday          столбцы: year, month, day, weekday
     !^date:last-day(год;месяц) вернёт последний день месяца      !^date:last-day(год;месяц) вернёт последний день месяца
     !^дата.last-day[] вернёт последний день месяца $дата      !^дата.last-day[] вернёт последний день месяца $дата
       !^дата.gmt-string[]  Fri, 23 Mar 2001 09:32:23 GMT
   
   
 xdoc(xnode)  xdoc(xnode)
Line 836  xdoc(xnode) Line 893  xdoc(xnode)
     ::sql{...}      ::sql{...}
     !::create[[URI]]{<?xml?><string/>} старое имя 'set'      !::create[[URI]]{<?xml?><string/>} старое имя 'set'
     !::create[[URI]][qualifiedName]      !::create[[URI]][qualifiedName]
     !::create[file] can be usable: $f[^file::load[binary;http://;some http options here...]]$x[^xdoc::create[$f]]  
       URI default = disk path to requested document        URI default = disk path to requested document
       для каталогов конечный / обязателен        для каталогов конечный / обязателен
       !::create[file] can be usable:
           $f[^file::load[binary;http://;some HTTP options here...]]
           $x[^xdoc::create[$f]]
     !::load[file.xml[;опции]]      !::load[file.xml[;опции]]
     !.transform[rules.xsl|xdoc][[params hash]] выдаёт dom      !.transform[rules.xsl|xdoc][[params hash]] выдаёт dom
         шаблон кэшируется, кэш обновляется при изменении даты файла шаблона,          шаблон кэшируется, кэш обновляется при изменении даты файла шаблона,
Line 1083  DATA::=string | file | hash Line 1142  DATA::=string | file | hash
     !определив      !определив
     !@unhandled_exception[exception;stack]      !@unhandled_exception[exception;stack]
     !$exception.type  строка "тип проблемы"      !$exception.type  строка "тип проблемы"
     !$exception.file $exception.lineno файл и строка где случилась проблема [если не запрещены при компиляции]      !$exception.file $exception.lineno $exception.colno файл, строка и позиция, где случилась проблема [если не запрещены при компиляции]
     !$exception.source строка, из-за которой случилась проблема      !$exception.source строка, из-за которой случилась проблема
     !$exception.comment комментарий english      !$exception.comment комментарий english
     !stack табличка из колонок file line name,      !stack табличка из колонок file line name,
Line 1095  DATA::=string | file | hash Line 1154  DATA::=string | file | hash
     !а также, возможно, указать опции:      !а также, возможно, указать опции:
         !$.method[GET|POST|HEAD]          !$.method[GET|POST|HEAD]
         !$.timeout(3)  << в секундах, по-умолчанию =2          !$.timeout(3)  << в секундах, по-умолчанию =2
           !$.cookies[
                   $.имя[значение]
           ]
         !$.headers[          !$.headers[
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК          !    $.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]          !]
         $.enctype[multipart/form-data]          $.enctype[multipart/form-data]
         $.form[          $.form[
Line 1127  DATA::=string | file | hash Line 1189  DATA::=string | file | hash
     !file.lock                                                        shared/exclusive lock error      !file.lock                                                        shared/exclusive lock error
     !file.missing         ^file:delete[delme]                         not found      !file.missing         ^file:delete[delme]                         not found
     !file.access          ^table::load[.]                             no rights      !file.access          ^table::load[.]                             no rights
       !file.read            ^file::load[...]                            error while reading file
     !file.seek                                                        seek failed      !file.seek                                                        seek failed
       !file.execute         ^file::cgi[...]                             incorrect cgi header/can't execute
     !image.format         ^image::measure[index.html]                 not gif/jpg      !image.format         ^image::measure[index.html]                 not gif/jpg
     !sql.connect          ^connect[mysql://baduser:pass@host/db]{}    not found/timeout      !sql.connect          ^connect[mysql://baduser:pass@host/db]{}    not found/timeout
     !sql.execute          ^void:sql{select bad}                       syntax error      !sql.execute          ^void:sql{select bad}                       syntax error
Line 1145  DATA::=string | file | hash Line 1209  DATA::=string | file | hash
     !http.timeout         ^file::load[http://host/doc]                whole load operation failed to complete in # seconds      !http.timeout         ^file::load[http://host/doc]                whole load operation failed to complete in # seconds
     !http.response        ^file::load[http://ok/there]                host found, connection accepted, bad answer      !http.response        ^file::load[http://ok/there]                host found, connection accepted, bad answer
     !http.status          ^file::load[http://ok/there]                host found, connection accepted, status!=200      !http.status          ^file::load[http://ok/there]                host found, connection accepted, status!=200
           !date.range           ^date::create(1950;1;1)                     date out of valid range
   
 !нужно выключить русский apache: CharsetDisable on  !нужно выключить русский apache: CharsetDisable on
   
 Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет  Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет

Removed from v.1.205  
changed lines
  Added in v.1.221


E-mail: