|
|
| version 1.177, 2004/12/23 15:36:12 | version 1.212, 2008/07/18 08:31:17 |
|---|---|
| Line 50 Xне сделано, видимо, не будет сделано | Line 50 Xне сделано, видимо, не будет сделано |
| %left '-' '+' | %left '-' '+' |
| %left '*' '/' '%' '\\' | %left '*' '/' '%' '\\' |
| %left NEG /* negation: unary - */ | %left NEG /* negation: unary - */ |
| !литералы | |
| true | |
| false | |
| !^if(условие){когда да}{когда нет} | !^if(условие){когда да}{когда нет} |
| !^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 ошибку |
| Line 76 Xне сделано, видимо, не будет сделано | Line 84 Xне сделано, видимо, не будет сделано |
| $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 86 Xне сделано, видимо, не будет сделано | Line 94 Xне сделано, видимо, не будет сделано |
| удобно сделать после выставления 401 ошибки | удобно сделать после выставления 401 ошибки |
| ^return[результат] + - отваливает из выполнения метода, | ^return[результат] + - отваливает из выполнения метода, |
| выдавая нестандартный результат | выдавая нестандартный результат |
| X^break[] + - обрывает цикл | !^break[] + - обрывает цикл |
| X^continue[] + - обрывает итерацию цикла | !^continue[] + - обрывает итерацию цикла |
| !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html]]{код} | !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html|regex]]{код} |
| default as-is | default as-is |
| !^taint[[lang]][код] | !^taint[[lang]][код] |
| default "just tainted, language unknown" | default "just tainted, language unknown" |
| Line 104 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 129 Xне сделано, видимо, не будет сделано | Line 138 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://DBfile? | |
| ClientCharset=parser-charset& << charset in which parser thinks client works | |
| autocommit=1 | |
| для работы connect нужно, чтобы заранее(рекомендуется в системном parser3) | для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p) |
| была определена таблица | была определена таблица |
| #sql drivers | #sql drivers |
| $SQL[ | $SQL[ |
| $.drivers[^table::set{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 |
| odbc c:\drives\y\parser3project\odbc\debug\parser3odbc.dll | sqlite /www/parser3/libparser3sqlite.so /usr/local/sqlite/lib/sqlite3.so |
| odbc c:\drives\y\parser3project\odbc\debug\parser3odbc.dll | |
| }] | }] |
| ] | ] |
| !в таблице у oracle в столбце клиентской библиотеки | !в таблице у oracle в столбце клиентской библиотеки |
| Line 164 odbc c:\drives\y\parser3project\odbc\ | Line 178 odbc c:\drives\y\parser3project\odbc\ |
| !скэшировать строку, которая получается при выполнении кода на 'секунд' секунд | !скэшировать строку, которая получается при выполнении кода на 'секунд' секунд |
| !если 0секунд, значит не кэшировать, а старый такой стереть | !если 0секунд, значит не кэшировать, а старый такой стереть |
| !в catch коде $exception.handled[cache] ^rem{флаг, что exception обработан} | !в catch коде $exception.handled[cache] ^rem{флаг, что exception обработан} |
| !^cache[файл][expires date]{код} | !^cache[файл][expires date]{код}[{catch код}] |
| !абсолютное задание времени | !абсолютное задание времени |
| X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0) | X^cache[файл] удалить файл [не ругает, если его нет] // такое было, больше не будет, делать ^cache(0) |
| !^cache(секунд) | !^cache(секунд) |
| !^cache[expires date] | !^cache[expires date] |
| !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" | !сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" |
| !в пределе: ^cache(0) отменить кэширование | !в пределе: ^cache(0) отменить кэширование |
| !^cache[] выдаёт текущую expires date | |
| X^cache[read] | X^cache[read] |
| сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", <br> | сигнализирует вышестоящему ^cache "взять скэшированное насильно, игнорируя expires", |
| выдаёт bool "получилось/нет" | выдаёт bool "получилось/нет" |
| !^sleep(seconds) | |
| Xесть глобальный флажок в свойствах/командной строке "не оптимизировать" | Xесть глобальный флажок в свойствах/командной строке "не оптимизировать" |
| Line 190 odbc c:\drives\y\parser3project\odbc\ | Line 206 odbc c:\drives\y\parser3project\odbc\ |
| !есть глобальная строка/таблица $MAIN:CLASS_PATH с путём/путями к каталогу с классами. | !есть глобальная строка/таблица $MAIN:CLASS_PATH с путём/путями к каталогу с классами. |
| !корень путя/путей считается от корня веб пространства. | !корень путя/путей считается от корня веб пространства. |
| !2. ...относительно строчки из table $MAIN:CLASS_PATH, снизу вверх | !2. ...относительно строчки из table $MAIN:CLASS_PATH, снизу вверх |
| задавайте её в parser3.conf вашего сайта | задавайте её в конфигурационном auto.p вашего сайта |
| !глобальная табличка $CHARSETS[$.название[имя файла]] | !глобальная табличка $CHARSETS[$.название[имя файла]] |
| !задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode | !задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode |
| Line 211 odbc c:\drives\y\parser3project\odbc\ | Line 227 odbc c:\drives\y\parser3project\odbc\ |
| !$имя whitespace или ${имя}неважно подстановка значения | !$имя whitespace или ${имя}неважно подстановка значения |
| !^имя параметры вызов | !^имя параметры вызов |
| !$имя.CLASS класс значения | !$имя.CLASS класс значения |
| !$имя.CLASS_NAME имя класса | |
| !$имя[$.key[] () {}] конструктор элемента переменной-хэша $имя.key | !$имя[$.key[] () {}] конструктор элемента переменной-хэша $имя.key |
| !^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key | !^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key |
| $CLASS.имя обращение к переменной класса | $CLASS.имя обращение к переменной класса |
| Line 242 odbc c:\drives\y\parser3project\odbc\ | Line 259 odbc c:\drives\y\parser3project\odbc\ |
| 0 | 0 |
| !^имя.pos[...] | !^имя.pos[...] |
| -1 | -1 |
| !^void.left(n) | !^имя.left(n) |
| ничего не выдаёт | ничего не выдаёт |
| !^void.right(n) | !^имя.right(n) |
| ничего не выдаёт | ничего не выдаёт |
| !^void.mid(p[;n]) | !^имя.mid(p[;n]) |
| ничего не выдаёт | ничего не выдаёт |
| !^имя.int[] (default) | !^имя.int[] (default) |
| 0 или default | 0 или default |
| !^имя.double[] (default) | !^имя.double[] (default) |
| 0 или default | 0 или default |
| !^имя.bool[] (default) | |
| false или default | |
| !^void:sql{запрос без результата}{$.bind[см. table::sql]} | !^void:sql{запрос без результата}{$.bind[см. table::sql]} |
| !int,double | !int,double |
| !^имя.int[] целочисленное значение | !^имя.int[] целочисленное значение |
| !^имя.double[]+ double значение | !^имя.double[]+ double значение |
| !^имя.bool[] + .bool(true|false) bool значение | |
| !^имя.inc(на сколько +) | !^имя.inc(на сколько +) |
| !^имя.dec(на сколько -) | !^имя.dec(на сколько -) |
| !^имя.mul(на сколько *) | !^имя.mul(на сколько *) |
| Line 278 odbc c:\drives\y\parser3project\odbc\ | Line 298 odbc c:\drives\y\parser3project\odbc\ |
| ^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 |
| !^имя.double[]+ .double(default) double значение строки | !^строка.double[]+ .double(default) double значение строки |
| !^строка.bool[] + .bool(default) bool значение строки | |
| если ломается преобразование, берётся default | если ломается преобразование, берётся default |
| !^имя.format[формат] %d %.2f %02d... | !^строка.format[формат] %d %.2f %02d... |
| !^строка.match[шаблон][[опции поиска]] $prematch $match $postmatch $1 $2... | !^строка.match[шаблон][[опции поиска]] $prematch $match $postmatch $1 $2... |
| опции поиска= | опции поиска= |
| i CASELESS | i CASELESS |
| Line 291 odbc c:\drives\y\parser3project\odbc\ | Line 312 odbc c:\drives\y\parser3project\odbc\ |
| m multiline = $ считается концом строки[\n], не концом всего текста | m multiline = $ считается концом строки[\n], не концом всего текста |
| g найти все вхождения, а не одно | g найти все вхождения, а не одно |
| ' создавать столбцы prematch, match, postmatch | ' создавать столбцы prematch, match, postmatch |
| n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами | |
| !^строка.match[шаблон][опции поиска]{замена} | !^строка.match[шаблон][опции поиска]{замена} |
| опции поиска+= | опции поиска+= |
| g заменить все вхождения, а не одно | g заменить все вхождения, а не одно |
| !^строка.split[разделитель][[lrhv]] | !^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]] |
| l слева направо [default] | l слева направо [default] |
| r справа налево | r справа налево |
| h nameless таблица | h nameless таблица с ключами 0, 1, 2, ... |
| v таблица из столбца piece [default] | v таблица из 1 столбца 'piece' или как передадут [default] |
| !^строка.{l|r}split[разделитель] таблица из столбца $piece | !^строка.{l|r}split[разделитель] таблица из столбца $piece |
| оставлен для совместимости | оставлен для совместимости |
| !^строка.upper|lower[] | !^строка.upper|lower[] |
| Line 309 odbc c:\drives\y\parser3project\odbc\ | Line 331 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 операциями, если вы знаете, что входная строка |
| состоит из большого числа фрагментов | состоит из большого числа фрагментов |
| !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца | !^строка.trim[start|both|end|left|right[;chars]] выкидывает chars из начала/конца/и начала и конца |
| default 'chars' -- whitespace chars | default 'chars' -- whitespace chars |
| !^string.append[string] | !^строка.append[string] |
| !^строка.base64[] encode | |
| !^string:base64[encoded] decode | |
| !table | !table |
| в выражении | в выражении |
| логическое значение равно "не пуста?" | логическое значение равно "не пуста?" |
| числовое значение равно count[] | числовое значение равно count[] |
| !^table::create[[nameless]]{данные} старое имя "set" | !^table::create[[nameless]]{данные}[[$.separator[^#09]]] старое имя "set" |
| !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] | !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| клонирует таблицу | клонирует таблицу |
| reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает) | reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает) |
| Line 340 odbc c:\drives\y\parser3project\odbc\ | Line 365 odbc c:\drives\y\parser3project\odbc\ |
| !^таблица.save[[nameless|append;]путь[;опции, см. load]] | !^таблица.save[[nameless|append;]путь[;опции, см. load]] |
| !$таблица.поле | !$таблица.поле |
| !$таблица.fields из named таблицы выдаёт текущую запись как Hash | !$таблица.fields из named таблицы выдаёт текущую запись как Hash |
| !^таблица.menu{тело}[разделитель] | !^таблица.menu{тело}[[разделитель]] |
| !^таблица.offset[[whence]](5) сдвигает; без параметра - печатает offset | !^таблица.offset[] печатает offset |
| !^таблица.offset[[whence]](5) сдвигает | |
| !whence=cur|set | !whence=cur|set |
| !без whence - это cur | !без whence - это cur |
| !^таблица.count[] | !^таблица.count[] |
| Line 353 odbc c:\drives\y\parser3project\odbc\ | Line 379 odbc c:\drives\y\parser3project\odbc\ |
| X^таблица.remove(position[;count]) - стирает запись | X^таблица.remove(position[;count]) - стирает запись |
| из текущей позиции [стирает запись из конкретной позиции] | из текущей позиции [стирает запись из конкретной позиции] |
| [стирает count записей] | [стирает 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 365 odbc c:\drives\y\parser3project\odbc\ | Line 391 odbc c:\drives\y\parser3project\odbc\ |
| поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой | поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой |
| если distinct содержит true, то не будет ошибки при повторяющихся ключах | если distinct содержит true, то не будет ошибки при повторяющихся ключах |
| если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом | если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом |
| !^таблица.columns[]+ таблица из одного столбца $column | !^таблица.columns[[название столбца]]+ таблица из одного столбца 'column' или как передадут |
| !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало | !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало |
| $adults[^man.select($man.age>=18)] | $adults[^man.select($man.age>=18)] |
| ^таблица.color[цвет1;цвет2] | ^таблица.color[цвет1;цвет2] |
| Line 375 odbc c:\drives\y\parser3project\odbc\ | Line 401 odbc c:\drives\y\parser3project\odbc\ |
| !в выражении | !в выражении |
| !логическое значение равно "не пуста?" | !логическое значение равно "не пуста?" |
| !числовое значение равно _count[] | !числовое значение равно _count[] |
| !$hash.ключ | !$хеш.ключ |
| !_default - специальный ключ, если задан, | !_default - специальный ключ, если задан, |
| то при обращении по ключу, которому нет соответствия, выдаётся _default значение | то при обращении по ключу, которому нет соответствия, выдаётся _default значение |
| !$hash.fields выдает $hash. чтобы класс hash был чуть больше похож на класс table | !$хеш.fields выдает $hash. чтобы класс hash был чуть больше похож на класс table |
| !^hash::create[[!copy_from_hash|copy_from_hashfile]] | !^hash::create[[!copy_from_hash|copy_from_hashfile]] |
| создаёт новый hash, копию старого | создаёт новый hash, копию старого |
| !^hash.add[слагаемое] | !^хеш.add[слагаемое] |
| перезаписывает одноимённые | перезаписывает одноимённые |
| !^hash.sub[вычитаемое] | !^хеш.sub[вычитаемое] |
| !^a.union[b] = объединение | !^хеш.union[b] = объединение |
| одноимённые остаются | одноимённые остаются |
| !^a.intersection[b] = пересечение | !^хеш.intersection[b] = пересечение |
| значения a | значения хеш |
| !^a.intersects[b] = bool | !^хеш.intersects[b] = bool |
| !^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(ключи=названия остальных колонкок ответа) |
| !^hash._keys[[название колонки с ключами]]+ таблица из одного столбца $key или как передадут | !^хеш._keys[[название колонки с ключами]]+ таблица из одного столбца $key или как передадут |
| !^hash._count[] | !^хеш._count[] |
| !^foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] | !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| !^delete[ключ] удалить ключ | !^хеш.delete[ключ] удалить ключ |
| !^хеш.contain[ключ] - существует ли в хеше ключ (bool) | |
| !hashfile | !hashfile |
| !^hashfile::open[filename] | !^hashfile::open[filename] |
| !^hashfile.clear[] забыть всё | !^хешфайл.clear[] забыть всё |
| !.ключ[значение] положить значение | !$хешфайл.ключ[значение] положить значение |
| !.ключ[$.value[значение] $.expires ЗНАЧЕНИЕ} | !$хешфайл.ключ[$.value[значение] $.expires[ЗНАЧЕНИЕ]} |
| положить значение до expires | положить значение до expires |
| значение поля expires может быть date, или число дней(0дней=на вечно) | значение поля expires может быть date, или число дней(0дней=на вечно) |
| !.ключ достать | !$хешфайл.ключ достать |
| !^delete[ключ] удалить ключ | !^хешфайл.delete[ключ] удалить ключ |
| !^delete[] удалить файлы, содержащие данные | !^хешфайл.delete[] удалить файлы, содержащие данные |
| !^hash[] | !^хешфайл.hash[] |
| преобразовать в обычный hash | преобразовать в обычный hash |
| попутно стирает устаревшие пары | попутно стирает устаревшие пары |
| !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] | !^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| !^хешфайл.release[] | |
| записать данные и снять блокировки. | |
| при повторном обращении к элементам откроется автоматически. | |
| !^хешфайл.cleanup[] пробежаться по всем элементам и удалить устаревшие. | |
| пример: | пример: |
| $sessions[^hashfile::open[/db/sessions]] | $sessions[^hashfile::open[/db/sessions]] |
| Line 426 odbc c:\drives\y\parser3project\odbc\ | Line 457 odbc c:\drives\y\parser3project\odbc\ |
| !$form:qtail = строка со значением текста после второго "?xxxxx", если там не было ',' [imap] | !$form:qtail = строка со значением текста после второго "?xxxxx", если там не было ',' [imap] |
| !$form:fields = hash со всеми полями формы | !$form:fields = hash со всеми полями формы |
| !$form:tables.поле = table с одним столбцом "field" со значениями "поля" | !$form:tables.поле = table с одним столбцом "field" со значениями "поля" |
| !$form:files.поле = hash со значениями полей типа файл, ключи - 0, 1, ..., значение - файл | |
| !$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 | |
| !cookie | !cookie |
| !$cookie:имя считать старое или свежезаданное | !$cookie:имя считать старое или свежезаданное |
| !$cookie:имя[значение] на 90 дней | !$cookie:имя[значение] на 90 дней |
| !$cookie:имя[$.value[значение] $.expires ЗНАЧЕНИЕ ] | !$cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true)] |
| !значение поля expires может быть 'session', date, или число дней(0дней=session) | !значение поля expires может быть 'session', date, или число дней(0дней=session) |
| ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" | ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| ! можно устанавливать bool свойства, например $.secure(true), $.httponly(true) | |
| !$cookie:fields = hash со всеми cookies | |
| !request | !request |
| !$request:query | !$request:query |
| Line 446 odbc c:\drives\y\parser3project\odbc\ | Line 482 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 463 odbc c:\drives\y\parser3project\odbc\ | Line 500 odbc c:\drives\y\parser3project\odbc\ |
| ! $attribute[zzz] field: abc; {attribute=zzz}<<часть | ! $attribute[zzz] field: abc; {attribute=zzz}<<часть |
| !значение поля или атрибута может быть string или date | !значение поля или атрибута может быть string или date |
| ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" | ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| !$response:headers накопленные поля | |
| !$response:body[DATA] замещает стандартный ответ | !$response:body[DATA] замещает стандартный ответ |
| !$response:download[DATA] замещает стандартный ответ, | !$response:download[DATA] замещает стандартный ответ, |
| выставляет флаг, заставляющий browser предложить download | выставляет флаг, заставляющий browser предложить download |
| Line 552 odbc c:\drives\y\parser3project\odbc\ | Line 590 odbc c:\drives\y\parser3project\odbc\ |
| !если body указан hash, то это части, будут собраны текстовые блоки, затем вложения | !если body указан hash, то это части, будут собраны текстовые блоки, затем вложения |
| !это старый формат, поддерживается для обратной совместимости | !это старый формат, поддерживается для обратной совместимости |
| !если имя части начинается со слова text, то это текстовый блок. | !если имя части начинается со слова text, то это текстовый блок. |
| !если имя части начинается со слова attach, то это вложение, формат задания:: | !если имя части начинается со слова file, то это вложение, формат задания:: |
| !$attach[$.format[!uue|Xbase64] $.value[DATA] $.file-name[user-file-name]] | !$file[$.format[!uue|!base64] $.value[DATA] $.name[user-file-name]] |
| !важно: при multipart не указывать content-type | !важно: при multipart не указывать content-type |
| ^mail:send[ | ^mail:send[ |
| # по-умолчанию, совпадает с source encoding. | # по-умолчанию, совпадает с source encoding. |
| Line 581 odbc c:\drives\y\parser3project\odbc\ | Line 619 odbc c:\drives\y\parser3project\odbc\ |
| $.body[слова] | $.body[слова] |
| ] | ] |
| #для удобства скриптования можно указать только одну часть, при этом не будет multipart | #для удобства скриптования можно указать только одну часть, при этом не будет multipart |
| $.attach[ | $.file[ |
| $.value[^file::load[my beloved.doc]] | $.value[^file::load[my beloved.doc]] |
| $.file-name[мой любимый.doc] | $.name[мой любимый.doc] |
| $.format[base64] | |
| ] | ] |
| $.attach2[ | $.file2[ |
| $.value[^file::load[my beloved.doc]] | $.value[^file::load[my beloved.doc]] |
| $.file-name[мой любимый.doc] | $.name[мой любимый.doc] |
| ] | ] |
| ] | ] |
| ] | ] |
| Line 605 odbc c:\drives\y\parser3project\odbc\ | Line 644 odbc c:\drives\y\parser3project\odbc\ |
| !$картинка[^image::measure[DATA]] | !$картинка[^image::measure[DATA]] |
| смотрит на .ext case insensitive, | смотрит на .ext case insensitive, |
| умеет мерить пока только .gif и .jpg .jpeg | умеет мерить пока только .gif и .jpg .jpeg |
| !$image.exif << hash после measure jpeg с exif информацией | !$картинка.exif << hash после measure jpeg с exif информацией |
| !$image.exif.DateTime & co | !$image.exif.DateTime & co |
| [полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] | [полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] |
| !числа типа int/double, | !числа типа int/double, |
| Line 658 odbc c:\drives\y\parser3project\odbc\ | Line 697 odbc c:\drives\y\parser3project\odbc\ |
| !^file:find[имя файла][{когда не нашли}] | !^file:find[имя файла][{когда не нашли}] |
| !^file:list[путь[;шаблон]] = table с колонкой name | !^file:list[путь[;шаблон]] = 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}] | |
| !$файл_который_был_loaded.size | !$файл_который_был_loaded.size |
| !^file::stat[имя файла] | !^file::stat[имя файла] |
| !$файл_который_был_stated.size !.adate !.mdate !.cdate | !$файл_который_был_stated.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 win32 max 10 args]]]]]]] |
| options: | options: |
| $.stdin[текст] если текст пуст, отключается автоматическое пересовывание данных HTTP-POST | $.stdin[текст] если текст пуст, отключается автоматическое пересовывание данных HTTP-POST |
| !^file:move[старое имя файла;новое имя файла] | !^file:move[старое имя файла;новое имя файла] |
| можно переименовывать и двигать каталоги[win32: но не через границу дисков] | можно переименовывать и двигать каталоги[win32: но не через границу дисков] |
| каталоги для dest создаются с правами 775 | каталоги для dest создаются с правами 775 |
| каталог старого файла стирается, если после move он остаётся пуст | каталог старого файла стирается, если после move он остаётся пуст |
| !^file:copy[имя файла;имя копии файла] | |
| можно копировать только файлы | |
| !^file:lock[имя файла]{код} | !^file:lock[имя файла]{код} |
| файл при необходимости создаётся | файл при необходимости создаётся |
| блокируется | блокируется |
| Line 684 odbc c:\drives\y\parser3project\odbc\ | Line 726 odbc c:\drives\y\parser3project\odbc\ |
| !^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 |
| !^file.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать | !^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать |
| X^file::sql[[имя_файла_для_download]]{} | X^file::sql[[имя_файла_для_download]]{} |
| !^file::sql{}[[ | !^file::sql{}[[ |
| $.name[имя_файла_для_download] | $.name[имя_файла_для_download] |
| Line 695 odbc c:\drives\y\parser3project\odbc\ | Line 737 odbc c:\drives\y\parser3project\odbc\ |
| первая колонка - данные | первая колонка - данные |
| если есть вторая - это имя файла | если есть вторая - это имя файла |
| если есть третья - это content-type | если есть третья - это content-type |
| !^файл.base64[] encode | |
| !^file:base64[имя файла] encode | |
| !^file::base64[encoded string] decode | |
| !^file:crc32[имя файла] | |
| вычисляет crc32 файла с указанным именем | |
| !^файл.crc32[] | |
| вычисляет crc32 объекта | |
| !^файл.md5[] | |
| !^file:md5[имя файла] | |
| выдает digest файла, длиной 16 байт в виде строки, | |
| где байты digest выданы в hex виде, впритык, в нижнем регистре | |
| !math | !math |
| !$math:PI | !$math:PI |
| Line 724 odbc c:\drives\y\parser3project\odbc\ | Line 776 odbc c:\drives\y\parser3project\odbc\ |
| если нет тела salt, оно создаётся случайным | если нет тела salt, оно создаётся случайным |
| $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris]. | $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris]. |
| другие salt читайте документацию по функции OS 'crypt'. | другие salt читайте документацию по функции OS 'crypt'. |
| !^math:crc32[string] | |
| вычисляет crc32 строки | |
| !^math:sha1[string] | |
| !inet | |
| !^inet:ntoa(long) | |
| !^inet:aton[IP] | |
| !date | !date |
| !время типа time можно использовать в выражениях, подставляет | !время типа time можно использовать в выражениях, подставляет |
| Line 741 odbc c:\drives\y\parser3project\odbc\ | Line 800 odbc c:\drives\y\parser3project\odbc\ |
| формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] | формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] |
| формат2: %H:%M[:%S] | формат2: %H:%M[:%S] |
| !^date::unix-timestamp() | !^date::unix-timestamp() |
| !^date.unix-timestamp[] | !^дата.unix-timestamp[] |
| !$date.year month day hour minute second weekday yearday(0...) daylightsaving TZ | !$дата.year month day hour minute second weekday yearday(0...) daylightsaving TZ weekyear |
| read-only | read-only |
| TZ="" << локальная зона | TZ="" << локальная зона |
| !^date.roll[year|month|day](+-смещение) сдвигает дату | !^дата.roll[year|month|day](+-смещение) сдвигает дату |
| !^date.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour&co | !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co |
| !^date.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 788 xdoc(xnode) | Line 851 xdoc(xnode) |
| !::create[[URI]][qualifiedName] | !::create[[URI]][qualifiedName] |
| 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 847 xdoc(xnode) | Line 913 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 895 xdoc(xnode) | Line 963 xdoc(xnode) |
| !Introduced in DOM Level 2: | !Introduced in DOM Level 2: |
| !Node importNode(in Node importedNode, in boolean deep) raises(DOMException) | !Node importNode(in Node importedNode, in boolean deep) raises(DOMException) |
| !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName); | !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName) |
| !boolean hasAttributes() | |
| !XPath: | !XPath: |
| !^node.select[xpath/query/expression] = array of nodes, | !^node.select[xpath/query/expression] = array of nodes, |
| Line 1008 DATA::=string | file | hash | Line 1077 DATA::=string | file | hash |
| ] | ] |
| !MAIN | !MAIN |
| это класс, загружаемый на автомате из parser3.conf, | это класс, загружаемый на автомате из конфигурационного auto.p, |
| кучи auto.p и запрашиваемого документа: | кучи auto.p и запрашиваемого документа: |
| !parser3.conf | !конфигурационный auto.p |
| cgi: | cgi: |
| 1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG | 1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG |
| или рядом с бинарником parser'а | или рядом с бинарником parser'а |
| Line 1022 DATA::=string | file | hash | Line 1091 DATA::=string | file | hash |
| имя последнего загруженного MAIN, имён у предыдущих нет | имя последнего загруженного MAIN, имён у предыдущих нет |
| !после загрузки MAIN класса вызывается его @main[] | !после загрузки MAIN класса вызывается его @main[] |
| !результат которого передаётся в его @post-process[data] if($data is string) ... | !результат которого передаётся в его @postprocess[data] if($data is string) ... |
| !результат которого отдаётся пользователю | !результат которого отдаётся пользователю |
| !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, | !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, |
| Line 1041 DATA::=string | file | hash | Line 1110 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 1097 DATA::=string | file | hash | Line 1169 DATA::=string | file | hash |
| Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет | Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет |
| выдан список фрагментов результата с указанием их происхождения | выдан список фрагментов результата с указанием их происхождения |
| !если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение | |
| об этом будет записано в parser3.log (раньше оно всегда писалось) | |
| !если описание метода содержит локальную переменную result в явном виде | !если описание метода содержит локальную переменную result в явном виде |
| (есть и неявная переменная) | (есть и неявная переменная) |
| то код вывода строковых литералов не попадает в конечный байт-код, | то код вывода строковых литералов не попадает в конечный байт-код, |