|
version 1.142, 2003/11/24 12:04:58
|
version 1.255, 2024/12/14 20:37:19
|
|
Line 1
|
Line 1
|
| ! |
операторы |
| X , , |
^eval(выражение)[формат] выражение, кроме обычных функций: |
| - |
допустимы #комментарии |
| |
работают до конца строки или закрывающейся круглой скобки |
| |
внутри комментария допустимы вложенные круглые скобки |
| |
из неочевидных операторов: |
| !^eval()[] , :: |
| побитный xor |
| ! # |
|| логический xor |
| |
~ побитное отрицание |
| |
\ целочисленное деление 10\3=3 |
| ! : |
def для проверки defined, |
| !| xor |
пустая строка не defined |
| !|| xor |
пустая таблица не defined |
| ~ |
пустой hash не defined |
| \ 10\3=3 |
eq ne lt gt le ge для сравнения строк, |
| !def defined, |
in "/dir/" для проверки, находится ли текущий документ в каталоге |
| defined |
["внутри не допустимы выражения, если надо сравнить со сложным, |
| defined |
пусть это будет переменная] |
| hash defined |
is 'type' для проверки типа левого операнда, |
| ^if(method $hash.delete){yes} |
можно проверить, "не hash ли параметр метода?" |
| !eq ne lt gt le ge , |
-f для проверки существования файла на диске, |
| !in "/dir/" |
-d для проверки существования каталога на диске, |
| [" , , |
строка в кавычках или апострофах - строка, без кавычек или апострофов строка до |
| ]. |
ближайшего whitespace |
| !is 'type' , |
числовой литерал бывает 0xABC |
| , , " hash ?" |
приоритеты: |
| !-f , |
/* logical */ |
| !-d , |
%left "!||" |
| ! | - , | |
%left "||" |
| whitespace |
%left "&&" |
| ! 0xABC |
%left '<' '>' "<=" ">=" "lt" "gt" "le" "ge" |
| !: |
%left "==" "!=" "eq" "ne" |
| /* logical */ |
%left "is" "def" "in" "-f" "-d" |
| %left "!||" |
%left '!' |
| %left "||" |
|
| %left "&&" |
|
| %left '<' '>' "<=" ">=" "lt" "gt" "le" "ge" |
|
| %left "==" "!=" "eq" "ne" |
|
| %left "is" "def" "in" "-f" "-d" |
|
| %left '!' |
|
| ? : |
|
| |
|
| /* bitwise */ |
/* bitwise */ |
| %left '!|' |
%left '!|' |
| %left '|' |
%left '|' |
| %left '&' |
%left '&' |
| %left '~' |
%left '~' |
| |
|
| /* numerical */ |
/* numerical */ |
| %left '-' '+' |
%left '-' '+' |
| %left '*' '/' '%' '\\' |
%left '*' '/' '%' '\\' |
| %left NEG /* negation: unary - */ |
%left '~' /* negation: unary */ |
| |
литералы |
| |
true |
| !^if(){ }{ } |
false |
| !^switch[]{^case[1[;2...]]{}^case[DEFAULT]{ }} |
|
| !^while(){} |
^if(условие){когда да}{когда нет} |
| !^for[i](0;4){}[[]|{ }] |
^if(условие1){да}[(условие2){да}[(условие2){да}[...]]]{нет} -- количество доп. условий не ограничено (в общем elseif это :) |
| !^use[] |
|
| !^try{ |
^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}} |
| |
|
| |
^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
|
| |
^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
|
| |
^try{ |
| ... |
... |
| !^throw[sql.connect;;] // ^error[] |
^throw[sql.connect[;вася[;болван]]] // был ^error[текст] |
| |
^throw[ |
| |
$.type[sql.connect] |
| |
$.source[вася] |
| |
$.comment[болван] |
| |
] |
| ... |
... |
| }{ |
}{ |
| ^if($exception.type eq sql){ |
^if($exception.type eq "sql"){ |
| $exception.handled(1) ^rem{, exception } |
$exception.handled(1|true) ^rem{флаг, что exception обработан} |
| .... |
.... |
| } |
} |
| |
^switch[$exception.type]{ |
| ^switch($exception.type){ |
|
| ^case[sql;mail]{ |
^case[sql;mail]{ |
| $exception.handled(1) |
$exception.handled(1) |
| , sql |
код, обрабатывающий sql ошибку |
| $exception.type = sql.connect |
$exception.type = sql.connect |
| $exception.file $exception.lineno [ ] |
$exception.file $exception.lineno $exception.colno [если не запрещены при компиляции] |
| $exception.source = |
$exception.source = вася |
| $exception.comment = |
$exception.comment = болван |
| } |
} |
| ^case[_default]{ |
^case[DEFAULT]{ |
| , |
код, обрабатывающий другую ошибку |
| ^throw[$exception] << re-throw |
^throw[$exception] << re-throw // DON'T! It's default behaviour! |
| } |
} |
| } |
} |
| } |
} |
| ^exit[] + - . |
|
| 401 |
^break[] - обрывает цикл |
| ^return[] + - , |
^break(true|false) - обрывает цикл, если true |
| |
|
| X^break[] + - |
^continue[] - обрывает итерацию цикла |
| X^continue[] + - |
^continue(true|false) - обрывает итерацию цикла, если true |
| !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-html]]{} |
|
| |
^return[] - обрывает выполнение метода |
| |
^return[value] - присваивает $result значение value и обрывает выполнение метода |
| |
|
| |
^untaint[[as-is|file-spec|uri|http-header|mail-header|sql|js|json|parser-code|regex|xml|html|optimized-[as-is|xml|html]]]{код} |
| default as-is |
default as-is |
| !^taint[[lang]][] |
|
| |
^taint[[lang]][код] |
| default "just tainted, language unknown" |
default "just tainted, language unknown" |
| !^process[[$caller.CLASS|$object|$:CLASS]]{, process-ed, }[ @main] |
|
| !^process..[][ @main] |
^apply-taint[[lang;]текст] |
| , $self [ , $self=$MAIN:CLASS] |
выполняет заданные в строке преобразования, неопределенно грязное как lang, на выходе чистая строка |
| !^connect[protocol:// ]]{ ^sql[...]-} |
|
| !mysql://user:pass@{host[:port]|[/unix/socket]}/database? |
^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[ |
| charset=cp1251_koi8& |
$.main[во что переименовать @main] |
| |
$.file[имя файла из которого, якобы, данный текст] |
| |
$.lineno(номер строки в файле, откуда данный текст. можно отрицательный) |
| |
] |
| |
^process..[путь][во что переименовать @main] |
| |
по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS] |
| |
|
| |
^connect[protocol://строка соединения]]{код с ^sql[...]-ями} |
| |
mysql://user:pass@{host[:port][, host[:port]]|[/unix/socket]}/database? |
| |
ClientCharset=parser-charset << charset in which parser thinks client works |
| |
charset=UTF-8& |
| timeout=3& |
timeout=3& |
| compress=1& |
compress=0& |
| named_pipe=1& |
named_pipe=1& |
| |
multi_statements=1& allow execute more then one query in one parser :sql{} request |
| |
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 |
| |
|
| !pgsql://user:pass@{host[:port]|[local]}/database? |
pgsql://user:pass@{host[:port]|[local]}/database? |
| client_encoding=win,[to-find-out]& |
client_encoding=win,[to-find-out] |
| datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO |
&datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO |
| |
&ClientCharset=parser-charset << charset in which parser thinks client works |
| !oracle://user:pass@service? |
|
| |
oracle://user:pass@service? |
| NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251& |
NLS_LANG=RUSSIAN_AMERICA.CL8MSWIN1251& |
| NLS_LANGUAGE language-dependent conventions |
NLS_LANGUAGE language-dependent conventions |
| NLS_TERRITORY territory-dependent conventions |
NLS_TERRITORY territory-dependent conventions |
|
Line 119 X , ,
|
Line 141 X , ,
|
| NLS_ISO_CURRENCY ISO currency symbol |
NLS_ISO_CURRENCY ISO currency symbol |
| NLS_SORT sort sequence |
NLS_SORT sort sequence |
| ORA_ENCRYPT_LOGIN=TRUE |
ORA_ENCRYPT_LOGIN=TRUE |
| |
ClientCharset=parser-charset << charset in which parser thinks client works |
| |
|
| |
odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset |
| |
ClientCharset << charset in which parser thinks client works |
| |
|
| !odbc://DSN=dsn^;UID=user^;PWD=password |
sqlite://DBfile? |
| |
ClientCharset=parser-charset& << charset in which parser thinks client works |
| |
autocommit=1 |
| |
|
| connect , ( parser3) |
для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p) |
| |
была определена таблица |
| #sql drivers |
#sql drivers |
| $SQL[ |
$SQL[ |
| $.drivers[^table::set{protocol driver client |
$.drivers[^table::create{protocol driver client |
| mysql /www/parser3/libparser3mysql.so /usr/local/lib/mysql/libmysqlclient.so |
mysql /www/parser3/libparser3mysql.so libmysqlclient.so |
| pgsql /www/parser3/libparser3pgsql.so /usr/local/pgsql/lib/libpq.so |
pgsql /www/parser3/libparser3pgsql.so libpq.so |
| oracle /www/parser3/libparser3oracle.so /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data |
oracle /www/parser3/libparser3oracle.so /u01/app/oracle/product/8.1.5/lib/libclntsh.so?ORACLE_HOME=/u01/app/oracle/product/8.1.5&ORA_NLS33=/u01/app/oracle/product/8.1.5/ocommon/nls/admin/data |
| odbc c:\drives\y\parser3project\odbc\debug\parser3odbc.dll |
sqlite /www/parser3/libparser3sqlite.so sqlite3.so |
| |
odbc c:\drives\y\parser3project\odbc\debug\parser3odbc.dll |
| }] |
}] |
| ] |
] |
| ! oracle |
в таблице у oracle в столбце клиентской библиотеки |
| environment ( ), |
допустимо задать environment параметры инициализации(если они не заданы иначе заранее), |
| , NLS_ ORA_ ORACLE_, + |
допустимы имена, начинающиеся на NLS_ ORA_ и ORACLE_, или оканчивающиеся на + |
| win32 |
под win32 |
| PATH+=^;C:\Oracle\Ora81\bin |
необходим PATH+=^;C:\Oracle\Ora81\bin |
| : |
к сведению: |
| ORA_NLS33 ( NLS_LANG) |
ORA_NLS33 нужен для считывания файлика с клиентской кодировкой(задаваемой NLS_LANG) |
| -, .drivers, |
если кодировка не по-умолчанию, обязательно указать в .drivers, |
| NLS |
иначе будет сообщение про неправильный NLS параметр |
| ( , NLS_LANG) |
(имеют в виду, что не нашли кодировку из NLS_LANG) |
| ORACLE_HOME , |
ORACLE_HOME нужен для считывания текстов сообщений об ошибках, |
| , , , |
можно указывать и в строке соединения, но глобален, и лучше вынести за скобки, |
| NLS_LANG, . |
в отличие от клиентской кодировки NLS_LANG, и прочего. |
| |
|
| : oracle&pgsql[ ], |
ВНИМАНИЕ: при работе с большими текстовыми блоками в oracle&pgsql[а лучше всегда], |
| , , |
ставить такой префикс перед открывающим апострофом, впритык, везде без проблелов |
| /**_**/'literal' |
/**имя_поля**/'literal' |
| !^rem{} |
|
| !^cache[](){}[{catch }] |
^rem{} |
| ! |
комментарий, удаляется при компиляции |
| ! , '' |
|
| ! 0, , |
^cache[файл](секунд){код}[{catch код}] |
| ! catch $exception.handled[cache] ^rem{, exception } |
относительное задание времени |
| !^cache[][expires date]{} |
скешировать строку, которая получается при выполнении кода на 'секунд' секунд |
| ! |
если 0 секунд, значит не кешировать, а старый такой стереть |
| X^cache[] [ , ] // , , ^cache(0) |
в catch коде $exception.handled[cache] ^rem{флаг, что exception обработан} |
| !^cache() |
^cache[файл][expires date]{код}[{catch код}] |
| !^cache[expires date] |
абсолютное задание времени |
| ! ^cache " - ''/'expires'" |
^cache[файл] удалить файл [не ругает, если его нет] |
| ! : ^cache(0) |
^cache(секунд) |
| X^cache[read] |
^cache[expires date] |
| ^cache " , expires", <br> |
сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" |
| bool "/" |
в пределе: ^cache(0) отменить кеширование |
| |
^cache[] выдаёт текущую expires date |
| |
|
| X / " " |
у всех методов есть локальная переменная $result, если в неё что положить, |
| ! : ^untaint[html]{} |
то это будет результатом метода, а не его тело |
| X |
|
| |
у всех методов есть локальная переменная $caller, в ней лежит родительский stack frame, |
| ! $result, , |
можно записать в его локальную переменную |
| ! __ , |
|
| ! $caller, stack frame, |
use(^use или @USE) ищет и подключает файл: |
| ! |
1. если путь начинается с /, то считается, что это путь от корня веб пространства |
| |
2. относительно текущей директории. |
| !use(^use @USE) ... |
3. относительно строк из table $MAIN:CLASS_PATH, снизу вверх. |
| !1. ... /, , |
$MAIN:CLASS_PATH - глобальная строка или таблица с путём или путями к каталогу |
| ! / $MAIN:CLASS_PATH / . |
с классами (от корня веб пространства), задавайте её в конфигурационном auto.p |
| ! / . |
|
| !2. ... table $MAIN:CLASS_PATH, |
глобальная табличка $CHARSETS[$.название[имя файла]] |
| parser3.conf |
задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode |
| |
формат: tab delimited файл, с заголовком: |
| ! $CHARSETS[$.[ ]] |
char white-space digit hex-digit letter word lowercase unicode1 unicode2 |
| ! (whitespace, letter, etc), unicode |
A x x x a 0x0041 0xFF21 |
| !: tab delimited , : |
где char и lowercase могут быть буквами, а могут быть и 0xКОДАМИ |
| ! char white-space digit hex-digit letter word lowercase unicode1 unicode2 |
если символ имеет единственное unicode представление, равное самому символу, можно не указывать unicode |
| ! A x x x a 0x0041 0xFF21 |
всегда есть кодировка UTF-8, она является кодировкой по-умолчанию для request и response |
| ! char lowercase , 0x |
ВНИМАНИЕ: имя кодировки case insensitive |
| ! unicode , , |
|
| ! unicode |
|
| ! UTF-8, |
синтаксис |
| ! - request response |
$имя[новое значение] |
| !: case sensitive |
$имя(математическое выражение нового значения) |
| |
$имя{код нового значения} |
| |
$имя whitespace или ${имя}неважно подстановка значения |
| !$[ ] |
^имя параметры вызов |
| !$( ) |
$имя.CLASS класс значения |
| !${ } |
$имя.CLASS_NAME имя класса |
| !$ whitespace ${} |
$имя[$.key[] () {}] конструктор элемента переменной-хеша $имя.key |
| !^ |
^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key |
| !$.CLASS |
$CLASS.имя обращение к переменной класса |
| !$[$.key[] () {}] - $.key |
|
| !^method[$.key[] () {}] - $parameter.key |
имя заканчивается перед: пробел tab linefeed ; ] } ) " < > + * / % & | = ! ' , ? {уточнить} |
| $CLASS. |
т.е. можно $имя,aaaa |
| |
но если нужно после имени букву, скажем -, то ${имя}- |
| : tab linefeed ; ] } ) " < > + * / % & | = ! ' , ? {} |
|
| .. |
в выражениях + и - являются дополнительными концами имени |
| $,aaaa |
|
| , -, |
можно обращаться к составным объектам так: $name.subname где subname бывает: |
| ${}- |
строка |
| + - |
$переменная |
| ! : $name.subname |
строка$переменная |
| ! subname : |
[код, вычисляющий строку] |
| ! |
например: $хеш[$.возраст(88)] $достать[$.поле[возраст]] ^хеш.[$достать.поле].format{%05d} |
| ! $ |
|
| ! $ |
параметры := один или много параметров |
| ! [, ] |
параметр := |
| : $[$.(88)] $[$.[]] ^.[$.].format{%05d} |
(математическое выражение) вычисляется много раз внутри вызова, |
| |
| [код] вычисляется один раз перед вызовом, |
| := |
| {код} вычисляется 0 или много раз внутри вызова, |
| := |
везде допустимы ; внутри - делает много параметров в одних скобках |
| !( ) , |
|
| | ![] , |
void |
| | !{} 0 , |
доступны все методы, присутствующие у объекта класса string, результат как у пустой строки |
| ! ; - |
^void:sql{запрос без результата}{$.bind[см. table::sql]} |
| |
|
| |
int,double |
| !void |
^имя.int[] целочисленное значение |
| !^.length[] |
^имя.double[] double значение |
| 0 |
^имя.bool[] .bool(true|false) bool значение |
| !^.pos[...] |
^имя.inc(на сколько +) |
| -1 |
^имя.dec(на сколько -) |
| !^.int[] (default) |
^имя.mul(на сколько *) |
| 0 default |
^имя.div(на сколько /) |
| !^.double[] (default) |
^имя.mod(на сколько %) |
| 0 default |
^имя.format[формат] |
| !^void:sql{ } |
^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] |
| |
запрос, результат которого должен быть один столбец/одна строка |
| !int,double |
|
| !^.int[] |
|
| !^.double[]+ double |
string |
| !^.inc( +) |
в выражении |
| !^.dec( -) |
def значение равно "не пуста?" |
| !^.mul( *) |
логическое/числовое значение равно попытке преобразовывания к double, |
| !^.div( /) |
пустая строка тихо преобразуется к 0 |
| !^.mod( %) |
пример: |
| !^.format[] |
^if(def $form:name) не пуста? |
| !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0}]] |
^if($user.isAlive) истина? [автопреобразование к числу, не ноль?] |
| , / |
|
| |
^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]] |
| !string |
результат запроса должен быть один столбец/одна строка |
| ! |
|
| !def " ?" |
^строка.int[] .int(default) целочисленное значение строки. |
| !/ double, |
если ломается преобразование, берётся default |
| 0 |
|
| |
^строка.double[] .double(default) double значение строки |
| : |
если ломается преобразование, берётся default |
| ^if(def $form:name) ? |
|
| ^if($user.isAlive) ? [ , ?] |
^строка.bool[] .bool(default) bool значение строки |
| !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a}]] |
если ломается преобразование, берётся default |
| / |
|
| !^.int[] .int(default) . |
^строка.format[формат] %d %.2f %02d... |
| , default |
|
| !^.double[]+ .double(default) double |
^строка.match[шаблон-строка|шаблон-regex][[опции поиска]] $prematch $match $postmatch $1 $2... |
| , default |
опции поиска= |
| !^.format[] %d %.2f %02d... |
|
| !^.match[][[ ]] $prematch $match $postmatch $1 $2... |
|
| = |
|
| i CASELESS |
i CASELESS |
| x whitespace in regex ignored |
x whitespace in regex ignored |
| s singleline = $ |
s singleline = $ считается концом всего текста |
| m multiline = $ [\n], |
m multiline = $ считается концом строки[\n], не концом всего текста |
| g , |
g найти все вхождения, а не одно |
| ' prematch, match, postmatch |
' создавать столбцы prematch, match, postmatch |
| !^.match[][ ]{} |
n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами |
| += |
U инвертировать смысл модификатора '?' |
| g , |
|
| !^.split[][[lrhv]] |
^строка.match[шаблон-строка|шаблон-regex][опции поиска]{замена} |
| l [default] |
опции поиска+= |
| r |
g заменить все вхождения, а не одно |
| h nameless |
|
| v piece [default] |
^строка.split[разделитель|regex][[lrhv]][[название столбца для вертикального разбиения]] |
| !^.{l|r}split[] $piece |
l слева направо [default] |
| |
r справа налево |
| !^.upper|lower[] |
h nameless таблица с ключами 0, 1, 2, ... |
| X^.truncate( ) :( |
v таблица из 1 столбца 'piece' или как передадут [default] |
| !^.length[] |
|
| !^.mid(P[;N]) |
^строка.{l|r}split[разделитель] таблица из столбца $piece |
| N - " " |
оставлен для совместимости |
| !^.left(N) |
|
| !^.right(N) |
^строка.upper|lower[] |
| !^.pos[] |
|
| <0 = |
^строка.length[] |
| !^.replace[$____] |
|
| !^.save[[append;]] |
^строка.mid(P[;N]) |
| !^.normalize[] , |
без N - "до конца строки" |
| match , , |
|
| |
^строка.left(N), -1 выдает всю строку |
| |
|
| !table |
^строка.right(N) |
| |
|
| " ?" |
^строка.pos[подстрока] |
| count[] |
|
| !^table::create[[nameless]]{} "set" |
^строка.pos[подстрока](позиция, с которой ищем) |
| !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
<0 = не найдено |
| |
|
| reverse << ( locate, table::create ) |
^строка.replace[$таблица_подстановок_строка_на_строку] |
| !^table::load[[nameless;][;]] |
|
| ! nameless, |
^строка.replace[$что;$на-что] |
| ! , '#', |
|
| !$.separator[^#09] |
^строка.save[[append;]путь] |
| !$.encloser["] -, . |
|
| !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]] |
^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]] |
| !^.save[[nameless|append;][;, . load]] |
|
| !$. |
^строка.trim[start|both|end|left|right[;chars]] выкидывает chars из начала/конца/и начала и конца |
| !$.fields named Hash |
default 'chars' -- whitespace chars |
| !^.menu{}[] |
|
| !^.offset[[whence]](5) ; - offset |
^строка.trim[chars] выкидывает chars из начала и конца |
| !whence=cur|set |
|
| ! whence - cur |
^строка.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode |
| !^.count[] |
^string:base64[encoded[; $.pad(bool) $.strict(bool) url-safe(bool) ]] decode |
| !^.line[] 1-based offset |
|
| !^.sort{{ }|( )}[{desc|asc}] default=asc |
^строка.idna[] |
| !^.append{} |
IDNA кодирование, поддержка кириллических доменов |
| X^.insert{}[(n)] |
|
| [ n] |
^string:idna[encoded] |
| X^.remove(position[;count]) - |
IDNA декодирование, поддержка кириллических доменов |
| [ ] |
|
| [ count ] |
^строка.js-escape[] кодирование для передачи в JS (%uXXXX) |
| !^.join[][$.limit(1) $.offset(5) $.offset[cur]] - . |
|
| . |
^string:js-unescape[escaped] декодирование переданного из js |
| !^.flip[] , - , |
|
| !^.locate[;][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri |
| , . bool |
|
| !^.locate( )[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
|
| , . bool |
table |
| !^.hash{[]|{}|()}[[ |table ]][[$.distinct(1) $.distinct[tables]]] |
в выражении |
| $hash. hash |
логическое значение равно "не пуста?" |
| , , |
числовое значение равно count[] |
| distinct true, |
^table::create[[nameless]]{данные}[[$.separator[^#09] $.encloser[]]] |
| distinct tables, hash , |
^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| !^.columns[]+ $column |
клонирует таблицу |
| !$[^.select()] = , |
reverse - в обратном порядке |
| |
^table::load[[nameless;]путь[;опции]] |
| |
если не nameless, названия колонок берутся из первой строки |
| |
пустые строки, и строки в первой колонке содержащие '#', игнорируются |
| |
$.separator[^#09] |
| |
$.encloser["] по-умолчанию, нет. |
| |
^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash]]] |
| |
bind привязывает переменные в запросе к их значениям |
| |
пока реализован только для oracle |
| |
в запросе надо написать ":имя" |
| |
в параметре bind передать hash, из которого возьмётся (или куда запишется) значение |
| |
^таблица.save[[nameless|append;]путь[;опции, см. load]] |
| |
$таблица.поле |
| |
$таблица.поле[новое значение] |
| |
$таблица.fields из named таблицы выдаёт текущую запись как Hash |
| |
^таблица.menu{тело}[[разделитель]] |
| |
^таблица.foreach[позиция;значение]{тело}[[разделитель]] |
| |
^таблица.line[] 1-based offset |
| |
^таблица.offset[] печатает offset |
| |
^таблица.offset[[whence]](5) сдвигает |
| |
whence=cur|set, без whence - это cur |
| |
^таблица.count[], ^таблица.count[rows] - количество строк в таблице |
| |
^таблица.count[columns] - количество столбцов таблицы |
| |
^таблица.count[cells] - количество ячеек в текущей строке таблицы |
| |
^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc |
| |
^таблица.append{данные} |
| |
^таблица.append[ $.имя столбца[значение столбца] ] |
| |
^таблица.insert{данные} добавить запись на текущую позицию |
| |
^таблица.insert[ $.имя столбца[значение столбца] ] |
| |
^таблица.delete[] - стирает запись с текущей позиции |
| |
^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]] - добавляет записи из таблицы. |
| |
таблицы должны иметь одинаковую структуру. |
| |
^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать |
| |
^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| |
передвигает текущую строку, если найдёт. выдаёт bool |
| |
^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| |
передвигает текущую строку, если найдёт. выдаёт bool |
| |
^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]{код значения}][[$.distinct(1) $.distinct[tables] $.type[hash]]] |
| |
по умолчанию значением $hash.ключ будет hash в котором поля значений будут ключами |
| |
поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой |
| |
если distinct содержит true, то не будет ошибки при повторяющихся ключах |
| |
если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом |
| |
$.type[string/table] поменять значение элемента на строку (указать одну колонку) или таблицу |
| |
^таблица.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[] |
| !$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) $.type[hash|string|table]]] |
| hash(= ) |
получается hash(ключи=значения первая колонка ответа) of hash(ключи=названия остальных колонкок ответа) или |
| of hash(= ) |
string=значение каждого элемента - строка, при этом надо указать ровно два столбца или |
| !^hash._keys[]+ $key |
table=значение каждого элемента - таблица |
| !^hash._count[] |
^хеш.keys[[название колонки с ключами]] + таблица из одного столбца key или как передадут |
| !^foreach[key;value]{}[[]|{ }] |
^хеш.count[] |
| !^delete[] |
^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
^хеш.delete[ключ] удалить ключ |
| !hashfile |
^хеш.contain[ключ] - существует ли в хеше ключ (bool) |
| !^hashfile::open[filename] |
^хеш.at[first|last][[key|value|hash]] |
| !^hashfile.clear[] |
^хеш.at([-]N)[[key|value|hash]] |
| !.[] |
доступ к заданным элементам упорядоченного хеша |
| !.[$.value[] $.expires } |
^хеш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc |
| expires |
$обратный_хеш[^хеш.reverse[]] |
| expires date, (0= ) |
$отобранное[^хеш.select[key;value](выражение)[ $.limit(N) $.reverse(bool) $.default(bool) ]] = хеш из ключей и значений, для которых условие истинно |
| !. |
|
| !^delete[] |
|
| !^delete[] , |
hashfile |
| !^hash[] |
^hashfile::open[filename] |
| hash |
^хешфайл.clear[] забыть всё |
| |
$хешфайл.ключ[значение] положить значение |
| !^foreach[key|value]{}[[]|{ }] |
$хешфайл.ключ[$.value[значение] $.expires[ЗНАЧЕНИЕ]} |
| |
положить значение до expires |
| : |
значение поля expires может быть date, или число дней(0дней=на вечно) |
| $uids[^hashfile::open[/db/uids]] |
$хешфайл.ключ достать |
| |
^хешфайл.delete[ключ] удалить ключ |
| $random[23847387taduigh345XGHWElxjgdjg] |
^хешфайл.delete[] удалить файлы, содержащие данные |
| $uids.$random[$.value[$uid] $.expires(1)] |
^хешфайл.hash[] |
| $uid[$persistent.logins.$random] |
преобразовать в обычный hash |
| |
попутно стирает устаревшие пары |
| !form |
^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| [ GET, POST] |
^хешфайл.release[] |
| !$form: = string/file |
записать данные и снять блокировки. |
| !$form:nameless = "?value&...", "...&value&...", "...&value" |
при повторном обращении к элементам откроется автоматически. |
| !$form:qtail = "?xxxxx", ',' [imap] |
^хешфайл.cleanup[] пробежаться по всем элементам и удалить устаревшие. |
| !$form:fields = hash |
|
| !$form:tables. = table "field" "" |
пример: |
| !$form:imap = 'x' 'y' |
$sessions[^hashfile::open[/db/sessions]] |
| ?1,2 server-site image map |
|
| |
$sid[^math:uuid[]] |
| !env |
$sessions.$sid[$.value[$uid] $.expires(1)] |
| !$env: |
$uid[$sessions.$sid] |
| |
|
| !cookie |
|
| !$cookie: |
array |
| !$cookie:[] 90 |
в выражении |
| !$cookie:[$.value[] $.expires ] |
логическое значение равно "не пуст?" |
| ! expires 'session', date, (0=session) |
числовое значение равно count[] |
| ! , "Sun, 25-Aug-2002 12:03:45 GMT" |
$массив.индекс, $массив.(выражение) |
| |
возврат значения по заданному индексу |
| !request |
$массив.индекс[значение], $массив.(выражение)[значение] |
| !$request:query |
присваивание значения по индексу |
| !$request:body unprocessed POST request body |
$массив[значение;значение;...] |
| !$request:uri |
создание массива с заданными значениями |
| !$request:document-root |
^array::create[] |
| , parser, - = $env:DOCUMENT_ROOT |
^array::create[значение;значение;...] |
| , hosting - |
создание массива с заданными значениями или пустого массива |
| X!$request:browser hash, : |
^array::copy[копируемый массив или хеш с цифровыми ключами] |
| !$type = ie/nn !$version = , 5.5 |
копирование массива или хеша с цифровыми ключами |
| X$request:user |
^массив.add[добавляемый массив или хеш с цифровыми ключами] |
| X$request:password |
добавление элементов из другого массива или хеша с перезаписью значений у совпадающих индексов |
| !$request:charset |
^массив.join[добавляемый массив или произвольный хеш] |
| |
добавление элементов другого массива или хеша в конец массива |
| ! upper/lower match[][i] |
^массив.append[значение;значение;...] |
| : form auto MAIN |
добавление элементов в конец массива |
| $request/response:charset . . |
^массив.insert(индекс)[значение;значение;...] |
| |
вставка элементов в указанную позицию массива |
| !response |
^массив.left(n) |
| !$response:[] -- $response: |
возвращает новый массив из n первых элементов массива |
| ! string hash: |
^массив.right(n) |
| ! $value[abc] field: {abc}<< |
возвращает новый массив из n последних элементов массива |
| ! $attribute[zzz] field: abc; {attribute=zzz}<< |
^массив.mid(m;n) |
| ! string date |
возвращает новый массив, содержащий n инициализированных элементов массива, начиная с позиции m |
| ! , "Sun, 25-Aug-2002 12:03:45 GMT" |
^массив.delete(index) |
| !$response:body[DATA] |
удаление элемента массива с оставлением пустого места |
| !$response:download[DATA] , |
^массив.remove(index) |
| , browser download |
удаление элемента со сдвигом последующих элементов на его место |
| !$response:status |
^массив.push[значение] |
| !^response:clear[] response |
добавление элемента в конец массив |
| !$response:charset |
^массив.pop[] |
| .. , |
возвращает последний элемент и удаляет его из массива |
| 1) $form: browser' |
^массив.contain(индекс) |
| 2) browser |
существует ли в массиве элемент по переданому индексу (bool) |
| 3) uri |
^array::sql{запрос}[[ $.sparse(false) $.distinct(false) $.limit(2) $.offset(4) $.type[hash|string|table]]] |
| content-type , , |
создание массива на основе выборки из базы данных |
| : form auto MAIN |
$.sparse(false), по умолчанию - создать обычный массив. Значения строк выборки последовательно добавляются в массив |
| $request/response:charset . . |
$.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] |
| |
$form:поле = string/file |
| |
$form:nameless = поле со значением поля без имени "?value&...", "...&value&...", "...&value" |
| |
$form:qtail = строка со значением текста после второго "?xxxxx", если там не было ',' [imap] |
| |
$form:fields = hash со всеми полями формы |
| |
$form:tables.поле = table с одним столбцом "field" со значениями "поля", для множественных значений |
| |
$form:files.поле = hash со значениями полей типа файл, ключи - 0, 1, ..., значение - файл |
| |
$form:imap = хеш с ключами 'x' и 'y' |
| |
со значением ?1,2 приписки при использовании server-site image map |
| |
|
| |
env |
| |
$env:переменная |
| |
$env:fields хеш с переменными окружения |
| |
$env:PARSER_VERSION версия парсера |
| |
|
| |
cookie |
| |
$cookie:имя считать старое или свежезаданное |
| |
$cookie:имя[значение] на 90 дней |
| |
$cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true) $.domain[имя домена] $.httponly(true)] |
| |
значение поля expires может быть 'session', date, или число дней(0дней=session) |
| |
если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| |
$cookie:fields = hash со всеми cookies |
| |
|
| |
request |
| |
$request:query |
| |
$request:uri |
| |
$request:document-root |
| |
каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT |
| |
$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла]. |
| |
$request:charset |
| |
Кодировка исходного документа |
| |
используется при upper/lower и match[][i] |
| |
ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form |
| |
$request:method метод запроса (GET|POST|PUT) |
| |
$request:body тело POST-запроса в виде текста |
| |
$request:body-file тело POST-запроса в виде файла |
| |
$request:body-charset кодировка POST-запроса |
| |
$request:headers хеш с заголовками запроса (без префикса HTTP_) |
| |
|
| |
|
| |
response |
| |
$response:поле[значение] и можно считать старое - $response:поле |
| |
значение может быть string а может быть hash: |
| |
$value[abc] field: {abc}<<часть |
| |
$attribute[zzz] field: abc; {attribute=zzz}<<часть |
| |
значение поля или атрибута может быть string или date |
| |
если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| |
$response:headers накопленные поля |
| |
$response:body[DATA] замещает стандартный ответ |
| |
$response:download[DATA] замещает стандартный ответ, |
| |
выставляет флаг, заставляющий browser предложить download |
| |
$response:status |
| |
^response:clear[] забыть все заданные response поля |
| |
$response:charset |
| |
кодировка клиента т.е. та, |
| |
1) из которой будут перекодированы $form:поля после забирания из browser'а |
| |
2) в которую документ будет перекодирован перед отдаванием в browser |
| |
3) в которую будет перекодирован текст языка uri |
| |
не добавляет к content-type ничего, если хочется, это надо сделать вручную |
| |
ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form |
| |
|
| |
|
| |
regex |
| |
в выражении |
| |
логическое значение всегда равно true |
| |
числовое значение равно количеству байт скомпилированного шаблона. |
| |
^regex::create[шаблон-строка|regex][[опции поиска]] |
| |
^шаблон.size[] количество байт скомпилированного шаблона |
| |
если значение очень большое - стоит почитать документацию по pcre и, возможно, переписать шаблон. |
| |
^шаблон.study_size[] размер study-структуры. если==0 - шаблон не может быть "изучен" |
| |
$шаблон.pattern текст шаблона |
| |
$шаблон.options строка с исходным текстом опций |
| |
|
| |
|
| |
reflection |
| |
^reflection:create[класс;конструктор[;пара;[мет[;ры]]]] вызывает указанный конструктор класса (не более 100 параметров) |
| |
^reflection:classes[] хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void |
| |
^reflection:class[объект] класс переданного объекта |
| |
^reflection:class_name[объект] имя класса переданного объекта |
| |
^reflection:base[объект] родительский класс переданного объекта |
| |
^reflection:base_name[объект] имя родительского класса переданного объекта |
| |
^reflection:class_by_name[имя класса] получение класса по имени |
| |
^reflection:def[class;имя класса] проверка класса на существование |
| |
^reflection:methods[класс] хеш со списком методов указанного класса, значения -- строки 'native' или 'parser' |
| |
^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта |
| |
^reflection:fields[класс или объект] хеш со списком статических полей указанного класса или динамических полей указанного объекта |
| |
^reflection:field[класс или объект;имя поля] возвращает значение указанного поля класса или объекта. getter-ы игнорируются. |
| |
^reflection:uid[класс или объект] возвращает идентификатор объекта или класса |
| |
^reflection:method_info[класс;метод] хеш с параметрами указанного метода класса |
| |
$.inherited[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
| |
$.overridden[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке) |
| |
для native классов возвращается хеш: |
| |
.min_params(минимально необходимое число параметров) |
| |
.max_params(максимально возможное число параметров) |
| |
.call_type[dynamic|static|any] |
| |
для parser классов возвращается хеш: |
| |
ключ -- номер параметра (0, 1, ...), значение - имя параметра |
| |
^reflection:dynamical[[object or class, caller if absent]] |
| |
возвращает true, если метод был вызван из динамического контекста при передаче |
| |
параметра возвращает true, если передан динамический объект, false если класс |
| |
^reflection:delete[класс или объект;имя переменной] удаляет переменную с указанным именем в указанном классе или объекте |
| |
^reflection:is[имя элемента;имя класса][[контекст]] аналог оператора is, позволяющий определить, является ли элемент кодом. |
| |
|
| !mail |
|
| !$mail.received=MESSAGE: |
mail |
| |
$mail.received=MESSAGE: |
| .from |
.from |
| .reply-to |
.reply-to |
| .subject |
.subject |
| .date date |
.date класса date |
| .message-id |
.message-id |
| .raw[ |
.raw[ |
| ._-- |
.СЫРОЕ_ПОЛЬЗОВАТЕЛЬСКОЕ-ПОЛЕ-ЗАГОЛОВКА |
| ] |
] |
| $.{text|html|file#}[ << mail:send (text, text2, ...) (file, file2, ...) |
$.{text|html|file#}[ << нумеруется как и в mail:send (text, text2, ...) (file, file2, ...) |
| $.content-type[ |
$.content-type[ |
| $.value[{text|...|x-unknown}/{plain|html|...|x-unknown}] |
$.value[{text|...|x-unknown}/{plain|html|...|x-unknown}] |
| [$.charset[windows-1251]] << , |
[$.charset[windows-1251]] << в каком пришло, сейчас уже перекодировано |
| $.-- |
$.ПОЛЬЗОВАТЕЛЬСКИЙ-ПАРАМЕТР-ЗАГОЛОВКА |
| ] |
] |
| $.description |
$.description |
| $.content-id |
$.content-id |
| $.content-md5 |
$.content-md5 |
| $.content-location |
$.content-location |
| .raw[ |
.raw[ |
| ._-- |
.СЫРОЕ_ПОЛЬЗОВАТЕЛЬСКОЕ-ПОЛЕ-ЗАГОЛОВКА |
| ] |
] |
| $.value[|FILE] |
$.value[строка|FILE] |
| ] |
] |
| $.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, . |
это старый формат, поддерживается для обратной совместимости |
| ! attach, , :: |
если имя части начинается со слова text, то это текстовый блок. |
| !$attach[$.format[!uue|Xbase64] $.value[DATA] $.file-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>] |
| $.to["" <petya@design.ru>] |
$.to["петя" <petya@design.ru>] |
| $.subject[ ] |
$.subject[пойдём пивка] |
| $.body[ |
$.body[ |
| |
слова |
| ] |
] |
| ] |
] |
| |
|
| ^mail:send[ |
^mail:send[ |
| $.from["" <vasya@design.ru>] |
$.from["вася" <vasya@design.ru>] |
| $.to["" <petya@design.ru>] |
$.to["петя" <petya@design.ru>] |
| $.subject[ ] |
$.subject[пойдём пивка] |
| $.body[ |
$.body[ |
| $.text[ |
$.text[ |
| # body |
# задаёт кодировку body |
| $.charset[windows-1251] |
$.charset[windows-1251] |
| # |
# нет умолчания |
| $.content-type[$.value[text/plain] $.charset[windows-1251]] |
$.content-type[$.value[text/plain] $.charset[windows-1251]] |
| $.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] |
| ] |
] |
| ] |
] |
| ] |
] |
| ! |
для отправки под unix используется программа с параметрами, задаваемая |
| unix , |
$MAIL.sendmail[команда] |
| $MAIL.sendmail[] |
если не будет задана, проверяется, доступна ли /usr/sbin/sendmail или |
| , , |
/usr/lib/sendmail и, если доступна, то запускается с параметром "-t". |
| /usr/sbin/sendmail |
|
| /usr/lib/sendmail |
под win32 используется SMTP протокол, сервер задаётся |
| , , "-t". |
|
| 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, |
| !$image.exif << hash measure jpeg exif |
умеет мерить .gif, .jpg, tiff, bmp, webp и mp4 (mov) |
| !$image.exif.DateTime & co |
$картинка.exif << hash после measure jpeg с exif информацией и $.exif(true) |
| [ . http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] |
$image.exif.DateTime & co |
| ! int/double, |
[полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] |
| ! date |
числа типа int/double, |
| ! hash 0..count-1 |
даты типа date |
| !$.src .width .height |
перечисления в виде hash с ключами 0..count-1 |
| !$.line-width = |
$картинка.src .width .height |
| !$.line-style = '*** * '='*** * *** * *** * ' |
$картинка.line-width число=ширина линий |
| !^.html[[hash]] = <img ...> |
$картинка.line-style строка=стиль линий '*** * '='*** * *** * *** * ' |
| !^image::load[.gif] |
^картинка.html[[hash]] = <img ...> |
| gif |
^image::load[фон.gif] |
| !^image::create( X; Y[; default ]]) |
только gif пока |
| !^.line(x0;y0;x1;y1;0xffFFff) |
^image::create(размер X;размер Y[;цвет фона default белый]]) |
| !^.fill(x;y;0xffFFff) |
^картинка.line(x0;y0;x1;y1;0xffFFff) |
| !^.rectangle(x0;y0;x1;y1;0xffFFff) |
^картинка.fill(x;y;0xffFFff) |
| !^.bar(x0;y0;x1;y1;0xffFFff) |
^картинка.rectangle(x0;y0;x1;y1;0xffFFff) |
| !^.replace(hex-1;hex-2)[table x:y _] |
^картинка.bar(x0;y0;x1;y1;0xffFFff) |
| !^.polyline+()[table x:y ] |
^картинка.replace(hex-цвет1;hex-цвет2)[table x:y вершины_многоугольника] |
| !^.polygon()[table x:y _] |
^картинка.polyline(цвет)[table x:y точки] |
| !^.polybar()[table x;y _] |
^картинка.polygon(цвет)[table x:y вершины_многоугольника] |
| !^.font[_;__.gif](_[;_]) |
^картинка.polybar(цвет)[table x;y вершины_многоугольника] |
| = / |
^картинка.font[набор_букв;имя_файла_шрифта.gif][(ширина_пробела[;ширина_символа])] |
| _, monospaced, 0, _ = gif |
высота символа = высота картинки/количество букв в наборе |
| !^.text(x;y)[_] AS_IS |
если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif |
| !^.length[_] AS_IS |
^картинка.font[набор_букв;имя_файла_шрифта.gif; |
| !^.gif[, ] -- FILE content-type=image/gif |
$.space(ширина_пробела) // по умолчанию = ширине gif |
| $response:download |
$.width(ширина_символа) // см. выше, по умолчанию proportional |
| !^.arc(center x;center y;width;height;start in degrees;end in degrees;color) |
$.spacing(расстояние между буквами) // по умолчанию = 1 |
| !^.sector(center x;center y;width;height;start in degrees;end in degrees;color) |
] |
| !^.circle(center x;center y;r;color) |
^картинка.text(x;y)[текст_надписи] AS_IS |
| !^.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]]) |
^картинка.length[текст_надписи] AS_IS |
| dest_w/dest_h |
^картинка.gif[возможно, имя файла] -- кодирует в FILE с content-type=image/gif |
| resample |
имя файла будет использовано при $response:download |
| [] /pie, |
^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color) |
| thumbnais . |
^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color) |
| dest_h aspect ratio |
^картинка.circle(center x;center y;r;color) |
| tolerance - [ RGB ], |
^картинка.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]]) |
| [default=150] |
при заданных dest_w/dest_h делает изменение размера кусочка |
| - , |
при уменьшении делает resample |
| - , |
годится только для уменьшения простой[малоцветной] дребедени вроде графиков/pie, |
| |
для thumbnais не годится. |
| !file |
при не указанном dest_h сохраняет aspect ratio |
| !$__post.name |
tolerance - некое число[квадрат расстояния в RGB пространстве до искомого цвета], |
| !$__post.size |
определяющее прожорливость выделялки цветов из палитры [default=150] |
| !$t_post.text |
меньше - точнее приближает цвета, но они быстро кончаются |
| !^.save[text|binary; ] |
больше - неточно приближает цвет, но бОльшей части хватит |
| !^file:delete[ ] |
^картинка.pixel(x;y)[(color)] |
| !^file:find[ ][{ }] |
узнать или задать цвет пиксела |
| !^file:list[[;]] = table name |
|
| !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;]] |
|
| !$___loaded.size |
file |
| !^file::stat[ ] |
$файл_из_post.name |
| !$___stated.size !.adate !.mdate !.cdate |
$файл_из_post.size |
| !^file::cgi[ [;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]] |
$файлt_из_post.text |
| $ |
^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем]]] |
| |
^file:delete[имя файла] |
| |
^file:find[имя файла][{когда не нашли}] |
| |
^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонками name dir |
| |
^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)] = table с колонками name dir size [mca]date |
| |
^file::load[text|binary;big.zip[;domain_press_release_2001_03_01.zip][;опции]] |
| |
^file::create[text|binary;имя;data] |
| |
^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]] |
| |
^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.charset[...]]] |
| |
$файл_который_был_loaded.size |
| |
$файл_который_был_loaded_или_created.mode = text/binary |
| |
^file::stat[имя файла] |
| |
$файл_который_был_stated_или_loaded.size .adate .mdate .cdate |
| |
^file::cgi[[text|binary;]имя файла[;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]] |
| |
возвращённый заголовок рассыпается на $поля |
| $status |
$status |
| $stderr |
$stderr |
| !^file::exec[ [;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under win32 max 10 args]]]]]]] |
^file::exec[[text|binary;]имя файла[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under unix max 50 args]]]]]]] |
| options: |
options: |
| $.stdin[] , HTTP-POST |
$.stdin[текст|файл] если пусто, отключается автоматическое пересовывание данных HTTP-POST |
| !^file:move[ ; ] |
^file:move[старое имя файла;новое имя файла] |
| [win32: ] |
можно переименовывать и двигать каталоги[win32: но не через границу дисков] |
| dest 775 |
каталоги для dest создаются с правами 775 |
| , move |
каталог старого файла стирается, если после move он остаётся пуст |
| !^file:lock[ ]{} |
^file:copy[имя файла;имя копии файла[; $.append(1) ]] |
| |
можно копировать только файлы |
| |
^file:lock[имя файла]{код} |
| |
файл при необходимости создаётся |
| |
блокируется |
| Xchmod[...] , executable , ftp chmod. |
выполняется код |
| !^file:dirname[/a/some.tar.gz]=/a |
разблокируется |
| !^file:dirname[/a/b/]=/a |
^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix) |
| !^file:basename[/a/some.tar.gz]=some.tar.gz |
^file:dirname[/a/b/]=/a (работает аналогично комманде *nix) |
| !^file:justname[/a/some.tar.gz]=some.tar |
^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix) |
| !^file:justext[/a/some.tar.gz]=gz |
^file:basename[/a/b/]=b (работает аналогично комманде *nix) |
| !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif |
^file:justname[/a/some.tar.gz]=some.tar |
| |
^file:justext[/a/some.tar.gz]=gz |
| |
/some/page.html: ^file:fullpath[a.gif] => /some/a.gif |
| !math |
^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать |
| !$math:PI |
^file::sql{query}[[ |
| !^math:round floor ceiling |
$.name[имя_файла_для_download] |
| !^math:trunc frac |
$.content-type[пользовательский content-type] |
| !^math:abs sign |
]] |
| !^math:exp log |
результат запроса должен быть "одна строка". |
| !^math:sin asin cos acos tan atan |
колонки: |
| !^math:degrees radians |
первая колонка - данные |
| !^math:pow sqrt |
если есть вторая - это имя файла |
| !^math:random( ) |
если есть третья - это content-type |
| !^math:uuid[] |
^файл.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode |
| |
^file:base64[имя файла[; $.pad(bool) $.wrap(bool) $.url-safe(bool) ]] |
| |
encode |
| |
^file::base64[encoded string[; $.pad(bool) $.strict(bool) url-safe(bool) ]] |
| |
^file::base64[mode;имя файла;encoded string[; $.content-type[...] $.pad(bool) $.strict(bool) url-safe(bool) ]] |
| |
decode |
| |
^file:crc32[имя файла] |
| |
вычисляет crc32 файла с указанным именем |
| |
^файл.crc32[] |
| |
вычисляет crc32 объекта |
| |
^файл.md5[] |
| |
^file:md5[имя файла] |
| |
выдает digest файла, длиной 16 байт в виде строки, |
| |
где байты digest выданы в hex виде, впритык, в нижнем регистре |
| |
|
| |
|
| |
math |
| |
$math:PI |
| |
^math:round floor ceiling |
| |
^math:trunc frac |
| |
^math:abs sign |
| |
^math:exp log |
| |
^math:sin asin cos acos tan atan |
| |
^math:degrees radians |
| |
^math:pow sqrt |
| |
^math:random(ширина диапазона) |
| |
^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] |
| !date |
вычисляет crc32 строки |
| ! time , |
^math:sha1[string] |
| epoch [1 1970 (UTC)], |
^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64] $.hmac[ключ] ]] |
| ! localtime, |
объединяет в себе возможность работы с разными алгоритмами криптографического хеширования. |
| ! parser OS |
$.hmac[ключ] для проверки целостности переданных данных |
| $date:UTC-offset , local |
|
| $date:TZ , , (- ) |
|
| !^date::now[] |
inet |
| !^date::now( ) + |
^inet:ntoa(long) |
| !^date::create( epoch) // set |
^inet:aton[IP] |
| !^date::create(year;month[;day[;hour[;minute[;second]]]]) // set |
^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прямое преобразование имени в IP адрес |
| !^date::create[ %Y-%m-%d %H:%M:%S] |
^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреса в имя |
| |
|
| 1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] |
|
| 2: %H:%M[:%S] |
json |
| !^date::unix-timestamp() |
^json:parse[-json-строка-[; |
| !^date.unix-timestamp[] |
$.depth(максимальная глубина, default == 19) |
| !$date.year month day hour minute second weekday yearday(0...) daylightsaving TZ |
$.double(false) отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен) |
| read-only |
в этом случае они попадут в результирующий объект как строки |
| TZ="" << |
$.int(false) отключить встроенный парсинг целых чисел (по умолчанию включен) |
| !^date.roll[year|month|day](+-) |
в этом случае они попадут в результирующий объект как строки |
| !^date.roll[TZ; ] , - : .hour&co |
$.distinct[first|last|all] как будет происходить разбор дублирующихся ключей у объектов |
| !^date.sql-string[] %Y-%m-%d %H:%M:%S |
first -- будет оставлен первый встретившийся элемент |
| where published='$.sql-string[]' |
last -- будет оставлен последний встретившийся элемент |
| !^date:calendar[rus|eng;;] |
all -- будут оставлены все элементы. при этом элементы, начиная со 2 |
| : 0..6, week, weekyear |
получат числовые суффиксы (key_2 итд) |
| !^date:calendar[rus|eng;;;] |
по умолчанию дублирующиеся ключи приведут к exception |
| : year, month, day, weekday |
$.object[method-junction] пользовательский метод[ключ;объект], которому будут передаваться все разобранные |
| |
объекты и ключи объекта, метод возвращает новый объект |
| |
$.array[method-junction] пользовательский метод, которому будут передаваться массивы |
| |
$.taint[язык преобразования] задаёт язык преобразования для всех строк результата |
| |
]] |
| |
парсит json-строку в хеш |
| |
|
| |
^json:string[system or user object[; |
| |
$.skip-unknown(false) отключить exception и выдавать 'null' при сериализации объектов с типами |
| |
отличных от void, bool, string, int, double, date, table, hash и file |
| |
$.indent(true) форматировать результирующую строку табуляциями по глубине вложенности |
| |
$.date[sql-string|gmt-string|iso-string|unix-timestamp] формат вывода даты, по умолчанию -- sql-string |
| |
$.table[object|array|compact] формат вывода таблицы, по умолчанию -- object |
| |
object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...] |
| |
array: [["c1","c2",...] || null (for nameless),["v11","v12",...],...] |
| |
compact: ["v11" || ["v11","v12",...],...] |
| |
$.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла |
| |
не попадает в output) |
| |
$.xdoc[hash] параметры преобразования xdoc в строку (как в ^xdoc.string[]) |
| |
$.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который |
| |
должен принимать 3 параметра: ключ, объект данного типа и опции |
| |
вызова ^json:string[] |
| |
$._default[метод] пользовательский метод, будет вызываться для вывода всех объектов пользовательских |
| |
классов. Метод должен принимать 3 параметра: ключ, объект и опции вызова. |
| |
$._default[имя метода] имя пользователького метода, при его наличии он будет вызван для |
| |
сериализации |
| |
$.void[null|string] неопределенное значение будет выдано в виде null (по умолчанию) |
| |
или пустой строки |
| |
]] |
| |
сериализует системный или пользовательский объект в json-строку |
| |
|
| |
|
| |
date |
| |
время типа time можно использовать в выражениях, подставляет количество дней с epoch [1 января 1970 (UTC)], дробное. |
| |
Строковое значение в местном времени, численное в UTC, диапазон от 0000-00-00 00:00:00 до 9999-12-31 23:59:59. |
| |
по умолчанию используется установленная средствами OS временная зона |
| |
^date::now[] |
| |
^date::now(смещение в днях) выдаёт сейчас+смещение |
| |
^date::today[] дата на 00:00:00 текущего дня |
| |
^date::today(целочисленное смещение в днях) дата на 00:00:00 текущего дня+смещение |
| |
^date::create(дней с epoch) |
| |
^date::create(year;month[;day[;hour[;minute[;second[;TZ]]]]]) |
| |
^date::create[дата в формате %Y-%m-%d %H:%M:%S] |
| |
для удобного создания по значению из базы |
| |
формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] |
| |
формат2: %H:%M[:%S] |
| |
^date::create[дата в формате %Y-%m-%dT%H:%M[:%S]TZ] |
| |
для создания по значению в формате ISO 8601 |
| |
формат TZ: Z(UTC) или +-hour[:minute] (смещение от UTC) |
| |
^date::unix-timestamp() |
| |
^дата.unix-timestamp[] |
| |
$дата.year month day hour minute second weekday yearday(0...) daylightsaving TZ weekyear |
| |
TZ="" << локальная зона |
| |
$дата.year month day hour minute second можно задать новое значение, остальные read only |
| |
^дата.roll[year|month|day](+-смещение) сдвигает дату |
| |
^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co |
| |
^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе |
| |
^дата.sql-string[[datetime|date|time]] |
| |
datetime или без параметра -- %Y-%m-%d %H:%M:%S |
| |
date -- %Y-%m-%d |
| |
time -- %H:%M:%S |
| |
where published='^дата.sql-string[]' |
| |
^date:calendar[rus|eng](год;месяц) выдаёт неименованную таблицу |
| |
столбцы: 0..6, week, year |
| |
^date:calendar[rus|eng](год;месяц;день) выдаёт именнованную таблицу |
| |
столбцы: year, month, day, weekday |
| |
^date:last-day(год;месяц) вернёт последний день месяца |
| |
^дата.last-day[] вернёт последний день месяца $дата |
| |
^дата.gmt-string[] Fri, 23 Mar 2001 09:32:23 GMT |
| |
^дата.iso-string[] 2001-03-23T12:32:23+03 |
| |
|
| |
|
| xdoc(xnode) |
xdoc(xnode) |
| |
$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 |
| / |
для каталогов конечный / обязателен |
| !::load[file.xml[;]] |
::create[file] can be usable: |
| !.transform[rules.xsl|xdoc][[params hash]] dom |
$f[^file::load[binary;http://;some HTTP options here...]] |
| , , |
$x[^xdoc::create[$f]] |
| " .stamp"[ stamp ] |
::load[file.xml[;опции]] |
| |
.transform[rules.xsl|xdoc][[params hash]] выдаёт dom |
| |
шаблон кешируется, кеш обновляется при изменении даты файла шаблона, |
| |
или изменении даты файла "имя шаблона.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]] |
[исключение: игнорируется cdata-section-elements, нужно будет, сделаю] |
| !.save[file.xml[;output options]] |
выдаёт media-type при подстановке $response:body[сюда] |
| !.file[[output options]] = file |
|
| output options xsl:output |
если на документ ссылаются так: |
| [: cdata-section-elements, , ] |
parser://method/param/to/that/method |
| media-type $response:body[] |
то в качестве документа используется ^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 |
| !$element_node.attributes = hash of xnodes |
$node.prefix |
| !$element_node.tagName |
$node.namespaceURI |
| !$attribute_node.specified = boolean |
$element_node.attributes = hash of xnodes |
| true if the attribute received its value explicitly in the XML document, |
$element_node.tagName |
| |
$attribute_node.specified = boolean |
| |
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() |
| |
|
| !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 |
memory |
| If index or size is negative, or greater |
^memory:compact[] собрать мусор, освободив место под новые данные |
| than the allowed value |
(предупреждение: память процесса никогда не освобождается) |
| DOMSTRING_SIZE_ERR |
полезно делать перед XSL transform. |
| If the specified range of text does not |
|
| fit into a DOMString |
|
| HIERARCHY_REQUEST_ERR |
status |
| If any node is inserted somewhere it |
$status:sql |
| doesn't belong |
cache table |
| WRONG_DOCUMENT_ERR |
url time |
| If a node is used in a different |
url time |
| document than the one that created it |
url time |
| (that doesn't support it) |
$status:stylesheet |
| INVALID_CHARACTER_ERR |
cache table |
| 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:compact[] , |
|
| (: ) |
|
| XSL transform. |
|
| |
|
| !status |
|
| ! , apache |
|
| <Location /parser-status.html> |
|
| ParserStatusAllowed |
|
| </Location> |
|
| ! cgi |
|
| ! isapi |
|
| |
|
| !$status:sql hash |
|
| !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:charset hash |
|
| !cache table |
$status:rusage hash |
| file |
utime user time used |
| file |
stime system time used |
| file |
maxrss max resident set size |
| |
ixrss integral shared text memory size |
| !$status:rusage hash |
idrss integral unshared data size |
| !utime user time used |
isrss integral unshared stack size |
| !stime system time used |
tv_sec |
| !maxrss max resident set size |
tv_usec |
| !ixrss integral shared text memory size |
|
| !idrss integral unshared data size |
|
| !isrss integral unshared stack size |
|
| !tv_sec |
|
| !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. |
Return the total number of bytes [EVER(c)PAF] allocated in this process. |
| |
Never decreases. |
| !ever_allocated_since_start |
|
| Return the total number of bytes [EVER(c)PAF] allocated in this process. |
$status:pid process id |
| Never decreases. |
$status:tid thread id |
| |
|
| |
|
| console |
console |
| $console:timeout |
$console:timeout |
| !$console:line |
$console:line |
| read/write |
read/write строку |
| |
|
| !DATA::=string | file |
|
| |
|
| !MAIN |
DATA::=string | file | hash |
| , parser3.conf, |
|
| auto.p : |
hash вида |
| !parser3.conf |
[ |
| cgi: |
$.file[имя файла на диске] |
| 1. CGI_PARSER_SITE_CONFIG |
$.name[имя файла для пользователя] |
| parser' |
$.mdate[date] |
| |
] |
| |
|
| |
|
| |
MAIN |
| |
это класс, загружаемый на автомате из конфигурационного auto.p, кучи auto.p и запрашиваемого документа: |
| |
конфигурационный auto.p |
| |
cgi: |
| |
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[] |
| ! @post-process[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.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 |
а также, возможно, указать опции: |
| ! , , : |
$.method[GET|POST|HEAD] |
| !$.method[GET|HEAD] |
$.timeout(3) << в секундах, по-умолчанию =2 |
| !$.timeout(3) << , - =2 |
$.cookies[ |
| !$.headers[ |
$.имя[значение] |
| ! $[] << , $response: |
] |
| !] |
$.headers[ |
| !-, user-agent=parser3 |
$.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК |
| !-, http status != 200 >> http.status , |
] |
| ! , |
$.enctype[multipart/form-data] |
| !$.any-status(1) |
$.form[ |
| !$.charset[ -] << content-type:charset=_ |
$.field1[string] |
| !file::load |
$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}] |
| !: ( ) |
$.field3[file] |
| !tables << ->table "value". |
] |
| . , set-cookies |
$.body[string|file] |
| todo: cookies |
по-умолчанию, user-agent=parser3 |
| |
по-умолчанию, получение http status != 200 >> создает http.status ошибку, это можно отключить, передав $.any-status(1) |
| ! : |
$.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА_ПЕРЕБИВАЕТ |
| !parser.compile ^test[} ( , ...) |
$.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset |
| !parser.runtime ^if(0). (/, , , ...) |
$.user[пользователь] |
| !number.zerodivision ^eval(1/0) ^eval(1%0) |
$.password[пароль] |
| !number.format ^eval(abc*5) |
file::load в дополнительные поля записывает |
| !file.lock shared/exclusive lock error |
ПОЛЕ:значение (имена полей ответа заглавными буквами) |
| !file.missing ^file:delete[delme] not found |
tables << хеш их ПОЛЕ->table с единственным столбцом "value". |
| !file.access ^table::load[.] no rights |
в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies |
| !file.seek seek failed |
todo:сделать отдельный cookies |
| !image.format ^image::measure[index.html] not gif/jpg |
|
| !sql.connect ^connect[mysql://baduser:pass@host/db]{} not found/timeout |
системные типы ошибок: |
| !sql.execute ^void:sql{select bad} syntax error |
parser.compile ^test[} компиляция (непарная скобка, ...) |
| |
parser.runtime ^if(0). параметры (больше/меньше, чем нужно, не тех типов, ...) |
| |
number.zerodivision ^eval(1/0) ^eval(1%0) |
| |
number.format ^eval(abc*5) |
| |
file.lock shared/exclusive lock error |
| |
file.missing ^file:delete[delme] not found |
| |
file.access ^table::load[.] no rights |
| |
file.read ^file::load[...] error while reading file |
| |
file.seek seek failed |
| |
file.execute ^file::cgi[...] incorrect cgi header/can't execute |
| |
image.format ^image::measure[index.html] not gif/jpg |
| |
sql.connect ^connect[mysql://baduser:pass@host/db]{} not found/timeout |
| |
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 |
| |
|
| ! apache: CharsetDisable on |
если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение |
| |
об этом будет записано в parser3.log |
| |
|
| ! MAIN $ORIGINS(1) |
если описание метода содержит локальную переменную result в явном виде (есть и неявная переменная) |
| |
то код вывода пробельных литералов не попадает в конечный байт-код. |
![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to operators.ru.txt CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [parser3project] / parser3