Diff for /parser3/operators.ru.txt between versions 1.207 and 1.248

version 1.207, 2008/05/27 10:16:18 version 1.248, 2015/10/29 18:33:00
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){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
Line 80  Xне сделано, видимо, не будет сделано Line 81  Xне сделано, видимо, не будет сделано
                 $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 = болван
             }              }
Line 90  Xне сделано, видимо, не будет сделано Line 91  Xне сделано, видимо, не будет сделано
             }              }
         }          }
     }      }
     ^exit[] + - прекращяет обработку запроса.   
         удобно сделать после выставления 401 ошибки  
     ^return[результат] + - отваливает из выполнения метода,   
         выдавая нестандартный результат  
     !^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|uri|http-header|mail-header|sql|js|json|parser-code|regex|xml|html|optimized-[as-is|xml|html]]]{код}
         default as-is          default as-is
     !^taint[[lang]][код]      !^taint[[lang]][код]
         default "just tainted, language unknown"          default "just tainted, language unknown"
Line 110  Xне сделано, видимо, не будет сделано Line 107  Xне сделано, видимо, не будет сделано
     !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}      !^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?          !mysql://user:pass@{host[:port]|[/unix/socket]}/database?
             ClientCharset=parser-charset << charset in which parser thinks client works              ClientCharset=parser-charset << charset in which parser thinks client works
             charset=cp1251_koi8&              charset=UTF-8&
             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              multi_statements=1& allow execute more then one query in one parser :sql{} request
             autocommit=1              autocommit=1
Line 139  Xне сделано, видимо, не будет сделано Line 136  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 libmysqlclient.so
 pgsql   /www/parser3/libparser3pgsql.so /usr/local/pgsql/lib/libpq.so  pgsql   /www/parser3/libparser3pgsql.so 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        sqlite3.so
 odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll  odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll
 }]  }]
 ]  ]
Line 178  odbc c:\drives\y\parser3project\odbc\deb Line 177  odbc c:\drives\y\parser3project\odbc\deb
         !в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}          !в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}
     !^cache[файл][expires date]{код}[{catch код}]      !^cache[файл][expires date]{код}[{catch код}]
         !абсолютное задание времени          !абсолютное задание времени
     X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0)      !^cache[файл] удалить файл [не ругает, если его нет]
     !^cache(секунд)      !^cache(секунд)
     !^cache[expires date]      !^cache[expires date]
         !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'"          !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'"
         !в пределе: ^cache(0) отменить кэширование          !в пределе: ^cache(0) отменить кэширование
     !^cache[] выдаёт текущую expires date      !^cache[] выдаёт текущую expires date
     X^cache[read]   
         сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires",  
         выдаёт bool "получилось/нет"  
         !^sleep(seconds)  
   
   
     Xесть глобальный флажок в свойствах/командной строке "не оптимизировать"  
     !и есть исключение: ^untaint[html]{код} не оптимизируется   
         Xбезотностительно флажка  
   
     !у всех методов есть локальная переменная $result, если в неё что положить,      !у всех методов есть локальная переменная $result, если в неё что положить,
     !то _это_ будет результатом макроса, а не его тело      !то _это_ будет результатом макроса, а не его тело
Line 253  odbc c:\drives\y\parser3project\odbc\deb Line 243  odbc c:\drives\y\parser3project\odbc\deb
   
   
 !void  !void
     !^имя.length[]      !доступны все методы, присутствующие у объекта класса string, результат как у пустой строки
         0  
     !^имя.pos[...]  
         -1  
     !^имя.left(n)  
        ничего не выдаёт  
     !^имя.right(n)  
        ничего не выдаёт  
     !^имя.mid(p[;n])  
        ничего не выдаёт  
     !^имя.int[]  (default)   
         0 или default  
     !^имя.double[] (default)  
         0 или default  
     !^имя.bool[] (default)  
         false или default  
     !^void:sql{запрос без результата}{$.bind[см. table::sql]}      !^void:sql{запрос без результата}{$.bind[см. table::sql]}
   
   
Line 294  odbc c:\drives\y\parser3project\odbc\deb Line 269  odbc c:\drives\y\parser3project\odbc\deb
         пример:          пример:
         ^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 302  odbc c:\drives\y\parser3project\odbc\deb Line 277  odbc c:\drives\y\parser3project\odbc\deb
     !^строка.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 311  odbc c:\drives\y\parser3project\odbc\deb Line 286  odbc c:\drives\y\parser3project\odbc\deb
         g найти все вхождения, а не одно          g найти все вхождения, а не одно
         ' создавать столбцы prematch, match, postmatch          ' создавать столбцы prematch, match, postmatch
         n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами          n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами
     !^строка.match[шаблон][опции поиска]{замена}          U инвертировать смысл модификатора '?'
       !^строка.match[шаблон-строка|шаблон-regex][опции поиска]{замена}
         опции поиска+=          опции поиска+=
         g заменить все вхождения, а не одно          g заменить все вхождения, а не одно
     !^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]]      !^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]]
Line 322  odbc c:\drives\y\parser3project\odbc\deb Line 298  odbc c:\drives\y\parser3project\odbc\deb
     !^строка.{l|r}split[разделитель] таблица из столбца $piece      !^строка.{l|r}split[разделитель] таблица из столбца $piece
         оставлен для совместимости          оставлен для совместимости
     !^строка.upper|lower[]       !^строка.upper|lower[] 
     X^строка.truncate(предел терпенья) стиль :(  
     !^строка.length[]      !^строка.length[]
     !^строка.mid(P[;N])      !^строка.mid(P[;N])
         без N - "до конца строки"          без N - "до конца строки"
     !^строка.left(N)      !^строка.left(N), -1 выдает всю строку
     !^строка.right(N)      !^строка.right(N)
     !^строка.pos[подстрока]      !^строка.pos[подстрока]
       !^строка.pos[подстрока](позиция, с которой ищем)
         <0 = не найдено          <0 = не найдено
     !^строка.replace[$таблица_подстановок_строка_на_строку]      !^строка.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]      !^строка.trim[chars] выкидывает chars из начала и конца
     !^строка.base64[] encode      !^строка.base64[] encode
     !^string:base64[encoded] decode      !^string:base64[encoded[;$.strict(true)]] decode
       !^строка.idna[] IDNA кодирование, поддержка кириллических доменов
       !^string:idna[encoded] IDNA декодирование, поддержка кириллических доменов
       !^строка.js-escape[] кодирование для передачи в JS (%uXXXX)
       !^string:js-unescape[escaped] декодирование переданного из js
       !^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri
   
 !table  !table
     в выражении       в выражении 
Line 355  odbc c:\drives\y\parser3project\odbc\deb Line 338  odbc c:\drives\y\parser3project\odbc\deb
         !$.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
     !^таблица.menu{тело}[[разделитель]]      !^таблица.menu{тело}[[разделитель]]
     !^таблица.offset[] печатает offset      !^таблица.offset[] печатает offset
     !^таблица.offset[[whence]](5) сдвигает      !^таблица.offset[[whence]](5) сдвигает
         !whence=cur|set          !whence=cur|set
         !без whence - это cur          !без whence - это cur
     !^таблица.count[]      !^таблица.count[], ^таблица.count[rows] - количество строк в таблице
       !^таблица.count[columns] - количество столбцов таблицы
       !^таблица.count[cells] - количество ячеек в текущей строке таблицы
     !^таблица.line[] 1-based offset      !^таблица.line[] 1-based offset
     !^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc      !^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc
     !^таблица.append{данные}      !^таблица.append{данные}
     X^таблица.insert{данные}[(n)] добавить запись       !^таблица.append[ $.имя столбца[значение столбца] ]
         на текущую позицию [добавить запись на позицию n]      !^таблица.insert{данные} добавить запись на текущую позицию
     X^таблица.remove(position[;count]) - стирает запись       !^таблица.insert[ $.имя столбца[значение столбца] ]
         из текущей позиции [стирает запись из конкретной позиции]       !^таблица.delete[] - стирает запись с текущей позиции
             [стирает count записей]      !^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]] - добавляет записи из таблицы.
     !^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]] - добавляет записи из таблицы.   
         таблицы должны иметь одинаковую структуру.          таблицы должны иметь одинаковую структуру.
     !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать      !^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать
     !^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]       !^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] 
Line 415  odbc c:\drives\y\parser3project\odbc\deb Line 400  odbc c:\drives\y\parser3project\odbc\deb
     !^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]      !^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]
         получается hash(ключи=значения первая колонка ответа)          получается hash(ключи=значения первая колонка ответа)
         of hash(ключи=названия остальных колонкок ответа)          of hash(ключи=названия остальных колонкок ответа)
     !^хеш._keys[[название колонки с ключами]]+ таблица из одного столбца $key или как передадут      !^хеш.keys[[название колонки с ключами]]+ таблица из одного столбца key или как передадут
     !^хеш._count[]      !^хеш.count[]
     !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]      !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
     !^хеш.delete[ключ]  удалить ключ      !^хеш.delete[ключ]  удалить ключ
     !^хеш.contain[ключ] - существует ли в хеше ключ (bool)      !^хеш.contain[ключ] - существует ли в хеше ключ (bool)
       !^хэш.at[first|last][[key|value|hash]]
       !^хэш.at([-]N)[[key|value|hash]]
           доступ к заданным элементам упорядоченного хеша
       !^хэш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc
   
 !hashfile  !hashfile
     !^hashfile::open[filename]      !^hashfile::open[filename]
Line 447  odbc c:\drives\y\parser3project\odbc\deb Line 436  odbc c:\drives\y\parser3project\odbc\deb
     $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 458  odbc c:\drives\y\parser3project\odbc\deb Line 448  odbc c:\drives\y\parser3project\odbc\deb
     !$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:fields хэш с переменными окружения
       !$env:PARSER_VERSION версия парсера
   
   
 !cookie  !cookie
     !$cookie:имя считать старое или свежезаданное      !$cookie:имя считать старое или свежезаданное
Line 473  odbc c:\drives\y\parser3project\odbc\deb Line 466  odbc c:\drives\y\parser3project\odbc\deb
   
   
 !request  !request
     !$request:query          !$request:query
     !$request:body unprocessed POST request body  
     !$request:uri      !$request:uri
     !$request:document-root      !$request:document-root
         каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT          каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT
         можно изменить, если на hosting что-то неудобно настроено          можно изменить, если на hosting что-то неудобно настроено
     !$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла].      !$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла].
     X!$request:browser  это hash, поля:  
         !$type = ie/nn и !$version = номер, скажем 5.5         
     X$request:user  
     X$request:password  
     !$request:charset      !$request:charset
         Кодировка исходного документа           Кодировка исходного документа 
         !используется при upper/lower и match[][i]          !используется при upper/lower и match[][i]
         ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN          ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN
         поэтому необходимо задать $request/response:charset в одном из них. не после.          поэтому необходимо задать $request/response:charset в одном из них. не после.
       !$request:method метод запроса (GET|POST|PUT)
       !$request:body тело POST-запроса в виде текста
       !$request:body-file тело POST-запроса в виде файла
       !$request:body-charset кодировка POST-запроса
       !$request:headers хэш с заголовками запроса (без префикса HTTP_)
   
   
 !response  !response
     !$response:поле[значение]  и можно считать старое -- $response:поле      !$response:поле[значение]  и можно считать старое -- $response:поле
Line 500  odbc c:\drives\y\parser3project\odbc\deb Line 494  odbc c:\drives\y\parser3project\odbc\deb
     !$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 512  odbc c:\drives\y\parser3project\odbc\deb Line 506  odbc c:\drives\y\parser3project\odbc\deb
         ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN          ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN
         поэтому необходимо задать $request/response:charset в одном из них. не после.          поэтому необходимо задать $request/response:charset в одном из них. не после.
   
   
   !regex
       !в выражении 
           !логическое значение всегда равно true
           !числовое значение равно количеству байт скомпилированного шаблона.
       !^regex::create[шаблон-строка][[опции поиска]]
       !^шаблон.size[] количество байт скомпилированного шаблона
           если значение очень большое -- стоит почитать документацию по pcre и, возможно, переписать шаблон.
       !^шаблон.study_size[] размер study-структуры. если==0 -- шаблон не может быть "изучен"
   
   
   !reflection
       !^reflection:create[класс;конструктор[;пара;[мет[;ры]]]]  вызывает указанный конструктор класса (не более 100 параметров)
       !^reflection:classes[]                 хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void
       !^reflection:class[объект]             класс переданного объекта
       !^reflection:class_name[объект]        имя класса переданного объекта
       !^reflection:base[объект]              родительский класс переданного объекта
       !^reflection:base_name[объект]         имя родительского класса переданного объекта
       !^reflection:class_by_name[имя класса] получение класса по имени
       !^reflection:def[class;имя класса]     проверка класса на существование
       !^reflection:methods[класс]            хеш со списком методов указанного класса, значения -- строки 'native' или 'parser'
       !^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта
       !^reflection:fields[класс или объект]  хеш со списком статических полей указанного класса или динамических полей указанного объекта
       !^reflection:field[класс или объект;имя поля]  возвращает значение указанного поля класса или объекта. getter-ы игнорируются.
       !^reflection:uid[класс или объект]     возвращает идентификатор объекта или класса
       !^reflection:method_info[класс;метод]  хеш с параметрами указанного метода класса
            $.inherited[класс]                имя класса, где метод был определён (возвращается только если метод был определён в предке)
            $.overridden[класс]               имя класса, где метод был определён (возвращается только если метод был определён в предке)
            для native классов возвращается хеш:
                .min_params(минимально необходимое число параметров)
                .max_params(максимально возможное число параметров)
                .call_type[dynamic|static|any]
            для parser классов возвращается хеш:
                ключ -- номер параметра (0, 1, ...), значение - имя параметра
       !^reflection:dynamical[[object or class, caller if absent]]    возвращает true, если метод был вызван из динамического контекста
                                                                      при передаче параметра возвращает true, если передан динамический объект,
                                                                      false если класс
       !^reflection:delete[класс или объект;имя переменной]           удаляет переменную с указанным именем в указанном классе или объекте
       !^reflection:is[имя элемента;имя класса][[контекст]]           аналог оператора is, позволяющий определить, является ли элемент кодом.
   
   
 !mail  !mail
     !$mail.received=MESSAGE:      !$mail.received=MESSAGE:
         .from          .from
Line 540  odbc c:\drives\y\parser3project\odbc\deb Line 575  odbc c:\drives\y\parser3project\odbc\deb
         $.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 662  odbc c:\drives\y\parser3project\odbc\deb Line 697  odbc c:\drives\y\parser3project\odbc\deb
     !^картинка.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 685  odbc c:\drives\y\parser3project\odbc\deb Line 725  odbc c:\drives\y\parser3project\odbc\deb
     !^картинка.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 dir
       !^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)] = table с колонками name dir size [mca]date
     !^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|binary;имя;data]
       !^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]]
       !^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.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[[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 717  odbc c:\drives\y\parser3project\odbc\deb Line 762  odbc c:\drives\y\parser3project\odbc\deb
         выполняется код          выполняется код
         разблокируется          разблокируется
     Xchmod[...] НЕТ И НЕ БУДЕТ, ЧТОБЫ НЕ МОГЛИ СДЕЛАТЬ executable и запустить, даже если ftp запрещает chmod.      Xchmod[...] НЕТ И НЕ БУДЕТ, ЧТОБЫ НЕ МОГЛИ СДЕЛАТЬ executable и запустить, даже если ftp запрещает chmod.
     !^file:dirname[/a/some.tar.gz]=/a      !^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix)
     !^file:dirname[/a/b/]=/a      !^file:dirname[/a/b/]=/a (работает аналогично комманде *nix)
     !^file:basename[/a/some.tar.gz]=some.tar.gz      !^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix)
       !^file:basename[/a/b/]=b (работает аналогично комманде *nix)
     !^file:justname[/a/some.tar.gz]=some.tar      !^file:justname[/a/some.tar.gz]=some.tar
     !^file:justext[/a/some.tar.gz]=gz      !^file:justext[/a/some.tar.gz]=gz
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif      !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif
     !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать      !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать
     X^file::sql[[имя_файла_для_download]]{}      !^file::sql{query}[[
     !^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 776  odbc c:\drives\y\parser3project\odbc\deb Line 825  odbc c:\drives\y\parser3project\odbc\deb
     !^math:crc32[string]      !^math:crc32[string]
        вычисляет crc32 строки         вычисляет crc32 строки
     !^math:sha1[string]      !^math:sha1[string]
     !^math:long2ip(long)      !^math:convert[number](base-from;base-to) преобразует строку с числом из одной системы исчисления в другую
       !^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64] $.hmac[ключ] ]]
          объединяет в себе возможность работы с разными алгоритмами криптографического хеширования.
          $.hmac[ключ] для проверки целостности переданных данных
   
   
   !inet
       !^inet:ntoa(long)
       !^inet:aton[IP]
       !^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прямое преобразование имени в IP адрес
       !^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреса в имя
   
   
   !json
       !^json:parse[-json-строка-[;
           $.depth(максимальная глубина, default == 19)
           $.double(false)              отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен)
                                        в этом случае они попадут в результирующий объект как строки
           $.int(false)                 отключить встроенный парсинг целых чисел (по умолчанию включен)
                                        в этом случае они попадут в результирующий объект как строки
           $.distinct[first|last|all]   как будет происходить разбор дублирующихся ключей у объектов
                                        first -- будет оставлен первый встретившийся элемент
                                        last  -- будет оставлен последний встретившийся элемент
                                        all   -- будут оставлены все элементы. при этом элементы, начиная со 2
                                                 получат числовые суффиксы (key_2 итд)
                                        по умолчанию дублирующиеся ключи приведут к exception
           $.object[method-junction]    пользовательский метод[ключ;объект], которому будут передаваться все разобранные 
                                        объекты и ключи объекта, метод возвращает новый объект
           $.array[method-junction]     пользовательский метод, которому будут передаваться массивы
       ]]
           парсит json-строку в хэш
       !^json:string[system or user object[;
           $.skip-unknown(false)    отключить exception и выдавать 'null' при сериализации объектов с типами
                                    отличных от void, bool, string, int, double, date, table, hash и file
           $.indent(true)           форматировать результирующую строку табуляциями по глубине вложенности
           $.date[sql-string|gmt-string|iso-string|unix-timestamp]    формат вывода даты, по умолчанию -- sql-string
           $.table[object|array|compact]    формат вывода таблицы, по умолчанию -- object
                                    object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...]
                                    array:  [["c1","c2",...] || null (for nameless),["v11","v12",...],...]
                                    compact:  ["v11" || ["v11","v12",...],...]
           $.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла 
                                    не попадает в output)
           $.xdoc[hash]             параметры преобразования xdoc в строку (как в ^xdoc.string[])
           $.тип[method-junction]   любой тип можно вывести с помощью пользовательского метода, который 
                                    должен принимать 3 параметра: ключ, объект данного типа и опции 
                                    вызова ^json:string[]
           $._default[имя метода]   имя пользователького метода, при его наличии он будет вызван для
                                    сериализации
           $.void[null|string]      неопределенное значение будет выдано в виде null (по умолчанию)
                                    или пустой строки
       ]]
           сериализует системный или пользовательский объект в json-строку
   
   
 !date  !date
     !время типа time можно использовать в выражениях, подставляет       !время типа time можно использовать в выражениях, подставляет 
         количество дней с epoch [1 января 1970 (UTC)], дробное          количество дней с epoch [1 января 1970 (UTC)], дробное
     !всё происходит в localtime,       !строковое значение в местном времени, численное в UTC
     !временная зона задаётся вне parser средствами OS      !по умолчанию используется установленная средствами OS временная зона
     $date:UTC-offset  сколько дней надо прибавить,чтобы попасть в local время  
     $date:TZ  наш часовой пояс, дробное, в часах (где-то есть с точностью до получаса)  
     !^date::now[]      !^date::now[]
     !^date::now(смещение в днях) выдаёт сейчас+смещение      !^date::now(смещение в днях) выдаёт сейчас+смещение
     !^date::create(дней с epoch) // старое имя set      !^date::today[] дата на 00:00:00 текущего дня
     !^date::create(year;month[;day[;hour[;minute[;second]]]]) // старое имя set      !^date::create(дней с epoch)
       !^date::create(year;month[;day[;hour[;minute[;second]]]])
     !^date::create[дата в формате %Y-%m-%d %H:%M:%S]      !^date::create[дата в формате %Y-%m-%d %H:%M:%S]
         для удобного создания по значению из базы          для удобного создания по значению из базы
         формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]          формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
         формат2: %H:%M[:%S]          формат2: %H:%M[:%S]
       !^date::create[дата в формате %Y-%m-%dT%H:%M[:%S]TZ]
           для создания по значению в формате ISO 8601
           формат TZ: Z(UTC) или +-hour[:minute] (смещение от UTC)
     !^date::unix-timestamp()      !^date::unix-timestamp()
     !^дата.unix-timestamp[]      !^дата.unix-timestamp[]
     !$дата.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ weekyear      !$дата.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ weekyear
Line 800  odbc c:\drives\y\parser3project\odbc\deb Line 903  odbc c:\drives\y\parser3project\odbc\deb
         TZ="" << локальная зона          TZ="" << локальная зона
     !^дата.roll[year|month|day](+-смещение) сдвигает дату      !^дата.roll[year|month|day](+-смещение) сдвигает дату
     !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co      !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co
     !^дата.sql-string[] %Y-%m-%d %H:%M:%S      !^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе
       !^дата.sql-string[[datetime|date|time]]
           datetime или без параметра -- %Y-%m-%d %H:%M:%S
           date                       -- %Y-%m-%d
           time                       -- %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
Line 809  odbc c:\drives\y\parser3project\odbc\deb Line 916  odbc c:\drives\y\parser3project\odbc\deb
     !^date:last-day(год;месяц) вернёт последний день месяца      !^date:last-day(год;месяц) вернёт последний день месяца
     !^дата.last-day[] вернёт последний день месяца $дата      !^дата.last-day[] вернёт последний день месяца $дата
     !^дата.gmt-string[]  Fri, 23 Mar 2001 09:32:23 GMT      !^дата.gmt-string[]  Fri, 23 Mar 2001 09:32:23 GMT
       !^дата.iso-string[]  2001-03-23T12:32:23+3
   
   
 xdoc(xnode)  xdoc(xnode)
Line 1042  xdoc(xnode) Line 1150  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 1050  xdoc(xnode) Line 1158  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 1092  DATA::=string | file | hash Line 1200  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 1122  DATA::=string | file | hash Line 1230  DATA::=string | file | hash
         !по-умолчанию, получение http status != 200 >> создает http.status ошибку,          !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
         !это можно отключить, передав          !это можно отключить, передав
         !$.any-status(1)          !$.any-status(1)
         !$.charset[кодировка удалённых докуметов по-умолчанию] << если сервер вернёт content-type:charset=ОНА_ПЕРЕБИВАЕТ          !$.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА_ПЕРЕБИВАЕТ
           !$.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset
         !$.user[пользователь]          !$.user[пользователь]
         !$.password[пароль]          !$.password[пароль]
     !file::load в дополнительные поля записывает      !file::load в дополнительные поля записывает
Line 1139  DATA::=string | file | hash Line 1248  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 1157  DATA::=string | file | hash Line 1268  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  
   
 Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет  
     выдан список фрагментов результата с указанием их происхождения  
   
 !если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение  !если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение
         об этом будет записано в parser3.log (раньше оно всегда писалось)          об этом будет записано в parser3.log (раньше оно всегда писалось)

Removed from v.1.207  
changed lines
  Added in v.1.248


E-mail: