|
version 1.119, 2003/10/30 13:16:53
|
version 1.249, 2017/02/08 19:14:51
|
|
Line 1
|
Line 1
|
| ! |
!сделано |
| X , , |
Xне сделано, видимо, не будет сделано |
| - |
без значка - будет сделано |
| |
|
| |
|
| |
операторы |
| !^eval()[] , :: |
!^eval(выражение)[формат] выражение, кроме обычных функций:: |
| ! # |
!допустимы #комментарии |
| |
работают до конца строки или закрывающейся круглой скобки |
| |
внутри комментария допустимы вложенные круглые скобки |
| ! : |
!из неочевидных операторов: |
| !| xor |
!| побитный xor |
| !|| xor |
!|| логический xor |
| ~ |
~ побитное отрицание |
| \ 10\3=3 |
\ целочисленное деление 10\3=3 |
| !def defined, |
!def для проверки defined, |
| defined |
пустая строка не defined |
| defined |
пустая таблица не defined |
| hash defined |
пустой hash не defined |
| ^if(method $hash.delete){yes} |
^if(method $hash.delete){yes} |
| !eq ne lt gt le ge , |
!eq ne lt gt le ge для сравнения строк, |
| !in "/dir/" |
!in "/dir/" для проверки |
| [" , , |
["внутри не допустимы, если надо сравнить со сложным, |
| ]. |
пусть это будет переменная]. |
| !is 'type' , |
!is 'type' для проверки типа левого операнда, |
| , , " hash ?" |
скажем, можно проверить, "не hash ли параметр метода?" |
| !-f , |
!-f для проверки существования файла на диске, |
| !-d , |
!-d для проверки существования каталога на диске, |
| ! | - , | |
!строка в кавычках|апострофах - строка, без кавычек|апострофов строка до |
| whitespace |
ближайшего whitespace |
| ! 0xABC |
!числовой литерал бывает 0xABC |
| !: |
!приоритеты: |
| /* logical */ |
/* logical */ |
| %left "!||" |
%left "!||" |
| %left "||" |
%left "||" |
|
Line 38 X , ,
|
Line 38 X , ,
|
| %left "==" "!=" "eq" "ne" |
%left "==" "!=" "eq" "ne" |
| %left "is" "def" "in" "-f" "-d" |
%left "is" "def" "in" "-f" "-d" |
| %left '!' |
%left '!' |
| ? : |
условие ? когдаДа: когдаНет |
| |
|
| /* bitwise */ |
/* bitwise */ |
| %left '!|' |
%left '!|' |
|
Line 50 X , ,
|
Line 50 X , ,
|
| %left '-' '+' |
%left '-' '+' |
| %left '*' '/' '%' '\\' |
%left '*' '/' '%' '\\' |
| %left NEG /* negation: unary - */ |
%left NEG /* negation: unary - */ |
| |
!литералы |
| |
true |
| |
false |
| |
|
| |
|
| !^if(){ }{ } |
!^if(условие){когда да}{когда нет} |
| !^switch[]{^case[1[;2...]]{}^case[DEFAULT]{ }} |
!^if(условие1){да}[(условие2){да}[(условие2){да}[...]]]{нет} -- количество доп. условий не ограничено (в общем elseif это :) |
| !^while(){} |
!^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}} |
| !^for[i](0;4){}[[]|{ }] |
!^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| !^use[] |
!^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
!^use[модуль] |
| !^try{ |
!^try{ |
| ... |
... |
| !^throw[sql.connect;;] // ^error[] |
!^throw[sql.connect[;вася[;болван]]] // был ^error[текст] |
| |
!^throw[ |
| |
$.type[sql.connect] |
| |
$.source[вася] |
| |
$.comment[болван] |
| |
] |
| ... |
... |
| }{ |
}{ |
| ^if($exception.type eq sql){ |
^if($exception.type eq "sql"){ |
| $exception.handled(1) ^rem{, exception } |
$exception.handled(1|true) ^rem{флаг, что exception обработан} |
| .... |
.... |
| } |
} |
| |
|
| ^switch($exception.type){ |
^switch[$exception.type]{ |
| ^case[sql;mail]{ |
^case[sql;mail]{ |
| $exception.handled(1) |
$exception.handled(1) |
| , sql |
код, обрабатывающий sql ошибку |
| $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[] + - . |
!^break[] + - обрывает цикл |
| 401 |
!^continue[] + - обрывает итерацию цикла |
| ^return[] + - , |
!^untaint[[as-is|file-spec|uri|http-header|mail-header|sql|js|json|parser-code|regex|xml|html|optimized-[as-is|xml|html]]]{код} |
| |
|
| ^break[] + - |
|
| ^continue[] + - |
|
| !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-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[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[ |
| !^process..[][ @main] |
$.main[во что переименовать @main] |
| , $self [ , $self=$MAIN:CLASS] |
$.file[имя файла из которого, якобы, данный текст] |
| !^connect[protocol:// ]]{ ^sql[...]-} |
$.lineno(номер строки в файле, откуда данный текст. можно отрицательный) |
| |
] |
| |
!^process..[путь][во что переименовать @main] |
| |
по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS] |
| |
!^connect[protocol://строка соединения]]{код с ^sql[...]-ями} |
| !mysql://user:pass@{host[:port]|[/unix/socket]}/database? |
!mysql://user:pass@{host[:port]|[/unix/socket]}/database? |
| charset=cp1251_koi8& |
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 |
| |
autocommit=1 |
| |
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& |
|
Line 117 X , ,
|
Line 131 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 |
!odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset |
| |
ClientCharset << charset in which parser thinks client works |
| |
|
| |
!sqlite://DBfile? |
| |
ClientCharset=parser-charset& << charset in which parser thinks client works |
| |
autocommit=1 |
| |
|
| connect , ( parser3) |
для работы connect нужно, чтобы заранее(рекомендуется в системном конфигурационном auto.p) |
| |
была определена таблица |
| #sql drivers |
#sql drivers |
| $SQL[ |
$SQL[ |
| $.drivers[^table::set{protocol driver client |
$.drivers[^table::create{protocol driver client |
| mysql /www/parser3/libparser3mysql.so /usr/local/lib/mysql/libmysqlclient.so |
mysql /www/parser3/libparser3mysql.so 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{} |
!^rem{} |
| !^cache[](){} |
!^cache[файл](секунд){код}[{catch код}] |
| ! |
!относительное задание времени |
| ! , '' |
!скэшировать строку, которая получается при выполнении кода на 'секунд' секунд |
| ! 0, , |
!если 0секунд, значит не кэшировать, а старый такой стереть |
| !^cache[][expires date]{} |
!в catch коде $exception.handled[cache] ^rem{флаг, что exception обработан} |
| ! |
!^cache[файл][expires date]{код}[{catch код}] |
| X^cache[] [ , ] // , , ^cache(0) |
!абсолютное задание времени |
| !^cache() |
!^cache[файл] удалить файл [не ругает, если его нет] |
| |
!^cache(секунд) |
| !^cache[expires date] |
!^cache[expires date] |
| ! ^cache " - ''/'expires'" |
!сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'" |
| ! : ^cache(0) |
!в пределе: ^cache(0) отменить кэширование |
| X^cache[read] |
!^cache[] выдаёт текущую expires date |
| ^cache " , expires", <br> |
|
| bool "/" |
!у всех методов есть локальная переменная $result, если в неё что положить, |
| |
!то _это_ будет результатом макроса, а не его тело |
| |
!у всех методов есть локальная переменная $caller, в ней лежит родительский stack frame, |
| X / " " |
!если туда записать |
| ! : ^untaint[html]{} |
|
| X |
!use(^use или @USE) ищет файл... |
| |
!1. ...если путь начинается с /, то считается, что это путь от корня веб пространства |
| ! $result, , |
!есть глобальная строка/таблица $MAIN:CLASS_PATH с путём/путями к каталогу с классами. |
| ! __ , |
!корень путя/путей считается от корня веб пространства. |
| ! $caller, stack frame, |
!2. ...относительно строчки из table $MAIN:CLASS_PATH, снизу вверх |
| ! |
задавайте её в конфигурационном auto.p вашего сайта |
| |
|
| !use(^use @USE) ... |
!глобальная табличка $CHARSETS[$.название[имя файла]] |
| !1. ... /, , |
!задаёт какие буквы считаются какими(whitespace, letter, etc), а также их unicode |
| ! / $MAIN:CLASS_PATH / . |
!формат: tab delimited файл, с заголовком: |
| ! / . |
|
| !2. ... table $MAIN:CLASS_PATH, |
|
| parser3.conf |
|
| |
|
| ! $CHARSETS[$.[ ]] |
|
| ! (whitespace, letter, etc), unicode |
|
| !: tab delimited , : |
|
| ! char white-space digit hex-digit letter word lowercase unicode1 unicode2 |
! char white-space digit hex-digit letter word lowercase unicode1 unicode2 |
| ! A x x x a 0x0041 0xFF21 |
! A x x x a 0x0041 0xFF21 |
| ! char lowercase , 0x |
! где char и lowercase могут быть буквами, а могут быть и 0xКОДАМИ |
| ! unicode , , |
! если символ имеет единственное unicode представление, равное самому символу, |
| ! unicode |
! можно не указывать unicode |
| ! UTF-8, |
!всегда есть кодировка UTF-8, |
| ! - request response |
!она является кодировкой по-умолчанию для request и response |
| !: case sensitive |
!ВНИМАНИЕ: имя кодировки case sensitive |
| |
|
| |
синтаксис |
| !$[ ] |
!$имя[новое значение] |
| !$( ) |
!$имя(математическое выражение нового значения) |
| !${ } |
!$имя{код нового значения} |
| !$ whitespace ${} |
!$имя whitespace или ${имя}неважно подстановка значения |
| !^ |
!^имя параметры вызов |
| !$.CLASS |
!$имя.CLASS класс значения |
| !$[$.key[] () {}] - $.key |
!$имя.CLASS_NAME имя класса |
| !^method[$.key[] () {}] - $parameter.key |
!$имя[$.key[] () {}] конструктор элемента переменной-хэша $имя.key |
| $CLASS. |
!^method[$.key[] () {}] конструктор элемента параметра-хеша $parameter.key |
| |
$CLASS.имя обращение к переменной класса |
| : tab linefeed ; ] } ) " < > + * / % & | = ! ' , ? {} |
|
| .. |
имя заканчивается перед: пробел tab linefeed ; ] } ) " < > + * / % & | = ! ' , ? {уточнить} |
| $,aaaa |
т.е. можно |
| , -, |
$имя,aaaa |
| ${}- |
но если нужно после имени букву, скажем -, то |
| + - |
${имя}- |
| ! : $name.subname |
в выражениях + и - являются дополнительными концами имени |
| ! subname : |
!можно обращаться к составным объектам так: $name.subname |
| ! |
!где subname бывает: |
| ! $ |
! строка |
| ! $ |
! $переменная |
| ! [, ] |
! строка$переменная |
| : $[$.(88)] $[$.[]] ^.[$.].format{%05d} |
! [код, вычисляющий строку] |
| |
например: $хэш[$.возраст(88)] $достать[$.поле[возраст]] ^хэш.[$достать.поле].format{%05d} |
| := |
|
| := |
параметры:=один или много параметров |
| !( ) , |
параметр:= |
| | ![] , |
!(математическое выражение) вычисляется много раз внутри вызова, |
| | !{} 0 , |
| ![код] вычисляется один раз перед вызовом, |
| ! ; - |
| !{код} вычисляется 0 или много раз внутри вызова, |
| |
!везде допустимы ; внутри - делает много параметров в одних скобках |
| |
|
| |
|
| !void |
!void |
| !^.length[] |
!доступны все методы, присутствующие у объекта класса string, результат как у пустой строки |
| 0 |
!^void:sql{запрос без результата}{$.bind[см. table::sql]} |
| !^.pos[...] |
|
| -1 |
|
| !^.int[] (default) |
|
| 0 default |
|
| !^.double[] (default) |
|
| 0 default |
|
| !^void:sql{ } |
|
| |
|
| !int,double |
!int,double |
| !^.int[] |
!^имя.int[] целочисленное значение |
| !^.double[]+ double |
!^имя.double[]+ double значение |
| !^.inc( +) |
!^имя.bool[] + .bool(true|false) bool значение |
| !^.dec( -) |
!^имя.inc(на сколько +) |
| !^.mul( *) |
!^имя.dec(на сколько -) |
| !^.div( /) |
!^имя.mul(на сколько *) |
| !^.mod( %) |
!^имя.div(на сколько /) |
| !^.format[] |
!^имя.mod(на сколько %) |
| !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0}]] |
!^имя.format[формат] |
| , / |
!^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]] |
| |
запрос, результат которого должен быть один столбец/одна строка |
| |
|
| !string |
!string |
| ! |
!в выражении |
| !def " ?" |
!def значение равно "не пуста?" |
| !/ double, |
!логическое/числовое значение равно попытке преобразовывания к double, |
| 0 |
пустая строка тихо преобразуется к 0 |
| |
|
| : |
пример: |
| ^if(def $form:name) ? |
^if(def $form:name) не пуста? |
| ^if($user.isAlive) ? [ , ?] |
^if($user.isAlive) истина? [автопреобразование к числу, не ноль?] |
| !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a}]] |
!^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]] |
| / |
результат запроса должен быть один столбец/одна строка |
| !^.int[] .int(default) . |
!^строка.int[] .int(default) целочисленное значение строки. |
| , default |
если ломается преобразование, берётся default |
| !^.double[]+ .double(default) double |
!^строка.double[]+ .double(default) double значение строки |
| , default |
!^строка.bool[] + .bool(default) bool значение строки |
| !^.format[] %d %.2f %02d... |
если ломается преобразование, берётся default |
| !^.match[][[ ]] $prematch $match $postmatch $1 $2... |
!^строка.format[формат] %d %.2f %02d... |
| = |
!^строка.match[шаблон-строка|шаблон-regex][[опции поиска]] $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 , |
!^строка.match[шаблон-строка|шаблон-regex][опции поиска]{замена} |
| !^.split[][[lrhv]] |
опции поиска+= |
| l [default] |
g заменить все вхождения, а не одно |
| r |
!^строка.split[разделитель][[lrhv]][[название столбца для вертикального разбиения]] |
| h nameless |
l слева направо [default] |
| v piece [default] |
r справа налево |
| !^.{l|r}split[] $piece |
h nameless таблица с ключами 0, 1, 2, ... |
| |
v таблица из 1 столбца 'piece' или как передадут [default] |
| !^.upper|lower[] |
!^строка.{l|r}split[разделитель] таблица из столбца $piece |
| X^.truncate( ) :( |
оставлен для совместимости |
| !^.length[] |
!^строка.upper|lower[] |
| !^.mid(P[;N]) |
!^строка.length[] |
| N - " " |
!^строка.mid(P[;N]) |
| !^.left(N) |
без N - "до конца строки" |
| !^.right(N) |
!^строка.left(N), -1 выдает всю строку |
| !^.pos[] |
!^строка.right(N) |
| <0 = |
!^строка.pos[подстрока] |
| !^.replace[$____] |
!^строка.pos[подстрока](позиция, с которой ищем) |
| !^.save[[append;]] |
<0 = не найдено |
| !^.normalize[] , |
!^строка.replace[$таблица_подстановок_строка_на_строку] |
| match , , |
!^строка.replace[$что;$на-что] |
| |
!^строка.save[[append;]путь] |
| |
!^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]] |
| |
!^строка.normalize[] выдает другую строку, в которой фрагменты на одном языке объединены |
| |
полезно делать перед сложными match операциями, если вы знаете, что входная строка |
| |
состоит из большого числа фрагментов |
| |
!^строка.trim[start|both|end|left|right[;chars]] выкидывает chars из начала/конца/и начала и конца |
| |
default 'chars' -- whitespace chars |
| |
!^строка.trim[chars] выкидывает chars из начала и конца |
| |
!^строка.base64[] encode |
| |
!^string:base64[encoded[;$.strict(true)]] decode |
| |
!^строка.idna[] IDNA кодирование, поддержка кириллических доменов |
| |
!^string:idna[encoded] IDNA декодирование, поддержка кириллических доменов |
| |
!^строка.js-escape[] кодирование для передачи в JS (%uXXXX) |
| |
!^string:js-unescape[escaped] декодирование переданного из js |
| |
!^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri |
| |
|
| !table |
!table |
| |
в выражении |
| " ?" |
логическое значение равно "не пуста?" |
| count[] |
числовое значение равно count[] |
| !^table::create[[nameless]]{} "set" |
!^table::create[[nameless]]{данные}[[$.separator[^#09]]] старое имя "set" |
| !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
!^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
| |
клонирует таблицу |
| reverse << ( locate, table::create ) |
reverse << сзаду на перёд (работает пока только в locate, в table::create НЕ работает) |
| !^table::load[[nameless;][;]] |
!^table::load[[nameless;]путь[;опции]] |
| ! nameless, |
!если не nameless, названия колонок берутся из первой строки |
| ! , '#', |
!пустые строки, и строки в первой колонке содержащие '#', игнорируются |
| !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]] |
!$.separator[^#09] |
| !^.save[[nameless|append;]] |
!$.encloser["] по-умолчанию, нет. |
| !$. |
!^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]] |
| !$.fields named Hash |
bind привязывает переменные в запросе к их значениям |
| !^.menu{}[] |
пока реализован только для oracle |
| !^.offset[[whence]](5) ; - offset |
в запросе надо написать ":имя" |
| |
в параметре bind передать hash, из которого возьмётся(или куда запишется) значение |
| |
!^таблица.save[[nameless|append;]путь[;опции, см. load]] |
| |
!$таблица.поле |
| |
!$таблица.поле[новое значение] |
| |
!$таблица.fields из named таблицы выдаёт текущую запись как Hash |
| |
!^таблица.menu{тело}[[разделитель]] |
| |
!^таблица.offset[] печатает offset |
| |
!^таблица.offset[[whence]](5) сдвигает |
| !whence=cur|set |
!whence=cur|set |
| ! whence - cur |
!без whence - это cur |
| !^.count[] |
!^таблица.count[], ^таблица.count[rows] - количество строк в таблице |
| !^.line[] 1-based offset |
!^таблица.count[columns] - количество столбцов таблицы |
| !^.sort{{ }|( )}[{desc|asc}] default=asc |
!^таблица.count[cells] - количество ячеек в текущей строке таблицы |
| !^.append{} |
!^таблица.line[] 1-based offset |
| X^.insert{}[(n)] |
!^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc |
| [ n] |
!^таблица.append{данные} |
| X^.remove(position[;count]) - |
!^таблица.append[ $.имя столбца[значение столбца] ] |
| [ ] |
!^таблица.insert{данные} добавить запись на текущую позицию |
| [ count ] |
!^таблица.insert[ $.имя столбца[значение столбца] ] |
| !^.join[][$.limit(1) $.offset(5) $.offset[cur]] - . |
!^таблица.delete[] - стирает запись с текущей позиции |
| . |
!^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]] - добавляет записи из таблицы. |
| !^.flip[] , - , |
таблицы должны иметь одинаковую структуру. |
| !^.locate[;][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]] |
!^таблица.flip[] выдаёт транспонированную, надо куда-то сложить, потом пользовать |
| , . bool |
!^таблица.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)]] |
| !^.hash{[]|{}|()}[[ |table ]][[$.distinct(1) $.distinct[tables]]] |
передвигает текущую строку, если найдёт. выдаёт bool |
| $hash. hash |
!^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]][[$.distinct(1) $.distinct[tables]]] |
| , , |
значением $hash.ключ будет hash в котором поля значений будут ключами |
| distinct true, |
поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой |
| distinct tables, hash , |
если distinct содержит true, то не будет ошибки при повторяющихся ключах |
| !^.columns[]+ $column |
если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом |
| !$[^.select()] = , |
!^таблица.columns[[название столбца]]+ таблица из одного столбца 'column' или как передадут |
| |
!$отобранное[^таблица.select(выражение)] = таблица из тех же столбцов и строк, у которых условие совпало |
| $adults[^man.select($man.age>=18)] |
$adults[^man.select($man.age>=18)] |
| ^.color[1;2] |
^таблица.color[цвет1;цвет2] |
| |
|
| |
|
| !hash |
!hash |
| ! |
!в выражении |
| ! " ?" |
!логическое значение равно "не пуста?" |
| ! _count[] |
!числовое значение равно _count[] |
| !$hash. |
!$хеш.ключ |
| !_default - , , |
!_default - специальный ключ, если задан, |
| , , _default |
то при обращении по ключу, которому нет соответствия, выдаётся _default значение |
| !$hash.fields $hash. hash table |
!$хеш.fields выдает $hash. чтобы класс hash был чуть больше похож на класс table |
| !^hash::create[[!copy_from_hash|Xcopy_from_hashfile]] |
!^hash::create[[!copy_from_hash|copy_from_hashfile]] |
| hash, |
создаёт новый hash, копию старого |
| !^hash.add[] |
!^хеш.add[слагаемое] |
| |
перезаписывает одноимённые |
| !^hash.sub[] |
!^хеш.sub[вычитаемое] |
| !^a.union[b] = |
!^хеш.union[b] = объединение |
| |
одноимённые остаются |
| !^a.intersection[b] = |
!^хеш.intersection[b] = пересечение |
| a |
значения хеш |
| !^a.intersects[b] = bool |
!^хеш.intersects[b] = bool |
| !^hash::sql{}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]] |
!^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]] |
| hash(= ) |
получается hash(ключи=значения первая колонка ответа) |
| of hash(= ) |
of hash(ключи=названия остальных колонкок ответа) |
| !^hash._keys[]+ $key |
!^хеш.keys[[название колонки с ключами]]+ таблица из одного столбца key или как передадут |
| !^hash._count[] |
!^хеш.count[] |
| !^foreach[key;value]{}[[]|{ }] |
!^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| !^delete[] |
!^хеш.delete[ключ] удалить ключ |
| |
!^хеш.contain[ключ] - существует ли в хеше ключ (bool) |
| |
!^хэш.at[first|last][[key|value|hash]] |
| |
!^хэш.at([-]N)[[key|value|hash]] |
| |
доступ к заданным элементам упорядоченного хеша |
| |
!^хэш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc |
| |
|
| |
!hashfile |
| |
!^hashfile::open[filename] |
| |
!^хешфайл.clear[] забыть всё |
| |
!$хешфайл.ключ[значение] положить значение |
| |
!$хешфайл.ключ[$.value[значение] $.expires[ЗНАЧЕНИЕ]} |
| |
положить значение до expires |
| |
значение поля expires может быть date, или число дней(0дней=на вечно) |
| |
!$хешфайл.ключ достать |
| |
!^хешфайл.delete[ключ] удалить ключ |
| |
!^хешфайл.delete[] удалить файлы, содержащие данные |
| |
!^хешфайл.hash[] |
| |
преобразовать в обычный hash |
| |
попутно стирает устаревшие пары |
| |
!^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}] |
| |
!^хешфайл.release[] |
| |
записать данные и снять блокировки. |
| |
при повторном обращении к элементам откроется автоматически. |
| |
!^хешфайл.cleanup[] пробежаться по всем элементам и удалить устаревшие. |
| |
|
| |
пример: |
| |
$sessions[^hashfile::open[/db/sessions]] |
| |
|
| |
$sid[^math:uuid[]] |
| |
$sessions.$sid[$.value[$uid] $.expires(1)] |
| |
$uid[$sessions.$sid] |
| |
|
| |
|
| !form |
!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:imap = 'x' 'y' |
!$form:files.поле = hash со значениями полей типа файл, ключи - 0, 1, ..., значение - файл |
| ?1,2 server-site image map |
!$form:imap = хэш с ключами 'x' и 'y' |
| |
со значением ?1,2 приписки при использовании server-site image map |
| |
|
| |
|
| !env |
!env |
| !$env: |
!$env:переменная |
| |
!$env:fields хэш с переменными окружения |
| |
!$env:PARSER_VERSION версия парсера |
| |
|
| |
|
| !cookie |
!cookie |
| !$cookie: |
!$cookie:имя считать старое или свежезаданное |
| !$cookie:[] 90 |
!$cookie:имя[значение] на 90 дней |
| !$cookie:[$.value[] $.expires ] |
!$cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true)] |
| ! expires 'session', date, (0=session) |
!значение поля expires может быть 'session', date, или число дней(0дней=session) |
| ! , "Sun, 25-Aug-2002 12:03:45 GMT" |
! если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT" |
| |
! можно устанавливать bool свойства, например $.secure(true), $.httponly(true) |
| |
!$cookie:fields = hash со всеми cookies |
| |
|
| |
|
| !request |
!request |
| !$request:query |
!$request:query |
| !$request:body unprocessed POST request body |
|
| !$request:uri |
!$request:uri |
| X!$request:browser hash, : |
!$request:document-root |
| !$type = ie/nn !$version = , 5.5 |
каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT |
| X$request:user |
можно изменить, если на hosting что-то неудобно настроено |
| X$request:password |
!$request:argv = hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла]. |
| !$request:charset |
!$request:charset |
| |
Кодировка исходного документа |
| ! upper/lower match[][i] |
!используется при upper/lower и match[][i] |
| : form auto MAIN |
ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN |
| $request/response:charset . . |
поэтому необходимо задать $request/response:charset в одном из них. не после. |
| |
!$request:method метод запроса (GET|POST|PUT) |
| |
!$request:body тело POST-запроса в виде текста |
| |
!$request:body-file тело POST-запроса в виде файла |
| |
!$request:body-charset кодировка POST-запроса |
| |
!$request:headers хэш с заголовками запроса (без префикса HTTP_) |
| |
|
| |
|
| !response |
!response |
| !$response:[] -- $response: |
!$response:поле[значение] и можно считать старое -- $response:поле |
| ! 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:body[DATA] |
!$response:headers накопленные поля |
| !$response:download[DATA] , |
!$response:body[DATA] замещает стандартный ответ |
| , browser download |
!$response:download[DATA] замещает стандартный ответ, |
| |
выставляет флаг, заставляющий 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 |
ПРЕДУПРЕЖДЕНИЕ: класс form получает свои поля после обработки всех auto класса MAIN |
| $request/response:charset . . |
поэтому необходимо задать $request/response:charset в одном из них. не после. |
| |
|
| Xhashfile |
|
| !^hashfile::open[$DB_HOME;filename] |
!regex |
| !^hashfile.clear[] |
!в выражении |
| |
!логическое значение всегда равно true |
| !.[] |
!числовое значение равно количеству байт скомпилированного шаблона. |
| !.[$.value[] $.expires()} expires |
!^regex::create[шаблон-строка][[опции поиска]] |
| !. |
!^шаблон.size[] количество байт скомпилированного шаблона |
| !^cache[](){} |
если значение очень большое -- стоит почитать документацию по pcre и, возможно, переписать шаблон. |
| ! , "+", |
!^шаблон.study_size[] размер study-структуры. если==0 -- шаблон не может быть "изучен" |
| ! 0, , |
|
| ! {} ^delete[] |
|
| !^delete[[]] |
!reflection |
| ! cache, : |
!^reflection:create[класс;конструктор[;пара;[мет[;ры]]]] вызывает указанный конструктор класса (не более 100 параметров) |
| ! , |
!^reflection:classes[] хеш со всеми классами. ключ -- имя класса, значение бывает methoded (класс с методами) или void |
| !^hash[] |
!^reflection:class[объект] класс переданного объекта |
| hash |
!^reflection:class_name[объект] имя класса переданного объекта |
| !^foreach[key|value]{}[[]|{ }] |
!^reflection:base[объект] родительский класс переданного объекта |
| |
!^reflection:base_name[объект] имя родительского класса переданного объекта |
| |
!^reflection:class_by_name[имя класса] получение класса по имени |
| : |
!^reflection:def[class;имя класса] проверка класса на существование |
| $uids[^hashfile::assign[/db/uids]] |
!^reflection:methods[класс] хеш со списком методов указанного класса, значения -- строки 'native' или 'parser' |
| $code:clear[/db/cache]] |
!^reflection:method[класс или объект;имя метода] возвращает junction-method класса или объекта |
| $code[^hashfile::assign[/db/cache]] |
!^reflection:fields[класс или объект] хеш со списком статических полей указанного класса или динамических полей указанного объекта |
| |
!^reflection:field[класс или объект;имя поля] возвращает значение указанного поля класса или объекта. getter-ы игнорируются. |
| $random[23847387taduigh345XGHWElxjgdjg] |
!^reflection:uid[класс или объект] возвращает идентификатор объекта или класса |
| $uids.$random[$.value[$uid] $.expires(60*30)] |
!^reflection:method_info[класс;метод] хеш с параметрами указанного метода класса |
| $uid[$persistent.logins.$random] |
$.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, позволяющий определить, является ли элемент кодом. |
| |
|
| ^code.cache[ ](35){....} |
|
| |
|
| !mail |
!mail |
| !$mail.received=MESSAGE: |
!$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[ |
| $.charset[ ] |
$.options[-odd] |
| |
unix: строка, которая будет добавлена к команде запуска sendmail |
| |
-odd означает "быстро поставь в очередь без проверки email" |
| |
win32: игнорируется |
| |
$.charset[кодировка заголовка и текстовых блоков] |
| $.any-header-field |
$.any-header-field |
| $.text[string] |
$.text[string] |
| $.text[ |
$.text[ |
|
Line 501 Xhashfile
|
Line 597 Xhashfile
|
| $value[FILE] |
$value[FILE] |
| ] |
] |
| ] |
] |
| ! charset , charset |
!если charset указан, письмо перекодируется в этот charset |
| !content-type.charset |
!content-type.charset не влияет на перекодирование |
| ! # |
!после имени части может идти # число |
| ^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[ |
| |
слова |
| ] |
] |
| ] |
] |
| !:send[$.header-field[] $.charset[ ] $.body[ body , |
!:send[$.header-field[] $.charset[кодировка письма] $.body[когда body не строка, |
| hash, multipart ]] |
а hash, отсылается multipart письмо]] |
| ! charset , charset |
!если charset указан, письмо перекодируется в этот charset |
| !content-type.charset |
!content-type.charset не влияет на перекодирование |
| ! , . |
!после имени части может идти целое число, части пойдут в порядке чисел. |
| ! body , , . |
!если body указан строкой, то это текст письма, никаких вложений. |
| ! body hash, , , |
!если body указан hash, то это части, будут собраны текстовые блоки, затем вложения |
| ! , |
!это старый формат, поддерживается для обратной совместимости |
| ! text, . |
!если имя части начинается со слова text, то это текстовый блок. |
| ! attach, , :: |
!если имя части начинается со слова file, то это вложение, формат задания:: |
| !$attach[$.format[!uue|Xbase64] $.value[DATA] $.file-name[user-file-name]] |
!$file[$.format[!uue|!base64] $.value[DATA] $.name[user-file-name]] |
| !: multipart content-type |
!важно: при multipart не указывать content-type |
| ^mail:send[ |
^mail:send[ |
| # -, source encoding. |
# по-умолчанию, совпадает с source encoding. |
| # 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/sbin/sendmail или |
| /usr/lib/sendmail |
/usr/lib/sendmail |
| , , "-t". |
и, если доступна, то запускается с параметром "-t". |
| win32 SMTP , |
под win32 используется SMTP протокол, сервер задаётся |
| $MAIL.SMTP[smtp.domain.ru] |
$MAIL.SMTP[smtp.domain.ru] |
| |
|
| !image |
!image |
| !$[^image::measure[DATA]] |
!$картинка[^image::measure[DATA]] |
| .ext case insensitive, |
смотрит на .ext case insensitive, |
| .gif .jpg .jpeg |
умеет мерить пока только .gif и .jpg .jpeg |
| !$image.exif << hash measure jpeg exif |
!$картинка.exif << hash после measure jpeg с exif информацией |
| !$image.exif.DateTime & co |
!$image.exif.DateTime & co |
| [ . http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] |
[полный список см. http://www.ba.wakwak.com/~tsuruzoh/Computer/Digicams/exif-e.html] |
| ! int/double, |
!числа типа int/double, |
| ! 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 |
| !^.text(x;y)[_] AS_IS |
!^картинка.font[набор_букв;имя_файла_шрифта.gif; |
| !^.length[_] AS_IS |
$.space(ширина_пробела) // по умолчанию = ширине gif |
| !^.gif[] -- FILE content-type=image/gif |
$.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 не годится. |
| |
при не указанном dest_h сохраняет aspect ratio |
| |
tolerance - некое число[квадрат расстояния в RGB пространстве до искомого цвета], |
| |
определяющее прожорливость выделялки цветов из палитры [default=150] |
| |
меньше - точнее приближает цвета, но они быстро кончаются |
| |
больше - неточно приближает цвет, но бОльшей части хватит |
| |
!^картинка.pixel(x;y)[(color)] |
| |
узнать или задать цвет пиксела |
| |
|
| |
|
| !file |
!file |
| !$__post.name |
!$файл_из_post.name |
| !$__post.size |
!$файл_из_post.size |
| !$t_post.text |
!$файлtиз_post.text |
| !^.save[text|binary; ] |
!^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем]]] |
| !^file:delete[ ] |
!^file:delete[имя файла] |
| !^file:find[ ][{ }] |
!^file:find[имя файла][{когда не нашли}] |
| !^file:list[[;]] = table name |
!^file:list[путь[;шаблон-строка|шаблон-regex]] = table с колонками name dir |
| !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;]] |
!^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)] = table с колонками name dir size [mca]date |
| !$___loaded.size |
!^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;опции]] |
| !^file::stat[ ] |
!^file::create[text|binary;имя;data] |
| !$___stated.size !.adate !.mdate !.cdate |
!^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]] |
| !^file::cgi[ [;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]] |
!^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[имя файла;имя копии файла] |
| |
можно копировать только файлы |
| |
!^file:lock[имя файла]{код} |
| |
файл при необходимости создаётся |
| |
блокируется |
| Xchmod[...] , executable , ftp chmod. |
выполняется код |
| !^file:dirname[/a/some.tar.gz]=/a |
разблокируется |
| !^file:dirname[/a/b/]=/a |
Xchmod[...] НЕТ И НЕ БУДЕТ, ЧТОБЫ НЕ МОГЛИ СДЕЛАТЬ executable и запустить, даже если ftp запрещает chmod. |
| !^file:basename[/a/some.tar.gz]=some.tar.gz |
!^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix) |
| |
!^file:dirname[/a/b/]=/a (работает аналогично комманде *nix) |
| |
!^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix) |
| |
!^file:basename[/a/b/]=b (работает аналогично комманде *nix) |
| !^file:justname[/a/some.tar.gz]=some.tar |
!^file:justname[/a/some.tar.gz]=some.tar |
| !^file:justext[/a/some.tar.gz]=gz |
!^file:justext[/a/some.tar.gz]=gz |
| !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif |
!/some/page.html: ^file:fullpath[a.gif] => /some/a.gif |
| |
!^файл.sql-string[] внутри ^connect даст правильно escaped строку, которую можно в запрос отдать |
| |
!^file::sql{query}[[ |
| |
$.name[имя_файла_для_download] |
| |
$.content-type[пользовательский content-type] |
| |
]] |
| |
результат запроса должен быть "одна строка". |
| |
колонки: |
| |
первая колонка - данные |
| |
если есть вторая - это имя файла |
| |
если есть третья - это content-type |
| |
!^файл.base64[] encode |
| |
!^file:base64[имя файла] |
| |
encode |
| |
!^file::base64[encoded string] |
| |
!^file::base64[mode;имя файла;encoded string[;$.content-type[...]]] |
| |
decode |
| |
!^file:crc32[имя файла] |
| |
вычисляет crc32 файла с указанным именем |
| |
!^файл.crc32[] |
| |
вычисляет crc32 объекта |
| |
!^файл.md5[] |
| |
!^file:md5[имя файла] |
| |
выдает digest файла, длиной 16 байт в виде строки, |
| |
где байты digest выданы в hex виде, впритык, в нижнем регистре |
| |
|
| |
|
| !math |
!math |
|
Line 666 Xhashfile
|
Line 804 Xhashfile
|
| !^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:uuid[] |
| 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[] |
| 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] |
| |
вычисляет crc32 строки |
| |
!^math:sha1[string] |
| |
!^math:convert[number](base-from;base-to) преобразует строку с числом из одной системы исчисления в другую |
| |
!^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64] $.hmac[ключ] ]] |
| |
объединяет в себе возможность работы с разными алгоритмами криптографического хеширования. |
| |
$.hmac[ключ] для проверки целостности переданных данных |
| |
|
| |
|
| |
!inet |
| |
!^inet:ntoa(long) |
| |
!^inet:aton[IP] |
| |
!^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прямое преобразование имени в IP адрес |
| |
!^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреса в имя |
| |
|
| |
|
| |
!json |
| |
!^json:parse[-json-строка-[; |
| |
$.depth(максимальная глубина, default == 19) |
| |
$.double(false) отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен) |
| |
в этом случае они попадут в результирующий объект как строки |
| |
$.int(false) отключить встроенный парсинг целых чисел (по умолчанию включен) |
| |
в этом случае они попадут в результирующий объект как строки |
| |
$.distinct[first|last|all] как будет происходить разбор дублирующихся ключей у объектов |
| |
first -- будет оставлен первый встретившийся элемент |
| |
last -- будет оставлен последний встретившийся элемент |
| |
all -- будут оставлены все элементы. при этом элементы, начиная со 2 |
| |
получат числовые суффиксы (key_2 итд) |
| |
по умолчанию дублирующиеся ключи приведут к exception |
| |
$.object[method-junction] пользовательский метод[ключ;объект], которому будут передаваться все разобранные |
| |
объекты и ключи объекта, метод возвращает новый объект |
| |
$.array[method-junction] пользовательский метод, которому будут передаваться массивы |
| |
]] |
| |
парсит json-строку в хэш |
| |
!^json:string[system or user object[; |
| |
$.skip-unknown(false) отключить exception и выдавать 'null' при сериализации объектов с типами |
| |
отличных от void, bool, string, int, double, date, table, hash и file |
| |
$.indent(true) форматировать результирующую строку табуляциями по глубине вложенности |
| |
$.date[sql-string|gmt-string|iso-string|unix-timestamp] формат вывода даты, по умолчанию -- sql-string |
| |
$.table[object|array|compact] формат вывода таблицы, по умолчанию -- object |
| |
object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...] |
| |
array: [["c1","c2",...] || null (for nameless),["v11","v12",...],...] |
| |
compact: ["v11" || ["v11","v12",...],...] |
| |
$.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла |
| |
не попадает в output) |
| |
$.xdoc[hash] параметры преобразования xdoc в строку (как в ^xdoc.string[]) |
| |
$.тип[method-junction] любой тип можно вывести с помощью пользовательского метода, который |
| |
должен принимать 3 параметра: ключ, объект данного типа и опции |
| |
вызова ^json:string[] |
| |
$._default[имя метода] имя пользователького метода, при его наличии он будет вызван для |
| |
сериализации |
| |
$.void[null|string] неопределенное значение будет выдано в виде null (по умолчанию) |
| |
или пустой строки |
| |
]] |
| |
сериализует системный или пользовательский объект в json-строку |
| |
|
| |
|
| !date |
!date |
| ! time , |
!время типа time можно использовать в выражениях, подставляет |
| epoch [1 1970 (UTC)], |
количество дней с epoch [1 января 1970 (UTC)], дробное |
| ! localtime, |
!строковое значение в местном времени, численное в UTC |
| ! parser OS |
!по умолчанию используется установленная средствами OS временная зона |
| $date:UTC-offset , local |
|
| $date:TZ , , (- ) |
|
| !^date::now[] |
!^date::now[] |
| !^date::now( ) + |
!^date::now(смещение в днях) выдаёт сейчас+смещение |
| !^date::create( epoch) // set |
!^date::today[] дата на 00:00:00 текущего дня |
| !^date::create(year;month[;day[;hour[;minute[;second]]]]) // set |
!^date::create(дней с epoch) |
| !^date::create[ %Y-%m-%d %H:%M:%S] |
!^date::create(year;month[;day[;hour[;minute[;second]]]]) |
| |
!^date::create[дата в формате %Y-%m-%d %H:%M:%S] |
| 1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] |
для удобного создания по значению из базы |
| 2: %H:%M[:%S] |
формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]] |
| !$date.year month day hour minute second weekday yearday(0...) daylightsaving TZ |
формат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 |
| read-only |
read-only |
| TZ="" << |
TZ="" << локальная зона |
| !^date.roll[year|month|day](+-) |
!^дата.roll[year|month|day](+-смещение) сдвигает дату |
| !^date.roll[TZ; ] , - : .hour&co |
!^дата.roll[TZ;Новая зона] говорит, что дата в таком-то часовом поясе: влияет на .hour & Co |
| !^date.sql-string[] %Y-%m-%d %H:%M:%S |
!^date:roll[TZ;Новая зона] говорит, что по умолчанию все даты в таком-то часовом поясе |
| where published='$.sql-string[]' |
!^дата.sql-string[[datetime|date|time]] |
| !^date:calendar[rus|eng;;] |
datetime или без параметра -- %Y-%m-%d %H:%M:%S |
| : 0..6, week, weekyear |
date -- %Y-%m-%d |
| !^date:calendar[rus|eng;;;] |
time -- %H:%M:%S |
| : year, month, day, weekday |
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+3 |
| |
|
| |
|
| 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 |
Xreadonly attribute DOMImplementation implementation |
|
Line 736 xdoc(xnode)
|
Line 945 xdoc(xnode)
|
| 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 |
X| qname-but-not-ncname |
|
Line 755 xdoc(xnode)
|
Line 967 xdoc(xnode)
|
| !encoding = string |
!encoding = string |
| !omit-xml-declaration = "yes" | "no" |
!omit-xml-declaration = "yes" | "no" |
| !standalone = "yes" | "no" |
!standalone = "yes" | "no" |
| X[, xsltSaveResultTo ]doctype-public = string |
X[передал, но xsltSaveResultTo не использовал его]doctype-public = string |
| X "-//W3C//DTD XHTML" XHTML |
Xесли начинается с "-//W3C//DTD XHTML" то будет выводить XHTML |
| X[, xsltSaveResultTo ]doctype-system = string |
X[передал, но xsltSaveResultTo не использовал его]doctype-system = string |
| !cdata-section-elements = qnames |
!cdata-section-elements = qnames |
| !indent = "yes" | "no" |
!indent = "yes" | "no" |
| !media-type = string /> |
!media-type = string /> |
| ! , xpath |
!параметры передаются как есть, не xpath выражения |
| |
|
| !.string[[output options]] |
!.string[[output options]] |
| !.save[file.xml[;output options]] |
!.save[file.xml[;output options]] с шапкой |
| !.file[[output options]] = file |
!.file[[output options]] = file |
| output options xsl:output |
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] |
| |
[примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было] |
| |
|
| !xnode |
!xnode |
| DOM1 attributes: |
DOM1 attributes: |
| !$node.nodeName |
!$node.nodeName |
| !$node.nodeValue |
!$node.nodeValue |
| |
!read |
| |
!write |
| !$node.nodeType = int |
!$node.nodeType = int |
| ELEMENT_NODE = 1 |
ELEMENT_NODE = 1 |
| ATTRIBUTE_NODE = 2 |
ATTRIBUTE_NODE = 2 |
|
Line 796 xdoc(xnode)
|
Line 1015 xdoc(xnode)
|
| !$node.previousSibling |
!$node.previousSibling |
| !$node.nextSibling |
!$node.nextSibling |
| !$node.ownerDocument = xdoc |
!$node.ownerDocument = xdoc |
| |
!$node.prefix |
| |
!$node.namespaceURI |
| !$element_node.attributes = hash of xnodes |
!$element_node.attributes = hash of xnodes |
| !$element_node.tagName |
!$element_node.tagName |
| !$attribute_node.specified = boolean |
!$attribute_node.specified = boolean |
|
Line 844 xdoc(xnode)
|
Line 1065 xdoc(xnode)
|
| |
|
| !Introduced in DOM Level 2: |
!Introduced in DOM Level 2: |
| !Node importNode(in Node importedNode, in boolean deep) raises(DOMException) |
!Node importNode(in Node importedNode, in boolean deep) raises(DOMException) |
| !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName); |
!NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName) |
| |
!boolean hasAttributes() |
| |
|
| !XPath: |
!XPath: |
| !^node.select[xpath/query/expression] = array of nodes, |
!^node.select[xpath/query/expression] = array of nodes, |
|
Line 854 xdoc(xnode)
|
Line 1076 xdoc(xnode)
|
| !^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( ): |
!error codes(пока придут как текст в случае соответствующих ошибок): |
| INDEX_SIZE_ERR |
INDEX_SIZE_ERR |
| If index or size is negative, or greater |
If index or size is negative, or greater |
| than the allowed value |
than the allowed value |
|
Line 891 xdoc(xnode)
|
Line 1113 xdoc(xnode)
|
| elsewhere |
elsewhere |
| |
|
| !memory |
!memory |
| !^memory:compact[] , |
!^memory:compact[] собрать мусор, освободив место под новые данные |
| (: ) |
(предупреждение: память процесса никогда не освобождается) |
| XSL transform. |
полезно делать перед XSL transform. |
| |
|
| !status |
!status |
| ! , apache |
!чтобы класс был доступен, в apache нужно сказать |
| <Location /parser-status.html> |
<Location /parser-status.html> |
| ParserStatusAllowed |
ParserStatusAllowed |
| </Location> |
</Location> |
| ! cgi |
!в cgi доступен везде |
| ! isapi |
!в isapi не доступен нигде |
| |
|
| !$status:sql hash |
!$status:sql hash |
| !cache table |
!cache table |
|
Line 913 xdoc(xnode)
|
Line 1135 xdoc(xnode)
|
| file time |
file time |
| file time |
file time |
| file time |
file time |
| !$status:charset hash |
|
| !cache table |
|
| file |
|
| file |
|
| file |
|
| |
|
| !$status:rusage hash |
!$status:rusage hash |
| !utime user time used |
!utime user time used |
|
Line 933 xdoc(xnode)
|
Line 1150 xdoc(xnode)
|
| |
|
| !$status:memory hash |
!$status:memory hash |
| !used |
!used |
| Includes some pages that were allocated but never written. |
Includes some pages that were allocated but never written. |
| |
|
| !free |
!free |
| |
|
|
Line 941 xdoc(xnode)
|
Line 1158 xdoc(xnode)
|
| Return the number of bytes allocated since the last collection. |
Return the number of bytes allocated since the last collection. |
| |
|
| !ever_allocated_since_start |
!ever_allocated_since_start |
| Return the total number of bytes [EVER(c)PAF] allocated in this process. |
Return the total number of bytes [EVER(c)PAF] allocated in this process. |
| Never decreases. |
Never decreases. |
| |
|
| |
!$status:pid process id |
| |
!$status:tid thread id |
| |
|
| !DATA::=string | file |
console |
| |
$console:timeout |
| |
!$console:line |
| |
read/write строку |
| |
|
| |
DATA::=string | file | hash |
| |
|
| |
!hash вида |
| |
[ |
| |
$.file[имя файла на диске] |
| |
$.name[имя файла для пользователя] |
| |
$.mdate[date] |
| |
] |
| |
|
| !MAIN |
!MAIN |
| , parser3.conf, |
это класс, загружаемый на автомате из конфигурационного auto.p, |
| auto.p : |
кучи auto.p и запрашиваемого документа: |
| !parser3.conf |
!конфигурационный auto.p |
| cgi: |
cgi: |
| 1. CGI_PARSER_SITE_CONFIG |
1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG |
| parser' |
или рядом с бинарником parser'а |
| 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.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 |
!http://domain/document[?params<<deprecated, use $.form[...]] |
| ! , , : |
!а также, возможно, указать опции: |
| !$.method[GET|HEAD] |
!$.method[GET|POST|HEAD] |
| !$.timeout(3) << , - =2 |
!$.timeout(3) << в секундах, по-умолчанию =2 |
| |
!$.cookies[ |
| |
$.имя[значение] |
| |
] |
| !$.headers[ |
!$.headers[ |
| ! $[] << , $response: |
! $.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК |
| !] |
!] |
| !-, user-agent=parser3 |
$.enctype[multipart/form-data] |
| !-, http status != 200 >> http.status , |
$.form[ |
| ! , |
!$.field1[string] |
| |
!$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}] |
| |
$.field3[file] |
| |
] |
| |
!$.body[string] |
| |
|file |
| |
!по-умолчанию, user-agent=parser3 |
| |
!по-умолчанию, получение http status != 200 >> создает http.status ошибку, |
| |
!это можно отключить, передав |
| !$.any-status(1) |
!$.any-status(1) |
| !$.charset[ -] << content-type:charset=_ |
!$.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА_ПЕРЕБИВАЕТ |
| !file::load |
!$.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset |
| !: ( ) |
!$.user[пользователь] |
| !tables << ->table "value". |
!$.password[пароль] |
| . , set-cookies |
!file::load в дополнительные поля записывает |
| todo: cookies |
!ПОЛЕ:значение (имена полей ответа заглавными буквами) |
| |
!tables << хеш их ПОЛЕ->table с единственным столбцом "value". |
| ! : |
в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies |
| !parser.compile ^test[} ( , ...) |
todo:сделать отдельный cookies |
| !parser.runtime ^if(0). (/, , , ...) |
|
| |
!системные типы ошибок: |
| |
!parser.compile ^test[} компиляция (непарная скобка, ...) |
| |
!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.seek seek failed |
!file.seek seek failed |
| |
!file.execute ^file::cgi[...] incorrect cgi header/can't execute |
| !image.format ^image::measure[index.html] not gif/jpg |
!image.format ^image::measure[index.html] not gif/jpg |
| !sql.connect ^connect[mysql://baduser:pass@host/db]{} not found/timeout |
!sql.connect ^connect[mysql://baduser:pass@host/db]{} not found/timeout |
| !sql.execute ^void:sql{select bad} syntax error |
!sql.execute ^void:sql{select bad} syntax error |
|
Line 1021 xdoc(xnode)
|
Line 1268 xdoc(xnode)
|
| !http.timeout ^file::load[http://host/doc] whole load operation failed to complete in # seconds |
!http.timeout ^file::load[http://host/doc] whole load operation failed to complete in # seconds |
| !http.response ^file::load[http://ok/there] host found, connection accepted, bad answer |
!http.response ^file::load[http://ok/there] host found, connection accepted, bad answer |
| !http.status ^file::load[http://ok/there] host found, connection accepted, status!=200 |
!http.status ^file::load[http://ok/there] host found, connection accepted, status!=200 |
| |
!date.range ^date::create(1950;1;1) date out of valid range |
| ! apache: CharsetDisable on |
|
| |
!если в MAIN определён $SIGPIPE(1) то в случае, если обработка была прервана пользователем, сообщение |
| |
об этом будет записано в parser3.log (раньше оно всегда писалось) |
| |
|
| |
!если описание метода содержит локальную переменную result в явном виде |
| |
(есть и неявная переменная) |
| |
то код вывода строковых литералов не попадает в конечный байт-код, |
| |
а непробельные символы считаются синтаксической ошибкой |
| |
для вывода чего бы то ни было надо пользоваться этой переменной |
| |
|
| ! MAIN $ORIGINS(1) |
|
| |
|