Diff for /parser3/operators.ru.txt between versions 1.201 and 1.231

version 1.201, 2007/10/17 13:38:40 version 1.231, 2010/09/17 00:01:03
Line 56  Xне сделано, видимо, не будет сделано Line 56  Xне сделано, видимо, не будет сделано
   
                         
     !^if(условие){когда да}{когда нет}      !^if(условие){когда да}{когда нет}
       !^if(условие1){да}[(условие2){да}[(условие2){да}[...]]]{нет} -- количество доп. условий не ограничено (в общем elseif это :)
     !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}}      !^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}}
     !^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^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 97  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 113  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 140  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 288  odbc    c:\drives\y\parser3project\odbc\ Line 297  odbc    c:\drives\y\parser3project\odbc\
         пример:          пример:
         ^if(def $form:name) не пуста?          ^if(def $form:name) не пуста?
         ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?]          ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?]
     !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]]      !^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]]
         результат запроса должен быть один столбец/одна строка          результат запроса должен быть один столбец/одна строка
     !^строка.int[] .int(default) целочисленное значение строки.       !^строка.int[] .int(default) целочисленное значение строки. 
         если ломается преобразование, берётся default          если ломается преобразование, берётся default
Line 296  odbc    c:\drives\y\parser3project\odbc\ Line 305  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 314  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 333  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;]путь]
       !^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]]
     !^строка.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 349  odbc    c:\drives\y\parser3project\odbc\ Line 361  odbc    c:\drives\y\parser3project\odbc\
         !$.separator[^#09]          !$.separator[^#09]
         !$.encloser["] по-умолчанию, нет.          !$.encloser["] по-умолчанию, нет.
     !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]]      !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]]
         bind привязывает переменные в запросе к их значениям          bind привязывает переменные в запросе к их значениям
         пока реализован только для oracle          пока реализован только для oracle
         в запросе надо написать ":имя"          в запросе надо написать ":имя"
         в параметре bind передать hash, из которого возьмётся(или куда запишется) значение          в параметре bind передать hash, из которого возьмётся(или куда запишется) значение
     !^таблица.save[[nameless|append;]путь[;опции, см. load]]      !^таблица.save[[nameless|append;]путь[;опции, см. load]]
     !$таблица.поле      !$таблица.поле
     !$таблица.fields  из named таблицы выдаёт текущую запись как Hash      !$таблица.fields  из named таблицы выдаёт текущую запись как Hash
Line 414  odbc    c:\drives\y\parser3project\odbc\ Line 426  odbc    c:\drives\y\parser3project\odbc\
     !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^хеш.delete[ключ]  удалить ключ      !^хеш.delete[ключ]  удалить ключ
     !^хеш.contain[ключ] - существует ли в хеше ключ (bool)      !^хеш.contain[ключ] - существует ли в хеше ключ (bool)
       !^хэш._at[first|last]
       !^хэш._at([-]N)
           доступ к заданным элементам упорядоченного хеша
   
 !hashfile  !hashfile
     !^hashfile::open[filename]      !^hashfile::open[filename]
Line 441  odbc    c:\drives\y\parser3project\odbc\ Line 456  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 468  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 473  odbc    c:\drives\y\parser3project\odbc\ Line 491  odbc    c:\drives\y\parser3project\odbc\
     !$request:document-root      !$request:document-root
         каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT          каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT
         можно изменить, если на hosting что-то неудобно настроено          можно изменить, если на hosting что-то неудобно настроено
       !$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла].
     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 483  odbc    c:\drives\y\parser3project\odbc\ Line 502  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 493  odbc    c:\drives\y\parser3project\odbc\ Line 513  odbc    c:\drives\y\parser3project\odbc\
     !$response:headers накопленные поля      !$response:headers накопленные поля
     !$response:body[DATA]  замещает стандартный ответ      !$response:body[DATA]  замещает стандартный ответ
     !$response:download[DATA]  замещает стандартный ответ,       !$response:download[DATA]  замещает стандартный ответ, 
         выставляет флаг, заставляющий browser предложить download          выставляет флаг, заставляющий browser предложить download
     !$response:status      !$response:status
     !^response:clear[] забыть все заданные response поля      !^response:clear[] забыть все заданные response поля
     !$response:charset      !$response:charset
Line 505  odbc    c:\drives\y\parser3project\odbc\ Line 525  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[класс;конструктор[;пара;[мет[;ры]]]]  вызывает указанный конструктор класса (не более 100 параметров)
       !^reflection:classes[]                 хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void
       !^reflection:class[объект]             класс переданного объекта
       !^reflection:class_name[объект]        имя класса переданного объекта
       !^reflection:base[объект]              родительский класс переданного объекта
       !^reflection:base_name[объект]         имя родительского класса переданного объекта
       !^reflection:methods[класс]            хеш со списком методов указанного класса, значения -- строки 'native' или 'parser'
       !^reflection:fields[класс или объект]  хеш со списком статических полей указанного класса или динамических полей указанного объекта
       !^reflection:method_info[класс;метод]  хеш с параметрами указанного метода класса
            $.inherited[класс]                имя класса, где метод был определён (возвращается только если метод был определён в предке)
            для native классов возвращается хеш:
                .min_params(минимально необходимое число параметров)
                .max_params(максимально возможное число параметров)
                .call_type[dynamic|static|any]
            для parser классов возвращается хеш:
                ключ -- номер параметра (0, 1, ...), значение - имя параметра
       !^reflection:dynamical[[object or class, caller if absent]]    возвращает true, если метод был вызван из динамического контекста
                                                                      при передаче параметра возвращает true, если передан динамический объект,
                                                                      false если класс
   
   
 !mail  !mail
     !$mail.received=MESSAGE:      !$mail.received=MESSAGE:
         .from          .from
Line 533  odbc    c:\drives\y\parser3project\odbc\ Line 588  odbc    c:\drives\y\parser3project\odbc\
         $.message#[MESSAGE] (message, message2, ...)          $.message#[MESSAGE] (message, message2, ...)
   
     !^mail:send[      !^mail:send[
         $.options[-odd]          $.options[-odd]
                 unix: строка, которая будет добавлена к команде запуска sendmail              unix: строка, которая будет добавлена к команде запуска sendmail
                     -odd означает "быстро поставь в очередь без проверки email"                  -odd означает "быстро поставь в очередь без проверки email"
                 win32: игнорируется              win32: игнорируется
         $.charset[кодировка заголовка и текстовых блоков]           $.charset[кодировка заголовка и текстовых блоков] 
         $.any-header-field           $.any-header-field 
         $.text[string]          $.text[string]
Line 655  odbc    c:\drives\y\parser3project\odbc\ Line 710  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 678  odbc    c:\drives\y\parser3project\odbc\ Line 738  odbc    c:\drives\y\parser3project\odbc\
     !^картинка.pixel(x;y)[(color)]      !^картинка.pixel(x;y)[(color)]
         узнать или задать цвет пиксела          узнать или задать цвет пиксела
   
   
 !file  !file
     !$файл_из_post.name       !$файл_из_post.name 
     !$файл_из_post.size       !$файл_из_post.size 
     !$файлtиз_post.text      !$файлtиз_post.text
     !^файл.save[text|binary;имя файла]      !^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем]]]
     !^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;имя;data]
       !^file::create[text;имя;data[;$.charset[кодировка букв в создаваемом файле]]]
     !$файл_который_был_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[имя файла[;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[имя файла[;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 719  odbc    c:\drives\y\parser3project\odbc\ Line 782  odbc    c:\drives\y\parser3project\odbc\
     !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать      !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать
     X^file::sql[[имя_файла_для_download]]{}      X^file::sql[[имя_файла_для_download]]{}
     !^file::sql{}[[      !^file::sql{}[[
         $.name[имя_файла_для_download]          $.name[имя_файла_для_download]
         $.content-type[пользовательский content-type]          $.content-type[пользовательский content-type]
     ]]      ]]
         результат запроса должен быть "одна строка".          результат запроса должен быть "одна строка".
         колонки:          колонки:
         первая колонка - данные          первая колонка - данные
         если есть вторая - это имя файла          если есть вторая - это имя файла
         если есть третья - это content-type          если есть третья - это content-type
     !^файл.base64[] encode      !^файл.base64[] encode
     !^file:base64[имя файла] encode      !^file:base64[имя файла]
     !^file::base64[encoded string] decode          encode
       !^file::base64[encoded string]
       !^file::base64[mode;имя файла;encoded string[;$.content-type[...]]]
           decode
     !^file:crc32[имя файла]      !^file:crc32[имя файла]
        вычисляет crc32 файла с указанным именем          вычисляет crc32 файла с указанным именем
     !^файл.crc32[]      !^файл.crc32[]
                 вычисляет crc32 объекта          вычисляет crc32 объекта
         !^файл.md5[]      !^файл.md5[]
         !^file:md5[имя файла]      !^file:md5[имя файла]
         выдает digest файла, длиной 16 байт в виде строки,           выдает digest файла, длиной 16 байт в виде строки, 
         где байты digest выданы в hex виде, впритык, в нижнем регистре          где байты digest выданы в hex виде, впритык, в нижнем регистре
   
   
 !math  !math
     !$math:PI      !$math:PI
     !^math:round floor ceiling       !^math:round floor ceiling 
Line 769  odbc    c:\drives\y\parser3project\odbc\ Line 836  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]
   
   !json
       !^json:parse[-json-строка-[;
           $.depth(максимальная глубина, default == 19)
           $.double(false)              отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен)
                                        в этом случае они попадут в результирующий объект как строки
           $.distinct[first|last|all]   как будет происходить разбор дублирующихся ключей у объектов
                                        first -- будет оставлен первый встретившийся элемент
                                        last  -- будет оставлен последний встретившийся элемент
                                        all   -- будут оставлены все элементы. при этом элементы, начиная со 2
                                                 получат числовые суффиксы (key_2 итд)
                                        по умолчанию дублирующиеся ключи приводыт к exception
           $.object[method-junction]    пользовательский метод, которому будут передаваться все разобранные пары
                                        ключ/значение
       ]]
           парсит json-строку в хэш
       !^json:string[system or user object[;
           $.skip-unknown(false)    отключить exception и выдавать 'null' при сериализации объектов с типами
                                    отличных от void, bool, string, int, double, date, table, hash и file
           $.date[sql-string|gmt-string|unix-timestamp]    формат вывода даты, по умолчанию -- sql-string
           $.table[object|array]    формат вывода таблицы, по умолчанию -- object
                                    object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...]
                                    array:  [["c1","c2",...] || null (for nameless),["v11","v12",...],...]
           $.file[text|base64]      вывести тело файла в указанном виде (по умолчание тело файла 
                                    не попадает в output)
           $.тип[method-junction]   любой тип можно вывести с помощью пользовательского метода, который 
                                    должен принимать 2 параметра: значение и параметры
       ]]
           сериализует системный или пользовательский объект в json-строку
   
   
 !date  !date
     !время типа time можно использовать в выражениях, подставляет       !время типа time можно использовать в выражениях, подставляет 
Line 794  odbc    c:\drives\y\parser3project\odbc\ Line 895  odbc    c:\drives\y\parser3project\odbc\
     !^дата.roll[year|month|day](+-смещение) сдвигает дату      !^дата.roll[year|month|day](+-смещение) сдвигает дату
     !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co      !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co
     !^дата.sql-string[] %Y-%m-%d %H:%M:%S      !^дата.sql-string[] %Y-%m-%d %H:%M:%S
         where published='$дата.sql-string[]'          where published='^дата.sql-string[]'
     !^date:calendar[rus|eng;год;месяц] выдаёт неименованную таблицу       !^date:calendar[rus|eng](год;месяц) выдаёт неименованную таблицу 
         столбцы: 0..6, week, year          столбцы: 0..6, week, year
     !^date:calendar[rus|eng;год;месяц;день] выдаёт именнованную таблицу      !^date:calendar[rus|eng](год;месяц;день) выдаёт именнованную таблицу
         столбцы: year, month, day, weekday          столбцы: year, month, day, weekday
           !^date:last-day(год;месяц) вернёт последний день месяца
       !^дата.last-day[] вернёт последний день месяца $дата
       !^дата.gmt-string[]  Fri, 23 Mar 2001 09:32:23 GMT
   
   
 xdoc(xnode)  xdoc(xnode)
     !$xdoc.search-namespaces hash, where keys=prefixes, values=urls      !$xdoc.search-namespaces hash, where keys=prefixes, values=urls
           
Line 832  xdoc(xnode) Line 937  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 894  xdoc(xnode) Line 1001  xdoc(xnode)
     !$node.previousSibling      !$node.previousSibling
     !$node.nextSibling      !$node.nextSibling
     !$node.ownerDocument = xdoc      !$node.ownerDocument = xdoc
       !$node.prefix
       !$node.namespaceURI
     !$element_node.attributes = hash of xnodes      !$element_node.attributes = hash of xnodes
     !$element_node.tagName      !$element_node.tagName
     !$attribute_node.specified = boolean      !$attribute_node.specified = boolean
Line 1027  xdoc(xnode) Line 1136  xdoc(xnode)
   
     !$status:memory hash      !$status:memory hash
         !used          !used
             Includes some pages that were allocated but never written.                        Includes some pages that were allocated but never written.
   
         !free          !free
   
Line 1035  xdoc(xnode) Line 1144  xdoc(xnode)
             Return the number of bytes allocated since the last collection.                   Return the number of bytes allocated since the last collection.     
   
         !ever_allocated_since_start          !ever_allocated_since_start
             Return the total number of bytes [EVER(c)PAF] allocated in this process.                          Return the total number of bytes [EVER(c)PAF] allocated in this process.
             Never decreases.                                                                  Never decreases.
   
     !$status:pid process id      !$status:pid process id
     !$status:tid thread id      !$status:tid thread id
Line 1077  DATA::=string | file | hash Line 1186  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 1089  DATA::=string | file | hash Line 1198  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 1121  DATA::=string | file | hash Line 1233  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 1139  DATA::=string | file | hash Line 1253  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.201  
changed lines
  Added in v.1.231


E-mail: