|
|
| version 1.171, 2004/04/06 07:50:33 | version 1.198, 2007/08/20 14:07:15 |
|---|---|
| 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{ |
| Line 76 Xне сделано, видимо, не будет сделано | Line 79 Xне сделано, видимо, не будет сделано |
| $exception.source = вася | $exception.source = вася |
| $exception.comment = болван | $exception.comment = болван |
| } | } |
| ^case[_default]{ | ^case[DEFAULT]{ |
| код, обрабатывающий другую ошибку | код, обрабатывающий другую ошибку |
| ^throw[$exception] << re-throw | ^throw[$exception] << re-throw |
| } | } |
| Line 86 Xне сделано, видимо, не будет сделано | Line 89 Xне сделано, видимо, не будет сделано |
| удобно сделать после выставления 401 ошибки | удобно сделать после выставления 401 ошибки |
| ^return[результат] + - отваливает из выполнения метода, | ^return[результат] + - отваливает из выполнения метода, |
| выдавая нестандартный результат | выдавая нестандартный результат |
| X^break[] + - обрывает цикл | !^break[] + - обрывает цикл |
| X^continue[] + - обрывает итерацию цикла | !^continue[] + - обрывает итерацию цикла |
| !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|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 129 Xне сделано, видимо, не будет сделано | Line 132 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 | |
| для работы 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 |
| 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 |
| }] | }] |
| ] | ] |
| Line 164 odbc c:\drives\y\parser3project\odbc\ | Line 170 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 198 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 219 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 251 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 |
| !^void:sql{запрос без результата} | !^имя.bool[] (default) |
| false или default | |
| !^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(на сколько *) |
| !^имя.div(на сколько /) | !^имя.div(на сколько /) |
| !^имя.mod(на сколько %) | !^имя.mod(на сколько %) |
| !^имя.format[формат] | !^имя.format[формат] |
| !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0}]] | !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] |
| запрос, результат которого должен быть один столбец/одна строка | запрос, результат которого должен быть один столбец/одна строка |
| !string | !string |
| Line 276 odbc c:\drives\y\parser3project\odbc\ | Line 288 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}]] | !^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 304 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 таблица из столбца piece [default] |
| !^строка.{l|r}split[разделитель] таблица из столбца $piece | !^строка.{l|r}split[разделитель] таблица из столбца $piece |
| оставлен для совместимости | оставлен для совместимости |
| Line 315 odbc c:\drives\y\parser3project\odbc\ | Line 329 odbc c:\drives\y\parser3project\odbc\ |
| !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены | !^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены |
| полезно делать перед сложными match операциями, если вы знаете, что входная строка | полезно делать перед сложными match операциями, если вы знаете, что входная строка |
| состоит из большого числа фрагментов | состоит из большого числа фрагментов |
| !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца | !^строка.trim[start|both|end[;chars]] выкидывает chars из начала/конца/и начала и конца |
| default 'chars' -- whitespace chars | default 'chars' -- whitespace chars |
| !^строка.append[string] | |
| !^строка.base64[] encode | |
| !^string:base64[encoded] decode | |
| !table | !table |
| в выражении | в выражении |
| Line 331 odbc c:\drives\y\parser3project\odbc\ | Line 348 odbc c:\drives\y\parser3project\odbc\ |
| !пустые строки, и строки в первой колонке содержащие '#', игнорируются | !пустые строки, и строки в первой колонке содержащие '#', игнорируются |
| !$.separator[^#09] | !$.separator[^#09] |
| !$.encloser["] по-умолчанию, нет. | !$.encloser["] по-умолчанию, нет. |
| !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]] | !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]] |
| bind привязывает переменные в запросе к их значениям | |
| пока реализован только для oracle | |
| в запросе надо написать ":имя" | |
| в параметре bind передать hash, из которого возьмётся(или куда запишется) значение | |
| !^таблица.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 348 odbc c:\drives\y\parser3project\odbc\ | Line 370 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 370 odbc c:\drives\y\parser3project\odbc\ | Line 392 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 421 odbc c:\drives\y\parser3project\odbc\ | Line 448 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) | |
| !request | !request |
| !$request:query | !$request:query |
| Line 458 odbc c:\drives\y\parser3project\odbc\ | Line 489 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 547 odbc c:\drives\y\parser3project\odbc\ | Line 579 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 576 odbc c:\drives\y\parser3project\odbc\ | Line 608 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 600 odbc c:\drives\y\parser3project\odbc\ | Line 633 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 653 odbc c:\drives\y\parser3project\odbc\ | Line 686 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 |
| Line 667 odbc c:\drives\y\parser3project\odbc\ | Line 701 odbc c:\drives\y\parser3project\odbc\ |
| можно переименовывать и двигать каталоги[win32: но не через границу дисков] | можно переименовывать и двигать каталоги[win32: но не через границу дисков] |
| каталоги для dest создаются с правами 775 | каталоги для dest создаются с правами 775 |
| каталог старого файла стирается, если после move он остаётся пуст | каталог старого файла стирается, если после move он остаётся пуст |
| !^file:copy[имя файла;имя копии файла] | |
| можно копировать только файлы | |
| !^file:lock[имя файла]{код} | !^file:lock[имя файла]{код} |
| файл при необходимости создаётся | файл при необходимости создаётся |
| блокируется | блокируется |
| Line 679 odbc c:\drives\y\parser3project\odbc\ | Line 715 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 строку, которую можно в запрос отдать |
| !^file::sql[[имя_файла_для_download]]{} | X^file::sql[[имя_файла_для_download]]{} |
| !^file::sql{}[[ | |
| $.name[имя_файла_для_download] | |
| $.content-type[пользовательский content-type] | |
| ]] | |
| результат запроса должен быть "одна строка". | результат запроса должен быть "одна строка". |
| колонки: | колонки: |
| первая колонка - данные | первая колонка - данные |
| если есть вторая - это имя файла | если есть вторая - это имя файла |
| если есть третья - это 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 715 odbc c:\drives\y\parser3project\odbc\ | Line 765 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] | |
| !^math:long2ip(long) | |
| !date | !date |
| !время типа time можно использовать в выражениях, подставляет | !время типа time можно использовать в выражениях, подставляет |
| Line 732 odbc c:\drives\y\parser3project\odbc\ | Line 786 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 |
| Line 777 xdoc(xnode) | Line 831 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 |
| для каталогов конечный / обязателен | для каталогов конечный / обязателен |
| !::load[file.xml[;опции]] | !::load[file.xml[;опции]] |
| Line 886 xdoc(xnode) | Line 941 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 989 console | Line 1045 console |
| !$console:line | !$console:line |
| read/write строку | read/write строку |
| !DATA::=string | file | DATA::=string | file | hash |
| !hash вида | |
| [ | |
| $.file[имя файла на диске] | |
| $.name[имя файла для пользователя] | |
| $.mdate[date] | |
| ] | |
| !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 1006 console | Line 1069 console |
| имя последнего загруженного MAIN, имён у предыдущих нет | имя последнего загруженного MAIN, имён у предыдущих нет |
| !после загрузки MAIN класса вызывается его @main[] | !после загрузки MAIN класса вызывается его @main[] |
| !результат которого передаётся в его @post-process[data] if($data is string) ... | !результат которого передаётся в его @postprocess[data] if($data is string) ... |
| !результат которого отдаётся пользователю | !результат которого отдаётся пользователю |
| !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, | !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, |
| Line 1080 console | Line 1143 console |
| Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет | Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет |
| выдан список фрагментов результата с указанием их происхождения | выдан список фрагментов результата с указанием их происхождения |
| !если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение | |
| об этом будет записано в parser3.log (раньше оно всегда писалось) | |
| !если описание метода содержит локальную переменную result в явном виде | |
| (есть и неявная переменная) | |
| то код вывода строковых литералов не попадает в конечный байт-код, | |
| а непробельные символы считаются синтаксической ошибкой | |
| для вывода чего бы то ни было надо пользоваться этой переменной | |