|
version 1.250, 2017/02/08 19:55:46
|
version 1.255, 2024/12/14 20:37:19
|
|
Line 113
|
Line 113
|
| по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS] |
по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS] |
| |
|
| ^connect[protocol://строка соединения]]{код с ^sql[...]-ями} |
^connect[protocol://строка соединения]]{код с ^sql[...]-ями} |
| mysql://user:pass@{host[:port]|[/unix/socket]}/database? |
mysql://user:pass@{host[:port][, 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=UTF-8& |
charset=UTF-8& |
| timeout=3& |
timeout=3& |
| compress=0& |
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 |
| |
config_file=.my.cnf& |
| |
config_group=parser3& use group name from .my.cnf |
| autocommit=1 |
autocommit=1 |
| autocommit если выставить в 0, будет делать commit/rollback |
autocommit если выставить в 0, будет делать commit/rollback |
| |
|
|
Line 218 odbc c:\drives\y\parser3project\odbc\deb
|
Line 220 odbc c:\drives\y\parser3project\odbc\deb
|
| всегда есть кодировка UTF-8, она является кодировкой по-умолчанию для request и response |
всегда есть кодировка UTF-8, она является кодировкой по-умолчанию для request и response |
| ВНИМАНИЕ: имя кодировки case insensitive |
ВНИМАНИЕ: имя кодировки case insensitive |
| |
|
| |
|
| синтаксис |
синтаксис |
| $имя[новое значение] |
$имя[новое значение] |
| $имя(математическое выражение нового значения) |
$имя(математическое выражение нового значения) |
|
Line 226 odbc c:\drives\y\parser3project\odbc\deb
|
Line 229 odbc c:\drives\y\parser3project\odbc\deb
|
| ^имя параметры вызов |
^имя параметры вызов |
| $имя.CLASS класс значения |
$имя.CLASS класс значения |
| $имя.CLASS_NAME имя класса |
$имя.CLASS_NAME имя класса |
| $имя[$.key[] () {}] конструктор элемента переменной-хэша $имя.key |
$имя[$.key[] () {}] конструктор элемента переменной-хеша $имя.key |
| ^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key |
^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key |
| $CLASS.имя обращение к переменной класса |
$CLASS.имя обращение к переменной класса |
| |
|
|
Line 241 odbc c:\drives\y\parser3project\odbc\deb
|
Line 244 odbc c:\drives\y\parser3project\odbc\deb
|
| $переменная |
$переменная |
| строка$переменная |
строка$переменная |
| [код, вычисляющий строку] |
[код, вычисляющий строку] |
| например: $хэш[$.возраст(88)] $достать[$.поле[возраст]] ^хэш.[$достать.поле].format{%05d} |
например: $хеш[$.возраст(88)] $достать[$.поле[возраст]] ^хеш.[$достать.поле].format{%05d} |
| |
|
| параметры := один или много параметров |
параметры := один или много параметров |
| параметр:= |
параметр := |
| (математическое выражение) вычисляется много раз внутри вызова, |
(математическое выражение) вычисляется много раз внутри вызова, |
| | [код] вычисляется один раз перед вызовом, |
| [код] вычисляется один раз перед вызовом, |
| | {код} вычисляется 0 или много раз внутри вызова, |
| {код} вычисляется 0 или много раз внутри вызова, |
|
Line 267 int,double
|
Line 270 int,double
|
| ^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] |
^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] |
| запрос, результат которого должен быть один столбец/одна строка |
запрос, результат которого должен быть один столбец/одна строка |
| |
|
| |
|
| string |
string |
| в выражении |
в выражении |
| def значение равно "не пуста?" |
def значение равно "не пуста?" |
|
Line 305 string
|
Line 309 string
|
| опции поиска+= |
опции поиска+= |
| g заменить все вхождения, а не одно |
g заменить все вхождения, а не одно |
| |
|
| ^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]] |
^строка.split[разделитель|regex][[lrhv]][[название столбца для вертикального разбиения]] |
| l слева направо [default] |
l слева направо [default] |
| r справа налево |
r справа налево |
| h nameless таблица с ключами 0, 1, 2, ... |
h nameless таблица с ключами 0, 1, 2, ... |
|
Line 343 string
|
Line 347 string
|
| |
|
| ^строка.trim[chars] выкидывает chars из начала и конца |
^строка.trim[chars] выкидывает chars из начала и конца |
| |
|
| ^строка.base64[] encode |
^строка.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode |
| ^string:base64[encoded[;$.strict(true)]] decode |
^string:base64[encoded[; $.pad(bool) $.strict(bool) url-safe(bool) ]] decode |
| |
|
| ^строка.idna[] |
^строка.idna[] |
| IDNA кодирование, поддержка кириллических доменов |
IDNA кодирование, поддержка кириллических доменов |
|
Line 358 string
|
Line 362 string
|
| |
|
| ^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri |
^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri |
| |
|
| !table |
|
| в выражении |
table |
| |
в выражении |
| логическое значение равно "не пуста?" |
логическое значение равно "не пуста?" |
| числовое значение равно count[] |
числовое значение равно count[] |
| !^table::create[[nameless]]{данные}[[$.separator[^#09]]] старое имя "set" |
^table::create[[nameless]]{данные}[[$.separator[^#09] $.encloser[]]] |
| !^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 - в обратном порядке |
| !^table::load[[nameless;]путь[;опции]] |
^table::load[[nameless;]путь[;опции]] |
| !если не nameless, названия колонок берутся из первой строки |
если не nameless, названия колонок берутся из первой строки |
| !пустые строки, и строки в первой колонке содержащие '#', игнорируются |
пустые строки, и строки в первой колонке содержащие '#', игнорируются |
| !$.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]]] |
| 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 |
^таблица.foreach[позиция;значение]{тело}[[разделитель]] |
| !^таблица.offset[[whence]](5) сдвигает |
^таблица.line[] 1-based offset |
| !whence=cur|set |
^таблица.offset[] печатает offset |
| !без whence - это cur |
^таблица.offset[[whence]](5) сдвигает |
| !^таблица.count[], ^таблица.count[rows] - количество строк в таблице |
whence=cur|set, без whence - это cur |
| !^таблица.count[columns] - количество столбцов таблицы |
^таблица.count[], ^таблица.count[rows] - количество строк в таблице |
| !^таблица.count[cells] - количество ячеек в текущей строке таблицы |
^таблица.count[columns] - количество столбцов таблицы |
| !^таблица.line[] 1-based offset |
^таблица.count[cells] - количество ячеек в текущей строке таблицы |
| !^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc |
^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc |
| !^таблица.append{данные} |
^таблица.append{данные} |
| !^таблица.append[ $.имя столбца[значение столбца] ] |
^таблица.append[ $.имя столбца[значение столбца] ] |
| !^таблица.insert{данные} добавить запись на текущую позицию |
^таблица.insert{данные} добавить запись на текущую позицию |
| !^таблица.insert[ $.имя столбца[значение столбца] ] |
^таблица.insert[ $.имя столбца[значение столбца] ] |
| !^таблица.delete[] - стирает запись с текущей позиции |
^таблица.delete[] - стирает запись с текущей позиции |
| !^таблица.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)]] |
| передвигает текущую строку, если найдёт. выдаёт bool |
передвигает текущую строку, если найдёт. выдаёт bool |
| !^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| передвигает текущую строку, если найдёт. выдаёт bool |
передвигает текущую строку, если найдёт. выдаёт bool |
| !^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1) $.distinct[tables]]] |
^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]{код значения}][[$.distinct(1) $.distinct[tables] $.type[hash]]] |
| значением $hash.ключ будет hash в котором поля значений будут ключами |
по умолчанию значением $hash.ключ будет hash в котором поля значений будут ключами |
| поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой |
поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой |
| если distinct содержит true, то не будет ошибки при повторяющихся ключах |
если distinct содержит true, то не будет ошибки при повторяющихся ключах |
| если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом |
если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом |
| !^таблица.columns[[название столбца]]+ таблица из одного столбца 'column' или как передадут |
$.type[string/table] поменять значение элемента на строку (указать одну колонку) или таблицу |
| !$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало |
^таблица.columns[[название столбца]] + таблица из одного столбца 'column' или как передадут |
| |
^таблица.rename[название столбца;новое навание столбца] - переименовывает столбец |
| |
^таблица.rename[ $.название столбца[новое навание столбца] ] - переименовывает столбцы |
| |
$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало |
| $adults[^man.select($man.age>=18)] |
$adults[^man.select($man.age>=18)] |
| ^таблица.color[цвет1;цвет2] |
^таблица.color[цвет1;цвет2] |
| |
|
| |
|
| !hash |
hash |
| !в выражении |
в выражении |
| !логическое значение равно "не пуста?" |
логическое значение равно "не пуст?", хеш с _default уже не пуст |
| !числовое значение равно _count[] |
числовое значение равно count[] |
| !$хеш.ключ |
$хеш.ключ |
| !_default - специальный ключ, если задан, |
_default - специальный ключ, если задан, |
| то при обращении по ключу, которому нет соответствия, выдаётся _default значение |
то при обращении по ключу, которому нет соответствия, выдаётся _default значение |
| !$хеш.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, копию старого |
| !^хеш.add[слагаемое] |
^хеш.add[слагаемое] |
| перезаписывает одноимённые |
перезаписывает одноимённые |
| !^хеш.sub[вычитаемое] |
^хеш.sub[вычитаемое] |
| !^хеш.union[b] = объединение |
^хеш.union[b] = объединение |
| одноимённые остаются |
одноимённые остаются |
| !^хеш.intersection[b] = пересечение |
^хеш.intersection[b] = пересечение |
| значения хеш |
значения хеш |
| !^хеш.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) $.type[hash|string|table]]] |
| получается hash(ключи=значения первая колонка ответа) |
получается hash(ключи=значения первая колонка ответа) of hash(ключи=названия остальных колонкок ответа) или |
| of hash(ключи=названия остальных колонкок ответа) |
string=значение каждого элемента - строка, при этом надо указать ровно два столбца или |
| !^хеш.keys[[название колонки с ключами]]+ таблица из одного столбца key или как передадут |
table=значение каждого элемента - таблица |
| !^хеш.count[] |
^хеш.keys[[название колонки с ключами]] + таблица из одного столбца key или как передадут |
| !^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
^хеш.count[] |
| !^хеш.delete[ключ] удалить ключ |
^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| !^хеш.contain[ключ] - существует ли в хеше ключ (bool) |
^хеш.delete[ключ] удалить ключ |
| !^хэш.at[first|last][[key|value|hash]] |
^хеш.contain[ключ] - существует ли в хеше ключ (bool) |
| !^хэш.at([-]N)[[key|value|hash]] |
^хеш.at[first|last][[key|value|hash]] |
| |
^хеш.at([-]N)[[key|value|hash]] |
| доступ к заданным элементам упорядоченного хеша |
доступ к заданным элементам упорядоченного хеша |
| !^хэш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc |
^хеш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc |
| |
$обратный_хеш[^хеш.reverse[]] |
| |
$отобранное[^хеш.select[key;value](выражение)[ $.limit(N) $.reverse(bool) $.default(bool) ]] = хеш из ключей и значений, для которых условие истинно |
| |
|
| !hashfile |
|
| !^hashfile::open[filename] |
hashfile |
| !^хешфайл.clear[] забыть всё |
^hashfile::open[filename] |
| !$хешфайл.ключ[значение] положить значение |
^хешфайл.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[] |
^хешфайл.release[] |
| записать данные и снять блокировки. |
записать данные и снять блокировки. |
| при повторном обращении к элементам откроется автоматически. |
при повторном обращении к элементам откроется автоматически. |
| !^хешфайл.cleanup[] пробежаться по всем элементам и удалить устаревшие. |
^хешфайл.cleanup[] пробежаться по всем элементам и удалить устаревшие. |
| |
|
| пример: |
пример: |
| $sessions[^hashfile::open[/db/sessions]] |
$sessions[^hashfile::open[/db/sessions]] |
| |
|
| $sid[^math:uuid[]] |
$sid[^math:uuid[]] |
| $sessions.$sid[$.value[$uid] $.expires(1)] |
$sessions.$sid[$.value[$uid] $.expires(1)] |
| $uid[$sessions.$sid] |
$uid[$sessions.$sid] |
| |
|
| |
|
| !form |
array |
| |
в выражении |
| |
логическое значение равно "не пуст?" |
| |
числовое значение равно count[] |
| |
$массив.индекс, $массив.(выражение) |
| |
возврат значения по заданному индексу |
| |
$массив.индекс[значение], $массив.(выражение)[значение] |
| |
присваивание значения по индексу |
| |
$массив[значение;значение;...] |
| |
создание массива с заданными значениями |
| |
^array::create[] |
| |
^array::create[значение;значение;...] |
| |
создание массива с заданными значениями или пустого массива |
| |
^array::copy[копируемый массив или хеш с цифровыми ключами] |
| |
копирование массива или хеша с цифровыми ключами |
| |
^массив.add[добавляемый массив или хеш с цифровыми ключами] |
| |
добавление элементов из другого массива или хеша с перезаписью значений у совпадающих индексов |
| |
^массив.join[добавляемый массив или произвольный хеш] |
| |
добавление элементов другого массива или хеша в конец массива |
| |
^массив.append[значение;значение;...] |
| |
добавление элементов в конец массива |
| |
^массив.insert(индекс)[значение;значение;...] |
| |
вставка элементов в указанную позицию массива |
| |
^массив.left(n) |
| |
возвращает новый массив из n первых элементов массива |
| |
^массив.right(n) |
| |
возвращает новый массив из n последних элементов массива |
| |
^массив.mid(m;n) |
| |
возвращает новый массив, содержащий n инициализированных элементов массива, начиная с позиции m |
| |
^массив.delete(index) |
| |
удаление элемента массива с оставлением пустого места |
| |
^массив.remove(index) |
| |
удаление элемента со сдвигом последующих элементов на его место |
| |
^массив.push[значение] |
| |
добавление элемента в конец массив |
| |
^массив.pop[] |
| |
возвращает последний элемент и удаляет его из массива |
| |
^массив.contain(индекс) |
| |
существует ли в массиве элемент по переданому индексу (bool) |
| |
^array::sql{запрос}[[ $.sparse(false) $.distinct(false) $.limit(2) $.offset(4) $.type[hash|string|table]]] |
| |
создание массива на основе выборки из базы данных |
| |
$.sparse(false), по умолчанию - создать обычный массив. Значения строк выборки последовательно добавляются в массив |
| |
$.sparse(true) - создать разреженный массив. Первая колонка данных должна содержать индексы, |
| |
по которым будут размещены значения (аналогично ^hash::sql{}) |
| |
получается array of hash (ключи=названия остальных колонкок ответа) или |
| |
string=значение каждого элемента - строка, при этом надо указать ровно два столбца или |
| |
table=значение каждого элемента - таблица |
| |
^массив.keys[[название колонки с ключами]] |
| |
таблица из одного столбца key или переданного названия с индексами инициализированных элементов массива |
| |
^массив.count[] |
| |
количество инициализированных элементов массива |
| |
^массив.count[all] |
| |
общее количество элементов массива, включая неинициализированные |
| |
^массив.foreach[index;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
перебирает все инициализированные элементы массива |
| |
^массив.for[index;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
перебирает все элементы массива |
| |
^массив.at[first|last][[key|value|hash]] |
| |
^массив.at([-]число)[[key|value|hash]] |
| |
доступ к элементу массива по порядковому номеру |
| |
^массив.set[first|last][значение] |
| |
^массив.set([-]число)[значение] |
| |
установка значения элемента массива по порядковому номеру |
| |
^массив.compact[] |
| |
удаление неинициализированных элементов массива |
| |
^массив.compact[undef] |
| |
удаление неинициализированных и пустых элементов массива |
| |
^массив.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc |
| |
сортировка массива |
| |
$обратный_массив[^массив.reverse[]] |
| |
возвращает новый массив из элементов исходного в обратном порядке |
| |
$отобранное[^массив.select[key;value](выражение)[ $.limit(N) $.reverse(bool) ]] |
| |
отбор элементов массива, для которых условие истинно |
| |
|
| |
form |
| [берётся первый элемент из одноимённых из GET, потом первый из POST] |
[берётся первый элемент из одноимённых из GET, потом первый из POST] |
| !$form:поле = string/file |
$form:поле = string/file |
| !$form:nameless = поле со значением поля без имени "?value&...", "...&value&...", "...&value" |
$form:nameless = поле со значением поля без имени "?value&...", "...&value&...", "...&value" |
| !$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: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:fields хеш с переменными окружения |
| !$env:fields хэш с переменными окружения |
$env:PARSER_VERSION версия парсера |
| !$env:PARSER_VERSION версия парсера |
|
| |
cookie |
| |
$cookie:имя считать старое или свежезаданное |
| !cookie |
$cookie:имя[значение] на 90 дней |
| !$cookie:имя считать старое или свежезаданное |
$cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true) $.domain[имя домена] $.httponly(true)] |
| !$cookie:имя[значение] на 90 дней |
значение поля expires может быть 'session', date, или число дней(0дней=session) |
| !$cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true)] |
если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| !значение поля expires может быть 'session', date, или число дней(0дней=session) |
$cookie:fields = hash со всеми cookies |
| ! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
|
| ! можно устанавливать bool свойства, например $.secure(true), $.httponly(true) |
request |
| !$cookie:fields = hash со всеми cookies |
$request:query |
| |
$request:uri |
| |
$request:document-root |
| !request |
|
| !$request:query |
|
| !$request:uri |
|
| !$request:document-root |
|
| каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT |
каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT |
| можно изменить, если на hosting что-то неудобно настроено |
$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла]. |
| !$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла]. |
$request:charset |
| !$request:charset |
|
| Кодировка исходного документа |
Кодировка исходного документа |
| !используется при upper/lower и match[][i] |
используется при upper/lower и match[][i] |
| ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN |
ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form |
| поэтому необходимо задать $request/response:charset в одном из них. не после. |
$request:method метод запроса (GET|POST|PUT) |
| !$request:method метод запроса (GET|POST|PUT) |
$request:body тело POST-запроса в виде текста |
| !$request:body тело POST-запроса в виде текста |
$request:body-file тело POST-запроса в виде файла |
| !$request:body-file тело POST-запроса в виде файла |
$request:body-charset кодировка POST-запроса |
| !$request:body-charset кодировка POST-запроса |
$request:headers хеш с заголовками запроса (без префикса HTTP_) |
| !$request:headers хэш с заголовками запроса (без префикса HTTP_) |
|
| |
|
| |
response |
| !response |
$response:поле[значение] и можно считать старое - $response:поле |
| !$response:поле[значение] и можно считать старое -- $response:поле |
значение может быть string а может быть hash: |
| !значение может быть string а может быть hash: |
$value[abc] field: {abc}<<часть |
| ! $value[abc] field: {abc}<<часть |
$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: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 |
| кодировка клиента т.е. та, |
кодировка клиента т.е. та, |
| 1) из которой будут перекодированы $form:поля после забирания из browser'а |
1) из которой будут перекодированы $form:поля после забирания из browser'а |
| 2) в которую документ будет перекодирован перед отдаванием в browser |
2) в которую документ будет перекодирован перед отдаванием в browser |
| 3) в которую будет перекодирован текст языка uri |
3) в которую будет перекодирован текст языка uri |
| не добавляет к content-type ничего, если хочется, это надо сделать вручную |
не добавляет к content-type ничего, если хочется, это надо сделать вручную |
| ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN |
ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form |
| поэтому необходимо задать $request/response:charset в одном из них. не после. |
|
| |
|
| |
|
| !regex |
regex |
| !в выражении |
в выражении |
| !логическое значение всегда равно true |
логическое значение всегда равно true |
| !числовое значение равно количеству байт скомпилированного шаблона. |
числовое значение равно количеству байт скомпилированного шаблона. |
| !^regex::create[шаблон-строка][[опции поиска]] |
^regex::create[шаблон-строка|regex][[опции поиска]] |
| !^шаблон.size[] количество байт скомпилированного шаблона |
^шаблон.size[] количество байт скомпилированного шаблона |
| если значение очень большое -- стоит почитать документацию по pcre и, возможно, переписать шаблон. |
если значение очень большое - стоит почитать документацию по pcre и, возможно, переписать шаблон. |
| !^шаблон.study_size[] размер study-структуры. если==0 -- шаблон не может быть "изучен" |
^шаблон.study_size[] размер study-структуры. если==0 - шаблон не может быть "изучен" |
| |
$шаблон.pattern текст шаблона |
| |
$шаблон.options строка с исходным текстом опций |
| !reflection |
|
| !^reflection:create[класс;конструктор[;пара;[мет[;ры]]]] вызывает указанный конструктор класса (не более 100 параметров) |
|
| !^reflection:classes[] хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void |
reflection |
| !^reflection:class[объект] класс переданного объекта |
^reflection:create[класс;конструктор[;пара;[мет[;ры]]]] вызывает указанный конструктор класса (не более 100 параметров) |
| !^reflection:class_name[объект] имя класса переданного объекта |
^reflection:classes[] хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void |
| !^reflection:base[объект] родительский класс переданного объекта |
^reflection:class[объект] класс переданного объекта |
| !^reflection:base_name[объект] имя родительского класса переданного объекта |
^reflection:class_name[объект] имя класса переданного объекта |
| !^reflection:class_by_name[имя класса] получение класса по имени |
^reflection:base[объект] родительский класс переданного объекта |
| !^reflection:def[class;имя класса] проверка класса на существование |
^reflection:base_name[объект] имя родительского класса переданного объекта |
| !^reflection:methods[класс] хеш со списком методов указанного класса, значения -- строки 'native' или 'parser' |
^reflection:class_by_name[имя класса] получение класса по имени |
| !^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта |
^reflection:def[class;имя класса] проверка класса на существование |
| !^reflection:fields[класс или объект] хеш со списком статических полей указанного класса или динамических полей указанного объекта |
^reflection:methods[класс] хеш со списком методов указанного класса, значения -- строки 'native' или 'parser' |
| !^reflection:field[класс или объект;имя поля] возвращает значение указанного поля класса или объекта. getter-ы игнорируются. |
^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта |
| !^reflection:uid[класс или объект] возвращает идентификатор объекта или класса |
^reflection:fields[класс или объект] хеш со списком статических полей указанного класса или динамических полей указанного объекта |
| !^reflection:method_info[класс;метод] хеш с параметрами указанного метода класса |
^reflection:field[класс или объект;имя поля] возвращает значение указанного поля класса или объекта. getter-ы игнорируются. |
| $.inherited[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
^reflection:uid[класс или объект] возвращает идентификатор объекта или класса |
| $.overridden[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
^reflection:method_info[класс;метод] хеш с параметрами указанного метода класса |
| для native классов возвращается хеш: |
$.inherited[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
| .min_params(минимально необходимое число параметров) |
$.overridden[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
| .max_params(максимально возможное число параметров) |
для native классов возвращается хеш: |
| .call_type[dynamic|static|any] |
.min_params(минимально необходимое число параметров) |
| для parser классов возвращается хеш: |
.max_params(максимально возможное число параметров) |
| ключ -- номер параметра (0, 1, ...), значение - имя параметра |
.call_type[dynamic|static|any] |
| !^reflection:dynamical[[object or class, caller if absent]] возвращает true, если метод был вызван из динамического контекста |
для parser классов возвращается хеш: |
| при передаче параметра возвращает true, если передан динамический объект, |
ключ -- номер параметра (0, 1, ...), значение - имя параметра |
| false если класс |
^reflection:dynamical[[object or class, caller if absent]] |
| !^reflection:delete[класс или объект;имя переменной] удаляет переменную с указанным именем в указанном классе или объекте |
возвращает true, если метод был вызван из динамического контекста при передаче |
| !^reflection:is[имя элемента;имя класса][[контекст]] аналог оператора is, позволяющий определить, является ли элемент кодом. |
параметра возвращает true, если передан динамический объект, false если класс |
| |
^reflection:delete[класс или объект;имя переменной] удаляет переменную с указанным именем в указанном классе или объекте |
| |
^reflection:is[имя элемента;имя класса][[контекст]] аналог оператора is, позволяющий определить, является ли элемент кодом. |
| |
|
| |
|
| !mail |
mail |
| !$mail.received=MESSAGE: |
$mail.received=MESSAGE: |
| .from |
.from |
| .reply-to |
.reply-to |
| .subject |
.subject |
|
Line 608 string
|
Line 689 string
|
| ] |
] |
| $.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] |
| $.text[ |
$.text[ |
| $.any-header-field |
$.any-header-field |
| $.value[string] |
$.value[string] |
| ] |
] |
| $.html{string} |
$.html{string} |
| $.html[ |
$.html[ |
| $.any-header-field |
$.any-header-field |
| $.value{string} |
$.value{string} |
| ] |
] |
| $.file#[FILE] |
$.file#[FILE] |
| $.file#[ |
$.file#[ |
| $.any-header-field |
$.any-header-field |
| $value[FILE] |
$value[FILE] |
| ] |
] |
| ] |
] |
| !если charset указан, письмо перекодируется в этот charset |
если charset указан, письмо перекодируется в этот charset |
| !content-type.charset не влияет на перекодирование |
content-type.charset не влияет на перекодирование |
| !после имени части может идти # число |
после имени части может идти # число |
| ^mail:send[ |
|
| # по-умолчанию, совпадает с source encoding. |
^mail:send[ |
| # задаёт кодировку body |
# по-умолчанию, совпадает с source encoding. |
| $.charset[windows-1251] |
# задаёт кодировку body |
| # нет умолчания |
$.charset[windows-1251] |
| $.content-type[$.value[text/plain] $.charset[windows-1251]] |
# нет умолчания |
| $.from["вася" <vasya@design.ru>] |
$.content-type[$.value[text/plain] $.charset[windows-1251]] |
| $.to["петя" <petya@design.ru>] |
$.from["вася" <vasya@design.ru>] |
| $.subject[пойдём пивка] |
$.to["петя" <petya@design.ru>] |
| $.body[ |
$.subject[пойдём пивка] |
| слова |
$.body[ |
| ] |
слова |
| ] |
] |
| !:send[$.header-field[] $.charset[кодировка письма] $.body[когда body не строка, |
] |
| а hash, отсылается multipart письмо]] |
|
| !если charset указан, письмо перекодируется в этот charset |
^mail:send[$.header-field[] $.charset[кодировка письма] $.body[когда body не строка, а hash, отсылается multipart письмо]] |
| !content-type.charset не влияет на перекодирование |
если charset указан, письмо перекодируется в этот charset |
| !после имени части может идти целое число, части пойдут в порядке чисел. |
content-type.charset не влияет на перекодирование |
| !если body указан строкой, то это текст письма, никаких вложений. |
после имени части может идти целое число, части пойдут в порядке чисел. |
| !если body указан hash, то это части, будут собраны текстовые блоки, затем вложения |
если body указан строкой, то это текст письма, никаких вложений. |
| !это старый формат, поддерживается для обратной совместимости |
если body указан hash, то это части, будут собраны текстовые блоки, затем вложения |
| !если имя части начинается со слова text, то это текстовый блок. |
это старый формат, поддерживается для обратной совместимости |
| !если имя части начинается со слова file, то это вложение, формат задания:: |
если имя части начинается со слова text, то это текстовый блок. |
| !$file[$.format[!uue|!base64] $.value[DATA] $.name[user-file-name]] |
если имя части начинается со слова file, то это вложение, формат задания:: |
| !важно: при multipart не указывать content-type |
$file[$.format[uue|base64] $.value[DATA] $.name[user-file-name]] |
| |
важно: при multipart не указывать content-type |
| |
|
| ^mail:send[ |
^mail:send[ |
| # по-умолчанию, совпадает с source encoding. |
# по-умолчанию, совпадает с source encoding. |
| # задаёт кодировку body |
# задаёт кодировку body |
| $.charset[windows-1251] |
$.charset[windows-1251] |
| # нет умолчания |
# нет умолчания |
| $.content-type[$.value[text/plain] $.charset[windows-1251]] |
$.content-type[$.value[text/plain] $.charset[windows-1251]] |
| $.from["вася" <vasya@design.ru>] |
$.from["вася" <vasya@design.ru>] |
|
Line 672 string
|
Line 755 string
|
| слова |
слова |
| ] |
] |
| ] |
] |
| |
|
| ^mail:send[ |
^mail:send[ |
| $.from["вася" <vasya@design.ru>] |
$.from["вася" <vasya@design.ru>] |
| $.to["петя" <petya@design.ru>] |
$.to["петя" <petya@design.ru>] |
|
Line 684 string
|
Line 768 string
|
| $.content-type[$.value[text/plain] $.charset[windows-1251]] |
$.content-type[$.value[text/plain] $.charset[windows-1251]] |
| $.body[слова] |
$.body[слова] |
| ] |
] |
| #для удобства скриптования можно указать только одну часть, при этом не будет multipart |
# для удобства можно указать только одну часть, при этом не будет multipart |
| $.file[ |
$.file[ |
| $.value[^file::load[my beloved.doc]] |
$.value[^file::load[my beloved.doc]] |
| $.name[мой любимый.doc] |
$.name[мой любимый.doc] |
|
Line 696 string
|
Line 780 string
|
| ] |
] |
| ] |
] |
| ] |
] |
| !для отправки |
для отправки под unix используется программа с параметрами, задаваемая |
| под unix используется программа с параметрами, задаваемая |
|
| $MAIL.sendmail[команда] |
$MAIL.sendmail[команда] |
| если не будет задана, проверяется, доступна ли |
если не будет задана, проверяется, доступна ли /usr/sbin/sendmail или |
| /usr/sbin/sendmail или |
/usr/lib/sendmail и, если доступна, то запускается с параметром "-t". |
| /usr/lib/sendmail |
|
| и, если доступна, то запускается с параметром "-t". |
под win32 используется SMTP протокол, сервер задаётся |
| под win32 используется SMTP протокол, сервер задаётся |
|
| $MAIL.SMTP[smtp.domain.ru] |
$MAIL.SMTP[smtp.domain.ru] |
| |
|
| !image |
|
| !$картинка[^image::measure[DATA]] |
image |
| смотрит на .ext case insensitive, |
$картинка[^image::measure[DATA[; $.exif(bool) $.xmp(bool) $.xmp-charset[] $.video(bool) ]]] |
| умеет мерить пока только .gif и .jpg .jpeg |
смотрит на .ext case insensitive, |
| !$картинка.exif << hash после measure jpeg с exif информацией |
умеет мерить .gif, .jpg, tiff, bmp, webp и mp4 (mov) |
| !$image.exif.DateTime & co |
$картинка.exif << hash после measure jpeg с exif информацией и $.exif(true) |
| |
$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, |
| !даты типа date |
даты типа date |
| !перечисления в виде hash с ключами 0..count-1 |
перечисления в виде hash с ключами 0..count-1 |
| !$картинка.src .width .height |
$картинка.src .width .height |
| !$картинка.line-width число=ширина линий |
$картинка.line-width число=ширина линий |
| !$картинка.line-style строка=стиль линий '*** * '='*** * *** * *** * ' |
$картинка.line-style строка=стиль линий '*** * '='*** * *** * *** * ' |
| !^картинка.html[[hash]] = <img ...> |
^картинка.html[[hash]] = <img ...> |
| !^image::load[фон.gif] |
^image::load[фон.gif] |
| только gif пока |
только gif пока |
| !^image::create(размер X;размер Y[;цвет фона default белый]]) |
^image::create(размер X;размер Y[;цвет фона default белый]]) |
| !^картинка.line(x0;y0;x1;y1;0xffFFff) |
^картинка.line(x0;y0;x1;y1;0xffFFff) |
| !^картинка.fill(x;y;0xffFFff) |
^картинка.fill(x;y;0xffFFff) |
| !^картинка.rectangle(x0;y0;x1;y1;0xffFFff) |
^картинка.rectangle(x0;y0;x1;y1;0xffFFff) |
| !^картинка.bar(x0;y0;x1;y1;0xffFFff) |
^картинка.bar(x0;y0;x1;y1;0xffFFff) |
| !^картинка.replace(hex-цвет1;hex-цвет2)[table x:y вершины_многоугольника] |
^картинка.replace(hex-цвет1;hex-цвет2)[table x:y вершины_многоугольника] |
| !^картинка.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; |
^картинка.font[набор_букв;имя_файла_шрифта.gif; |
| $.space(ширина_пробела) // по умолчанию = ширине gif |
$.space(ширина_пробела) // по умолчанию = ширине gif |
| $.width(ширина_символа) // см. выше, по умолчанию proportional |
$.width(ширина_символа) // см. выше, по умолчанию proportional |
| $.spacing(расстояние между буквами) // по умолчанию = 1 |
$.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 |
| имя файла будет использовано при $response:download |
имя файла будет использовано при $response:download |
| !^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color) |
^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color) |
| !^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color) |
^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color) |
| !^картинка.circle(center x;center y;r;color) |
^картинка.circle(center x;center y;r;color) |
| !^картинка.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]]) |
^картинка.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]]) |
| при заданных dest_w/dest_h делает изменение размера кусочка |
при заданных dest_w/dest_h делает изменение размера кусочка |
| при уменьшении делает resample |
при уменьшении делает resample |
| годится только для уменьшения простой[малоцветной] дребедени вроде графиков/pie, |
годится только для уменьшения простой[малоцветной] дребедени вроде графиков/pie, |
|
Line 756 string
|
Line 839 string
|
| определяющее прожорливость выделялки цветов из палитры [default=150] |
определяющее прожорливость выделялки цветов из палитры [default=150] |
| меньше - точнее приближает цвета, но они быстро кончаются |
меньше - точнее приближает цвета, но они быстро кончаются |
| больше - неточно приближает цвет, но бОльшей части хватит |
больше - неточно приближает цвет, но бОльшей части хватит |
| !^картинка.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;имя файла[;$.charset[в какой кодировке сохраняем]]] |
^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем]]] |
| !^file:delete[имя файла] |
^file:delete[имя файла] |
| !^file:find[имя файла][{когда не нашли}] |
^file:find[имя файла][{когда не нашли}] |
| !^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонками name dir |
^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонками name dir |
| !^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)] = table с колонками name dir size [mca]date |
^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|binary;имя;data] |
^file::create[text|binary;имя;data] |
| !^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]] |
^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]] |
| !^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.charset[...]]] |
^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.charset[...]]] |
| !$файл_который_был_loaded.size |
$файл_который_был_loaded.size |
| !$файл_который_был_loaded_или_created.mode = text/binary |
$файл_который_был_loaded_или_created.mode = text/binary |
| !^file::stat[имя файла] |
^file::stat[имя файла] |
| !$файл_который_был_stated_или_loaded.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 unix max 50 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[старое имя файла;новое имя файла] |
| можно переименовывать и двигать каталоги[win32: но не через границу дисков] |
можно переименовывать и двигать каталоги[win32: но не через границу дисков] |
| каталоги для dest создаются с правами 775 |
каталоги для dest создаются с правами 775 |
| каталог старого файла стирается, если после move он остаётся пуст |
каталог старого файла стирается, если после move он остаётся пуст |
| !^file:copy[имя файла;имя копии файла] |
^file:copy[имя файла;имя копии файла[; $.append(1) ]] |
| можно копировать только файлы |
можно копировать только файлы |
| !^file:lock[имя файла]{код} |
^file:lock[имя файла]{код} |
| файл при необходимости создаётся |
файл при необходимости создаётся |
| блокируется |
блокируется |
| выполняется код |
выполняется код |
| разблокируется |
разблокируется |
| Xchmod[...] НЕТ И НЕ БУДЕТ, ЧТОБЫ НЕ МОГЛИ СДЕЛАТЬ executable и запустить, даже если ftp запрещает chmod. |
^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix) |
| !^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix) |
^file:dirname[/a/b/]=/a (работает аналогично комманде *nix) |
| !^file:dirname[/a/b/]=/a (работает аналогично комманде *nix) |
^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix) |
| !^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix) |
^file:basename[/a/b/]=b (работает аналогично комманде *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 строку, которую можно в запрос отдать |
^file::sql{query}[[ |
| !^file::sql{query}[[ |
|
| $.name[имя_файла_для_download] |
$.name[имя_файла_для_download] |
| $.content-type[пользовательский content-type] |
$.content-type[пользовательский content-type] |
| ]] |
]] |
|
Line 813 string
|
Line 895 string
|
| первая колонка - данные |
первая колонка - данные |
| если есть вторая - это имя файла |
если есть вторая - это имя файла |
| если есть третья - это content-type |
если есть третья - это content-type |
| !^файл.base64[] encode |
^файл.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode |
| !^file:base64[имя файла] |
^file:base64[имя файла[; $.pad(bool) $.wrap(bool) $.url-safe(bool) ]] |
| encode |
encode |
| !^file::base64[encoded string] |
^file::base64[encoded string[; $.pad(bool) $.strict(bool) url-safe(bool) ]] |
| !^file::base64[mode;имя файла;encoded string[;$.content-type[...]]] |
^file::base64[mode;имя файла;encoded string[; $.content-type[...] $.pad(bool) $.strict(bool) url-safe(bool) ]] |
| decode |
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 |
| !^math:trunc frac |
^math:trunc frac |
| !^math:abs sign |
^math:abs sign |
| !^math:exp log |
^math:exp log |
| !^math:sin asin cos acos tan atan |
^math:sin asin cos acos tan atan |
| !^math:degrees radians |
^math:degrees radians |
| !^math:pow sqrt |
^math:pow sqrt |
| !^math:random(ширина диапазона) |
^math:random(ширина диапазона) |
| !^math:uuid[] |
^math:convert[number](base-from;base-to) |
| |
преобразует строку с числом из одной системы исчисления в другую |
| |
^math:uuid[ $.lower(bool) $.solid(bool) ] |
| 22C0983C-E26E-4169-BD07-77ECE9405BA5 |
22C0983C-E26E-4169-BD07-77ECE9405BA5 |
| win32: пользуется cryptapi |
win32: пользуется cryptapi |
| unix: пользуется /dev/urandom, |
unix: пользуется /dev/urandom, |
| если нет, /dev/random, |
если нет, /dev/random, |
| если нет, rand |
если нет, rand |
| [на solaris /dev/random можно добавить] |
[на solaris /dev/random можно добавить] |
| !^math:uid64[] |
^math:uid64[ $.lower(bool) ] |
| BA39BAB6340BE370 |
BA39BAB6340BE370 |
| !^math:md5[string] |
^math:md5[string] |
| выдает digest строки, длиной 16 байт в виде строки, |
выдает digest строки, длиной 16 байт в виде строки, |
| где байты digest выданы в hex виде, впритык, в нижнем регистре |
где байты digest выданы в hex виде, впритык, в нижнем регистре |
| !^math:crypt[password;salt] |
^math:crypt[password;salt] |
| salt prefix $apr1$ вызывает встроенный MD5 алгоритм, |
salt prefix $apr1$ вызывает встроенный MD5 алгоритм, |
| если нет тела salt, оно создаётся случайным |
если нет тела salt, оно создаётся случайным |
| $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris]. |
$1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается [заведомо нет на solaris]. |
| другие salt читайте документацию по функции OS 'crypt'. |
другие salt читайте документацию по функции OS 'crypt'. |
| !^math:crc32[string] |
^math:crc32[string] |
| вычисляет crc32 строки |
вычисляет crc32 строки |
| !^math:sha1[string] |
^math:sha1[string] |
| !^math:convert[number](base-from;base-to) преобразует строку с числом из одной системы исчисления в другую |
^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64] $.hmac[ключ] ]] |
| !^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64] $.hmac[ключ] ]] |
объединяет в себе возможность работы с разными алгоритмами криптографического хеширования. |
| объединяет в себе возможность работы с разными алгоритмами криптографического хеширования. |
$.hmac[ключ] для проверки целостности переданных данных |
| $.hmac[ключ] для проверки целостности переданных данных |
|
| |
|
| |
inet |
| !inet |
^inet:ntoa(long) |
| !^inet:ntoa(long) |
^inet:aton[IP] |
| !^inet:aton[IP] |
^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прямое преобразование имени в IP адрес |
| !^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прямое преобразование имени в IP адрес |
^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреса в имя |
| !^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреса в имя |
|
| |
|
| |
|
| !json |
json |
| !^json:parse[-json-строка-[; |
^json:parse[-json-строка-[; |
| $.depth(максимальная глубина, default == 19) |
$.depth(максимальная глубина, default == 19) |
| $.double(false) отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен) |
$.double(false) отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен) |
| в этом случае они попадут в результирующий объект как строки |
в этом случае они попадут в результирующий объект как строки |
|
Line 888 string
|
Line 971 string
|
| $.object[method-junction] пользовательский метод[ключ;объект], которому будут передаваться все разобранные |
$.object[method-junction] пользовательский метод[ключ;объект], которому будут передаваться все разобранные |
| объекты и ключи объекта, метод возвращает новый объект |
объекты и ключи объекта, метод возвращает новый объект |
| $.array[method-junction] пользовательский метод, которому будут передаваться массивы |
$.array[method-junction] пользовательский метод, которому будут передаваться массивы |
| |
$.taint[язык преобразования] задаёт язык преобразования для всех строк результата |
| ]] |
]] |
| парсит json-строку в хэш |
парсит json-строку в хеш |
| !^json:string[system or user object[; |
|
| |
^json:string[system or user object[; |
| $.skip-unknown(false) отключить exception и выдавать 'null' при сериализации объектов с типами |
$.skip-unknown(false) отключить exception и выдавать 'null' при сериализации объектов с типами |
| отличных от void, bool, string, int, double, date, table, hash и file |
отличных от void, bool, string, int, double, date, table, hash и file |
| $.indent(true) форматировать результирующую строку табуляциями по глубине вложенности |
$.indent(true) форматировать результирующую строку табуляциями по глубине вложенности |
|
Line 905 string
|
Line 990 string
|
| $.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который |
$.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который |
| должен принимать 3 параметра: ключ, объект данного типа и опции |
должен принимать 3 параметра: ключ, объект данного типа и опции |
| вызова ^json:string[] |
вызова ^json:string[] |
| |
$._default[метод] пользовательский метод, будет вызываться для вывода всех объектов пользовательских |
| |
классов. Метод должен принимать 3 параметра: ключ, объект и опции вызова. |
| $._default[имя метода] имя пользователького метода, при его наличии он будет вызван для |
$._default[имя метода] имя пользователького метода, при его наличии он будет вызван для |
| сериализации |
сериализации |
| $.void[null|string] неопределенное значение будет выдано в виде null (по умолчанию) |
$.void[null|string] неопределенное значение будет выдано в виде null (по умолчанию) |
|
Line 913 string
|
Line 1000 string
|
| сериализует системный или пользовательский объект в json-строку |
сериализует системный или пользовательский объект в json-строку |
| |
|
| |
|
| !date |
date |
| !время типа time можно использовать в выражениях, подставляет |
время типа time можно использовать в выражениях, подставляет количество дней с epoch [1 января 1970 (UTC)], дробное. |
| количество дней с epoch [1 января 1970 (UTC)], дробное |
Строковое значение в местном времени, численное в UTC, диапазон от 0000-00-00 00:00:00 до 9999-12-31 23:59:59. |
| !строковое значение в местном времени, численное в UTC |
по умолчанию используется установленная средствами OS временная зона |
| !по умолчанию используется установленная средствами OS временная зона |
^date::now[] |
| !^date::now[] |
^date::now(смещение в днях) выдаёт сейчас+смещение |
| !^date::now(смещение в днях) выдаёт сейчас+смещение |
^date::today[] дата на 00:00:00 текущего дня |
| !^date::today[] дата на 00:00:00 текущего дня |
^date::today(целочисленное смещение в днях) дата на 00:00:00 текущего дня+смещение |
| !^date::create(дней с epoch) |
^date::create(дней с epoch) |
| !^date::create(year;month[;day[;hour[;minute[;second]]]]) |
^date::create(year;month[;day[;hour[;minute[;second[;TZ]]]]]) |
| !^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] |
^date::create[дата в формате %Y-%m-%dT%H:%M[:%S]TZ] |
| для создания по значению в формате ISO 8601 |
для создания по значению в формате ISO 8601 |
| формат TZ: Z(UTC) или +-hour[:minute] (смещение от UTC) |
формат 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 |
| read-only |
|
| TZ="" << локальная зона |
TZ="" << локальная зона |
| !^дата.roll[year|month|day](+-смещение) сдвигает дату |
$дата.year month day hour minute second можно задать новое значение, остальные read only |
| !^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co |
^дата.roll[year|month|day](+-смещение) сдвигает дату |
| !^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе |
^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co |
| !^дата.sql-string[[datetime|date|time]] |
^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе |
| |
^дата.sql-string[[datetime|date|time]] |
| datetime или без параметра -- %Y-%m-%d %H:%M:%S |
datetime или без параметра -- %Y-%m-%d %H:%M:%S |
| date -- %Y-%m-%d |
date -- %Y-%m-%d |
| time -- %H:%M:%S |
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 |
| !^date:calendar[rus|eng](год;месяц;день) выдаёт именнованную таблицу |
^date:calendar[rus|eng](год;месяц;день) выдаёт именнованную таблицу |
| столбцы: year, month, day, weekday |
столбцы: year, month, day, weekday |
| !^date:last-day(год;месяц) вернёт последний день месяца |
^date:last-day(год;месяц) вернёт последний день месяца |
| !^дата.last-day[] вернёт последний день месяца $дата |
^дата.last-day[] вернёт последний день месяца $дата |
| !^дата.gmt-string[] Fri, 23 Mar 2001 09:32:23 GMT |
^дата.gmt-string[] Fri, 23 Mar 2001 09:32:23 GMT |
| !^дата.iso-string[] 2001-03-23T12:32:23+3 |
^дата.iso-string[] 2001-03-23T12:32:23+03 |
| |
|
| |
|
| xdoc(xnode) |
xdoc(xnode) |
| !$xdoc.search-namespaces hash, where keys=prefixes, values=urls |
$xdoc.search-namespaces hash, where keys=prefixes, values=urls |
| |
|
| DOM1 attributes: |
DOM1 attributes: |
| !readonly attribute DocumentType doctype |
readonly attribute DocumentType doctype |
| Xreadonly attribute DOMImplementation implementation |
readonly attribute Element documentElement |
| !readonly attribute Element documentElement |
|
| |
|
| DOM1 methods: |
DOM1 methods: |
| !Element createElement(in DOMString tagName) |
Element createElement(in DOMString tagName) |
| !DocumentFragment createDocumentFragment() |
DocumentFragment createDocumentFragment() |
| !Text createTextNode(in DOMString data) |
Text createTextNode(in DOMString data) |
| !Comment createComment(in DOMString data) |
Comment createComment(in DOMString data) |
| !CDATASection createCDATASection(in DOMString data) |
CDATASection createCDATASection(in DOMString data) |
| !ProcessingInstruction createProcessingInstruction(in DOMString target,in DOMString data) |
ProcessingInstruction createProcessingInstruction(in DOMString target,in DOMString data) |
| !Attr createAttribute(in DOMString name) |
Attr createAttribute(in DOMString name) |
| !EntityReference createEntityReference(in DOMString name) |
EntityReference createEntityReference(in DOMString name) |
| !NodeList getElementsByTagName(in DOMString tagname) |
NodeList getElementsByTagName(in DOMString tagname) |
| |
|
| DOM2 some methods: |
DOM2 some methods: |
| !^.getElementById[elementId] = xnode |
^.getElementById[elementId] = xnode |
| The DOM implementation must have information that says which attributes are of type ID. |
The DOM implementation must have information that says which attributes are of type ID. |
| Attributes with the name "ID" are not of type ID unless so defined. |
Attributes with the name "ID" are not of type ID unless so defined. |
| Implementations that do not know whether attributes are of type ID or not |
Implementations that do not know whether attributes are of type ID or not |
| are expected to return null. |
are expected to return null. |
| |
|
| !кодировка строк и умолчание для $.encoding |
кодировка строк и умолчание для $.encoding |
| !равно текущей кодировке выходной страницы, |
равно текущей кодировке выходной страницы, |
| $response:charset |
$response:charset |
| ::sql{...} |
::sql{...} |
| !::create[[URI]]{<?xml?><string/>} старое имя 'set' |
::create[[URI]]{<?xml?><string/>} старое имя 'set' |
| !::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: |
::create[file] can be usable: |
| $f[^file::load[binary;http://;some HTTP options here...]] |
$f[^file::load[binary;http://;some HTTP options here...]] |
| $x[^xdoc::create[$f]] |
$x[^xdoc::create[$f]] |
| !::load[file.xml[;опции]] |
::load[file.xml[;опции]] |
| !.transform[rules.xsl|xdoc][[params hash]] выдаёт dom |
.transform[rules.xsl|xdoc][[params hash]] выдаёт dom |
| шаблон кешируется, кеш обновляется при изменении даты файла шаблона, |
шаблон кешируется, кеш обновляется при изменении даты файла шаблона, |
| или изменении даты файла "имя шаблона.stamp"[проверка даты stamp приоритетнее] |
или изменении даты файла "имя шаблона.stamp"[проверка даты stamp приоритетнее] |
| <xsl:output |
<xsl:output |
| !method = "xml" | "html" | "text" |
method = "xml" | "html" | "text" |
| X| qname-but-not-ncname |
version = nmtoken |
| !version = nmtoken |
encoding = string |
| !encoding = string |
omit-xml-declaration = "yes" | "no" |
| !omit-xml-declaration = "yes" | "no" |
standalone = "yes" | "no" |
| !standalone = "yes" | "no" |
cdata-section-elements = qnames |
| X[передал, но xsltSaveResultTo не использовал его]doctype-public = string |
indent = "yes" | "no" |
| Xесли начинается с "-//W3C//DTD XHTML" то будет выводить XHTML |
media-type = string /> |
| X[передал, но xsltSaveResultTo не использовал его]doctype-system = string |
параметры передаются как есть, не xpath выражения |
| !cdata-section-elements = qnames |
|
| !indent = "yes" | "no" |
.string[[output options]] |
| !media-type = string /> |
.save[file.xml[;output options]] с шапкой |
| !параметры передаются как есть, не xpath выражения |
.file[[output options]] = file |
| |
output options идентичны атрибутам xsl:output |
| !.string[[output options]] |
|
| !.save[file.xml[;output options]] с шапкой |
|
| !.file[[output options]] = file |
|
| output options идентичны атрибутам xsl:output |
|
| [исключение: игнорируется cdata-section-elements, нужно будет, сделаю] |
[исключение: игнорируется cdata-section-elements, нужно будет, сделаю] |
| выдаёт media-type при подстановке $response:body[сюда] |
выдаёт media-type при подстановке $response:body[сюда] |
| |
|
| |
если на документ ссылаются так: |
| |
parser://method/param/to/that/method |
| |
то в качестве документа используется ^MAIN:method[/param/to/that/method] |
| |
[примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было] |
| |
|
| !если на документ ссылаются так: |
|
| parser://method/param/to/that/method |
|
| то в качестве документа используется ^MAIN:method[/param/to/that/method] |
|
| [примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было] |
|
| |
|
| !xnode |
xnode |
| DOM1 attributes: |
DOM1 attributes: |
| !$node.nodeName |
$node.nodeName |
| !$node.nodeValue |
$node.nodeValue |
| !read |
read |
| !write |
write |
| !$node.nodeType = int |
$node.nodeType = int |
| ELEMENT_NODE = 1 |
ELEMENT_NODE = 1 |
| ATTRIBUTE_NODE = 2 |
ATTRIBUTE_NODE = 2 |
| TEXT_NODE = 3 |
TEXT_NODE = 3 |
| CDATA_SECTION_NODE = 4 |
CDATA_SECTION_NODE = 4 |
| ENTITY_REFERENCE_NODE = 5 |
ENTITY_REFERENCE_NODE = 5 |
| ENTITY_NODE = 6 |
ENTITY_NODE = 6 |
| PROCESSING_INSTRUCTION_NODE = 7 |
PROCESSING_INSTRUCTION_NODE = 7 |
| COMMENT_NODE = 8 |
COMMENT_NODE = 8 |
| DOCUMENT_NODE = 9 |
DOCUMENT_NODE = 9 |
| DOCUMENT_TYPE_NODE = 10 |
DOCUMENT_TYPE_NODE = 10 |
| DOCUMENT_FRAGMENT_NODE = 11 |
DOCUMENT_FRAGMENT_NODE = 11 |
| NOTATION_NODE = 12 |
NOTATION_NODE = 12 |
| $vasyaNode.type==$xnode:ELEMENT_NODE |
$vasyaNode.type==$xnode:ELEMENT_NODE |
| !$node.parentNode |
$node.parentNode |
| !$node.childNodes = array of nodes |
$node.childNodes = array of nodes |
| !$node.firstChild |
$node.firstChild |
| !$node.lastChild |
$node.lastChild |
| !$node.previousSibling |
$node.previousSibling |
| !$node.nextSibling |
$node.nextSibling |
| !$node.ownerDocument = xdoc |
$node.ownerDocument = xdoc |
| !$node.prefix |
$node.prefix |
| !$node.namespaceURI |
$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 |
| true if the attribute received its value explicitly in the XML document, |
true if the attribute received its value explicitly in the XML document, |
| or if a value was assigned programatically with the setValue function. |
or if a value was assigned programatically with the setValue function. |
| false if the attribute value came from the default value declared in the document's DTD. |
false if the attribute value came from the default value declared in the document's DTD. |
| !$attribute_node.name |
$attribute_node.name |
| !$attribute_node.value |
$attribute_node.value |
| $text_node/cdata_node/comment_node.substringData |
$text_node/cdata_node/comment_node.substringData |
| !$pi_node.target = target of this processing instruction |
$pi_node.target = target of this processing instruction |
| XML defines this as being the first token following the markup |
XML defines this as being the first token following the markup |
| that begins the processing instruction. |
that begins the processing instruction. |
| !$pi_node.data = The content of this processing instruction |
$pi_node.data = The content of this processing instruction |
| This is from the first non white space character after the target |
This is from the first non white space character after the target |
| to the character immediately preceding the ?>. |
to the character immediately preceding the ?>. |
| document_node. |
document_node. |
| readonly attribute DocumentType doctype |
readonly attribute DocumentType doctype |
| readonly attribute DOMImplementation implementation |
readonly attribute DOMImplementation implementation |
| readonly attribute Element documentElement |
readonly attribute Element documentElement |
| document_type_node. |
document_type_node. |
| !readonly attribute DOMString name |
readonly attribute DOMString name |
| readonly attribute NamedNodeMap entities |
readonly attribute NamedNodeMap entities |
| readonly attribute NamedNodeMap notations |
readonly attribute NamedNodeMap notations |
| !notation_node. |
notation_node. |
| !readonly attribute DOMString publicId |
readonly attribute DOMString publicId |
| !readonly attribute DOMString systemId |
readonly attribute DOMString systemId |
| |
|
| !DOM1 node methods: |
DOM1 node methods: |
| !Node insertBefore(in Node newChild,in Node refChild) |
Node insertBefore(in Node newChild,in Node refChild) |
| !Node replaceChild(in Node newChild,in Node oldChild) |
Node replaceChild(in Node newChild,in Node oldChild) |
| !Node removeChild(in Node oldChild) |
Node removeChild(in Node oldChild) |
| !Node appendChild(in Node newChild) |
Node appendChild(in Node newChild) |
| !boolean hasChildNodes() |
boolean hasChildNodes() |
| !Node cloneNode(in boolean deep) |
Node cloneNode(in boolean deep) |
| |
|
| !DOM1 element methods: |
DOM1 element methods: |
| !DOMString getAttribute(in DOMString name) |
DOMString getAttribute(in DOMString name) |
| !void setAttribute(in DOMString name, in DOMString value) raises(DOMException) |
void setAttribute(in DOMString name, in DOMString value) raises(DOMException) |
| !void removeAttribute(in DOMString name) raises(DOMException) |
void removeAttribute(in DOMString name) raises(DOMException) |
| !Attr getAttributeNode(in DOMString name) |
Attr getAttributeNode(in DOMString name) |
| !Attr setAttributeNode(in Attr newAttr) raises(DOMException) |
Attr setAttributeNode(in Attr newAttr) raises(DOMException) |
| !Attr removeAttributeNode(in Attr oldAttr) raises(DOMException) |
Attr removeAttributeNode(in Attr oldAttr) raises(DOMException) |
| !NodeList getElementsByTagName(in DOMString name) |
NodeList getElementsByTagName(in DOMString name) |
| !void normalize() |
void normalize() |
| |
|
| |
|
| !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() |
boolean hasAttributes() |
| |
|
| !XPath: |
XPath: |
| !^node.select[xpath/query/expression] = array of nodes, |
^node.select[xpath/query/expression] = array of nodes, |
| empty array if nothing found |
empty array if nothing found |
| !^node.selectSingle[xpath/query/expression] = first node if any |
^node.selectSingle[xpath/query/expression] = first node if any |
| !^node.selectBool[xpath/query/expression] = bool if any or die |
^node.selectBool[xpath/query/expression] = bool if any or die |
| !^node.selectNumber[xpath/query/expression] = double if any or die |
^node.selectNumber[xpath/query/expression] = double if any or die |
| !^node.selectString[xpath/query/expression] = string if any or die |
^node.selectString[xpath/query/expression] = string if any or die |
| |
|
| !error codes(пока придут как текст в случае соответствующих ошибок): |
|
| INDEX_SIZE_ERR |
|
| If index or size is negative, or greater |
|
| than the allowed value |
|
| DOMSTRING_SIZE_ERR |
|
| If the specified range of text does not |
|
| fit into a DOMString |
|
| HIERARCHY_REQUEST_ERR |
|
| If any node is inserted somewhere it |
|
| doesn't belong |
|
| WRONG_DOCUMENT_ERR |
|
| If a node is used in a different |
|
| document than the one that created it |
|
| (that doesn't support it) |
|
| INVALID_CHARACTER_ERR |
|
| If an invalid character is specified, |
|
| such as in a name. |
|
| NO_DATA_ALLOWED_ERR |
|
| If data is specified for a node which |
|
| does not support data |
|
| NO_MODIFICATION_ALLOWED_ERR |
|
| If an attempt is made to modify an |
|
| object where modifications are not |
|
| allowed |
|
| NOT_FOUND_ERR |
|
| If an attempt was made to reference a |
|
| node in a context where it does not |
|
| exist |
|
| NOT_SUPPORTED_ERR |
|
| If the implementation does not support |
|
| the type of object requested |
|
| INUSE_ATTRIBUTE_ERR |
|
| If an attempt is made to add an |
|
| attribute that is already inuse |
|
| elsewhere |
|
| |
|
| !memory |
memory |
| !^memory:compact[] собрать мусор, освободив место под новые данные |
^memory:compact[] собрать мусор, освободив место под новые данные |
| (предупреждение: память процесса никогда не освобождается) |
(предупреждение: память процесса никогда не освобождается) |
| полезно делать перед XSL transform. |
полезно делать перед XSL transform. |
| |
|
| !status |
|
| !чтобы класс был доступен, в apache нужно сказать |
status |
| <Location /parser-status.html> |
$status:sql |
| ParserStatusAllowed |
cache table |
| </Location> |
url time |
| !в cgi доступен везде |
url time |
| !в isapi не доступен нигде |
url time |
| |
$status:stylesheet |
| !$status:sql hash |
cache table |
| !cache table |
|
| url time |
|
| url time |
|
| url time |
|
| !$status:stylesheet |
|
| !cache table |
|
| file time |
file time |
| file time |
file time |
| file time |
file time |
| |
|
| !$status:rusage hash |
$status:rusage hash |
| !utime user time used |
utime user time used |
| !stime system time used |
stime system time used |
| !maxrss max resident set size |
maxrss max resident set size |
| !ixrss integral shared text memory size |
ixrss integral shared text memory size |
| !idrss integral unshared data size |
idrss integral unshared data size |
| !isrss integral unshared stack size |
isrss integral unshared stack size |
| !tv_sec |
tv_sec |
| !tv_usec |
tv_usec |
| $s[$status:rusage] |
$s[$status:rusage] |
| ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f] |
^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f] |
| |
|
| !$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 |
ever_allocated_since_compact |
| |
Return the number of bytes allocated since the last collection. |
| !ever_allocated_since_compact |
ever_allocated_since_start |
| Return the number of bytes allocated since the last collection. |
|
| |
|
| !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 |
| |
|
| |
|
| console |
console |
| $console:timeout |
$console:timeout |
| !$console:line |
$console:line |
| read/write строку |
read/write строку |
| |
|
| |
|
| DATA::=string | file | hash |
DATA::=string | file | hash |
| |
|
| !hash вида |
hash вида |
| [ |
[ |
| $.file[имя файла на диске] |
$.file[имя файла на диске] |
| $.name[имя файла для пользователя] |
$.name[имя файла для пользователя] |
| $.mdate[date] |
$.mdate[date] |
| ] |
] |
| |
|
| |
|
| !MAIN |
MAIN |
| это класс, загружаемый на автомате из конфигурационного auto.p, |
это класс, загружаемый на автомате из конфигурационного auto.p, кучи auto.p и запрашиваемого документа: |
| кучи auto.p и запрашиваемого документа: |
конфигурационный auto.p |
| !конфигурационный auto.p |
cgi: |
| cgi: |
1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG или рядом с бинарником parser'а |
| 1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG |
|
| или рядом с бинарником parser'а |
|
| isapi: windows directory |
isapi: windows directory |
| apache module: |
apache module: |
| 1) ParserConfig [can be in .htaccess] |
1) ParserConfig [can be in .htaccess] |
| !auto.p вниз от DOCUMENT_ROOT/ по дереву до каталога с обрабатываемым файлом включительно |
auto.p вниз от DOCUMENT_ROOT/ по дереву до каталога с обрабатываемым файлом включительно |
| класс собирается из всех этих файлов, последующие становятся родителями предыдущих |
класс собирается из всех этих файлов, последующие становятся родителями предыдущих |
| имя последнего загруженного MAIN, имён у предыдущих нет |
имя последнего загруженного MAIN, имён у предыдущих нет |
| |
|
| !после загрузки MAIN класса вызывается его @main[] |
после загрузки MAIN класса вызывается его @main[] |
| !результат которого передаётся в его @postprocess[data] if($data is string) ... |
результат которого передаётся в его @postprocess[data] if($data is string) ... |
| !результат которого отдаётся пользователю |
результат которого отдаётся пользователю |
| |
|
| !если встречается ошибка и try не задан, её можно красиво сообщить пользователю, |
если встречается ошибка и try не задан, её можно красиво сообщить пользователю, определив |
| !определив |
@unhandled_exception[exception;stack] |
| !@unhandled_exception[exception;stack] |
$exception.type строка "тип проблемы" |
| !$exception.type строка "тип проблемы" |
$exception.file $exception.lineno $exception.colno файл, строка и позиция, где случилась проблема [если не запрещены при компиляции] |
| !$exception.file $exception.lineno $exception.colno файл, строка и позиция, где случилась проблема [если не запрещены при компиляции] |
$exception.source строка, из-за которой случилась проблема |
| !$exception.source строка, из-за которой случилась проблема |
$exception.comment комментарий english |
| !$exception.comment комментарий english |
stack табличка из колонок file line name, |
| !stack табличка из колонок file line name, |
там лежат в обратном порядке имена[name] и места вызовов[file line] |
| там лежат в обратном порядке имена[name] и места вызовов[file line] |
операторов/методов, приведших к ошибке. |
| операторов/методов, приведших к ошибке. |
|
| |
при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла: |
| !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла: |
http://domain/document[?params<<deprecated, use $.form[...]] |
| !http://domain/document[?params<<deprecated, use $.form[...]] |
а также, возможно, указать опции: |
| !а также, возможно, указать опции: |
$.method[GET|POST|HEAD] |
| !$.method[GET|POST|HEAD] |
$.timeout(3) << в секундах, по-умолчанию =2 |
| !$.timeout(3) << в секундах, по-умолчанию =2 |
$.cookies[ |
| !$.cookies[ |
$.имя[значение] |
| $.имя[значение] |
] |
| |
$.headers[ |
| |
$.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК |
| ] |
] |
| !$.headers[ |
|
| ! $.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК |
|
| !] |
|
| $.enctype[multipart/form-data] |
$.enctype[multipart/form-data] |
| $.form[ |
$.form[ |
| !$.field1[string] |
$.field1[string] |
| !$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}] |
$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}] |
| $.field3[file] |
$.field3[file] |
| ] |
] |
| !$.body[string] |
$.body[string|file] |
| |file |
по-умолчанию, user-agent=parser3 |
| !по-умолчанию, user-agent=parser3 |
по-умолчанию, получение http status != 200 >> создает http.status ошибку, это можно отключить, передав $.any-status(1) |
| !по-умолчанию, получение http status != 200 >> создает http.status ошибку, |
$.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА_ПЕРЕБИВАЕТ |
| !это можно отключить, передав |
$.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset |
| !$.any-status(1) |
$.user[пользователь] |
| !$.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА_ПЕРЕБИВАЕТ |
$.password[пароль] |
| !$.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset |
file::load в дополнительные поля записывает |
| !$.user[пользователь] |
ПОЛЕ:значение (имена полей ответа заглавными буквами) |
| !$.password[пароль] |
tables << хеш их ПОЛЕ->table с единственным столбцом "value". |
| !file::load в дополнительные поля записывает |
|
| !ПОЛЕ:значение (имена полей ответа заглавными буквами) |
|
| !tables << хеш их ПОЛЕ->table с единственным столбцом "value". |
|
| в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies |
в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies |
| todo:сделать отдельный cookies |
todo:сделать отдельный cookies |
| |
|
| !системные типы ошибок: |
системные типы ошибок: |
| !parser.compile ^test[} компиляция (непарная скобка, ...) |
parser.compile ^test[} компиляция (непарная скобка, ...) |
| !parser.runtime ^if(0). параметры (больше/меньше, чем нужно, не тех типов, ...) |
parser.runtime ^if(0). параметры (больше/меньше, чем нужно, не тех типов, ...) |
| !number.zerodivision ^eval(1/0) ^eval(1%0) |
number.zerodivision ^eval(1/0) ^eval(1%0) |
| !number.format ^eval(abc*5) |
number.format ^eval(abc*5) |
| !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.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 |
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 |
| sql.duplicate |
sql.duplicate |
| sql.access |
sql.access |
| sql.missing |
sql.missing |
| sql.xxx [serge asked] |
xml ^xdoc::create{<forgot?>} any error in xml/xslt libs |
| !xml ^xdoc::create{<forgot?>} any error in xml/xslt libs |
smtp.connect not found/timeout |
| !smtp.connect not found/timeout |
smtp.execute communication error |
| !smtp.execute communication error |
email.format hren tam@null.ru wrong email format(bad chars/empty) |
| !email.format hren tam@null.ru wrong email format(bad chars/empty) |
email.send $MAIL.sendmail[/shit] sendmail not executable |
| !email.send $MAIL.sendmail[/shit] sendmail not executable |
http.host ^file::load[http://notfound/there] host not found |
| !http.host ^file::load[http://notfound/there] host not found |
http.connect ^file::load[http://not_accepting/there] host found, but do not accept connections |
| !http.connect ^file::load[http://not_accepting/there] host found, but do not accept connections |
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(10000;1;1) date out of valid range |
| !date.range ^date::create(1950;1;1) date out of valid range |
|
| |
|
| если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение |
если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение |
| об этом будет записано в parser3.log (раньше оно всегда писалось) |
об этом будет записано в parser3.log |
| |
|
| если описание метода содержит локальную переменную result в явном виде |
если описание метода содержит локальную переменную result в явном виде (есть и неявная переменная) |
| (есть и неявная переменная) |
|
| то код вывода пробельных литералов не попадает в конечный байт-код. |
то код вывода пробельных литералов не попадает в конечный байт-код. |
| |
|