Diff for /parser3/operators.ru.txt between versions 1.236 and 1.255

version 1.236, 2010/11/25 14:12:52 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              true
            false              false
   
                  ^if(уÑ�ловие){когда да}{когда нет}
     !^if(óñëîâèå){êîãäà äà}{êîãäà íåò}      ^if(уÑ�ловие1){да}[(уÑ�ловие2){да}[(уÑ�ловие2){да}[...]]]{нет} -- количеÑ�тво доп. уÑ�ловий не ограничено (в общем elseif Ñ�то :)
     !^if(óñëîâèå1){äà}[(óñëîâèå2){äà}[(óñëîâèå2){äà}[...]]]{íåò} -- êîëè÷åñòâî äîï. óñëîâèé íå îãðàíè÷åíî (â îáùåì elseif ýòî :)  
     !^switch[çíà÷åíèå]{^case[âàðèàíò1[;âàðèàíò2...]]{äåéñòâèå}^case[DEFAULT]{äåéñòâèå ïî óìîë÷àíèþ}}      ^switch[значение]{^case[вариант1[;вариант2...]]{дейÑ�твие}^case[DEFAULT]{дейÑ�твие по умолчанию}}
     !^while(óñëîâèå){òåëî}[[ðàçäåëèòåëü]|{ðàçäåëèòåëü êîòîðûé âûïîëíÿåòñÿ ïåðåä íåïóñòûì î÷åðåäíûì íå ïåðâûì òåëîì}]  
     !^for[i](0;4){òåëî}[[ðàçäåëèòåëü]|{ðàçäåëèòåëü êîòîðûé âûïîëíÿåòñÿ ïåðåä íåïóñòûì î÷åðåäíûì íå ïåðâûì òåëîì}]      ^while(уÑ�ловие){тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
     !^use[ìîäóëü]  
     !^try{      ^for[i](0;4){тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
   
       ^try{
         ...          ...
         !^throw[sql.connect[;âàñÿ[;áîëâàí]]] // áûë ^error[òåêñò]          ^throw[sql.connect[;ваÑ�Ñ�[;болван]]] // был ^error[текÑ�Ñ‚]
         !^throw[          ^throw[
                 $.type[sql.connect]              $.type[sql.connect]
                 $.source[âàñÿ]              $.source[ваÑ�Ñ�]
                 $.comment[áîëâàí]              $.comment[болван]
         ]          ]
         ...          ...
     }{      }{
         ^if($exception.type eq "sql"){          ^if($exception.type eq "sql"){
             $exception.handled(1|true)  ^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.colno [åñëè íå çàïðåùåíû ïðè êîìïèëÿöèè]                  $exception.file $exception.lineno $exception.colno [еÑ�ли не запрещены при компилÑ�ции]
                 $exception.source = âàñÿ                  $exception.source = ваÑ�Ñ�
                 $exception.comment = áîëâàí                  $exception.comment = болван
             }              }
             ^case[DEFAULT]{              ^case[DEFAULT]{
                 êîä, îáðàáàòûâàþùèé äðóãóþ îøèáêó                  код, обрабатывающий другую ошибку
                 ^throw[$exception] << re-throw // DON'T! It's default behaviour!                  ^throw[$exception] << re-throw // DON'T! It's default behaviour!
             }              }
         }          }
     }      }
     ^exit[] + - ïðåêðàùÿåò îáðàáîòêó çàïðîñà.   
         óäîáíî ñäåëàòü ïîñëå âûñòàâëåíèÿ 401 îøèáêè      ^break[] - обрывает цикл
     ^return[ðåçóëüòàò] + - îòâàëèâàåò èç âûïîëíåíèÿ ìåòîäà,       ^break(true|false) - обрывает цикл, еÑ�ли true
         âûäàâàÿ íåñòàíäàðòíûé ðåçóëüòàò  
     !^break[] + - îáðûâàåò öèêë      ^continue[] - обрывает итерацию цикла
     !^continue[] + - îáðûâàåò èòåðàöèþ öèêëà      ^continue(true|false) - обрывает итерацию цикла, еÑ�ли true
     !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html|regex|parser-code]]{êîä}  
       ^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[âî ÷òî ïåðåèìåíîâàòü @main]      ^apply-taint[[lang;]текÑ�Ñ‚]
         $.file[èìÿ ôàéëà èç êîòîðîãî, ÿêîáû, äàííûé òåêñò]          выполнÑ�ет заданные в Ñ�троке преобразованиÑ�, неопределенно грÑ�зное как lang, на выходе чиÑ�таÑ� Ñ�трока
         $.lineno(íîìåð ñòðîêè â ôàéëå, îòêóäà äàííûé òåêñò. ìîæíî îòðèöàòåëüíûé)   
       ^process[[$caller.CLASS|$object|$КЛÐ�СС:CLASS]]{Ñ�трока, котораÑ� будет process-ed, как код}[
           $.main[во что переименовать @main]
           $.file[имÑ� файла из которого, Ñ�кобы, данный текÑ�Ñ‚]
           $.lineno(номер Ñ�троки в файле, откуда данный текÑ�Ñ‚. можно отрицательный) 
     ]      ]
     !^process..[ïóòü][âî ÷òî ïåðåèìåíîâàòü @main]      ^process..[путь][во что переименовать @main]
       ïî óìîë÷àíèþ, ìåòîäû êîìïèëèðóþòñÿ â $self [â ñëó÷àå îïåðàòîðà, $self=$MAIN:CLASS]          по умолчанию, методы компилируютÑ�Ñ� в $self [в Ñ�лучае оператора, $self=$MAIN:CLASS]
     !^connect[protocol://ñòðîêà ñîåäèíåíèÿ]]{êîä ñ ^sql[...]-ÿìè}  
         !mysql://user:pass@{host[:port]|[/unix/socket]}/database?      ^connect[protocol://Ñ�трока Ñ�оединениÑ�]]{код Ñ� ^sql[...]-Ñ�ми}
           mysql://user:pass@{host[:port][, host[:port]]|[/unix/socket]}/database?
             ClientCharset=parser-charset << charset in which parser thinks client works              ClientCharset=parser-charset << charset in which parser thinks client works
             charset=cp1251_koi8&              charset=UTF-8&
             timeout=3&              timeout=3&
             compress=0&              compress=0&
             named_pipe=1&              named_pipe=1&
             multi_statements=1& allow execute more then one query in one parser :sql{} request              multi_statements=1&  allow execute more then one query in one parser :sql{} request
               config_file=.my.cnf&
               config_group=parser3&  use group name from .my.cnf
             autocommit=1              autocommit=1
             autocommit åñëè âûñòàâèòü â 0, áóäåò äåëàòü commit/rollback              autocommit еÑ�ли выÑ�тавить в 0, будет делать commit/rollback
   
         !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              &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 137  Xíå ñäåëàíî, âèäèìî, íå áóäåò ñäåëàíî Line 143  Xíå ñäåëàíî, âèäèìî, íå áóäåò ñäåëàíî
             ORA_ENCRYPT_LOGIN=TRUE              ORA_ENCRYPT_LOGIN=TRUE
             ClientCharset=parser-charset << charset in which parser thinks client works              ClientCharset=parser-charset << charset in which parser thinks client works
   
         !odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset          odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset
             ClientCharset << charset in which parser thinks client works              ClientCharset << charset in which parser thinks client works
               
         !sqlite://DBfile?          sqlite://DBfile?
             ClientCharset=parser-charset& << charset in which parser thinks client works              ClientCharset=parser-charset& << charset in which parser thinks client works
             autocommit=1              autocommit=1
   
         äëÿ ðàáîòû connect íóæíî, ÷òîáû çàðàíåå(ðåêîìåíäóåòñÿ â ñèñòåìíîì êîíôèãóðàöèîííîì auto.p)          длÑ� работы connect нужно, чтобы заранее(рекомендуетÑ�Ñ� в Ñ�иÑ�темном конфигурационном auto.p)
         áûëà îïðåäåëåíà òàáëèöà          была определена таблица
 #sql drivers  #sql drivers
 $SQL[  $SQL[
     $.drivers[^table::create{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
 sqlite  /www/parser3/libparser3sqlite.so        /usr/local/sqlite/lib/sqlite3.so  sqlite  /www/parser3/libparser3sqlite.so        sqlite3.so
 odbc    c:\drives\y\parser3project\odbc\debug\parser3odbc.dll  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]{êîä}[{catch êîä}]          Ñ�кешировать Ñ�троку, котораÑ� получаетÑ�Ñ� при выполнении кода на 'Ñ�екунд' Ñ�екунд
         !àáñîëþòíîå çàäàíèå âðåìåíè          еÑ�ли 0 Ñ�екунд, значит не кешировать, а Ñ�тарый такой Ñ�тереть
     !^cache[ôàéë] óäàëèòü ôàéë [íå ðóãàåò, åñëè åãî íåò]          в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}
     !^cache(ñåêóíä)      ^cache[файл][expires date]{код}[{catch код}]
     !^cache[expires date]          абÑ�олютное задание времени
         !ñèãíàëèçèðóåò âûøåñòîÿùåìó ^cache "óìåíüøè äî ñòîëüêèõ-òî 'ñåêóíä'/'expires'"      ^cache[файл] удалить файл [не ругает, еÑ�ли его нет]
         !â ïðåäåëå: ^cache(0) îòìåíèòü êýøèðîâàíèå      ^cache(Ñ�екунд)
     !^cache[] âûäà¸ò òåêóùóþ expires date      ^cache[expires date]
     X^cache[read]           Ñ�игнализирует вышеÑ�тоÑ�щему ^cache "уменьши до Ñ�тольких-то 'Ñ�екунд'/'expires'"
         ñèãíàëèçèðóåò âûøåñòîÿùåìó ^cache "âçÿòü ñêýøèðîâàííîå íàñèëüíî, èãíîðèðóÿ expires",          в пределе: ^cache(0) отменить кеширование
         âûäà¸ò bool "ïîëó÷èëîñü/íåò"      ^cache[] выдаёт текущую expires date
         !^sleep(seconds)  
       у вÑ�ех методов еÑ�ть локальнаÑ� переменнаÑ� $result, еÑ�ли в неё что положить,
       то Ñ�то будет результатом метода, а не его тело
     Xåñòü ãëîáàëüíûé ôëàæîê â ñâîéñòâàõ/êîìàíäíîé ñòðîêå "íå îïòèìèçèðîâàòü"  
     !è åñòü èñêëþ÷åíèå: ^untaint[html]{êîä} íå îïòèìèçèðóåòñÿ       у вÑ�ех методов еÑ�ть локальнаÑ� переменнаÑ� $caller, в ней лежит родительÑ�кий stack frame,
         Xáåçîòíîñòèòåëüíî ôëàæêà      можно запиÑ�ать в его локальную переменную
   
     !ó âñåõ ìåòîäîâ åñòü ëîêàëüíàÿ ïåðåìåííàÿ $result, åñëè â íå¸ ÷òî ïîëîæèòü,      use(^use или @USE) ищет и подключает файл:
     !òî _ýòî_ áóäåò ðåçóëüòàòîì ìàêðîñà, à íå åãî òåëî          1. еÑ�ли путь начинаетÑ�Ñ� Ñ� /, то Ñ�читаетÑ�Ñ�, что Ñ�то путь от корнÑ� веб проÑ�транÑ�тва
     !ó âñåõ ìåòîäîâ åñòü ëîêàëüíàÿ ïåðåìåííàÿ $caller, â íåé ëåæèò ðîäèòåëüñêèé stack frame,          2. отноÑ�ительно текущей директории.
     !åñëè òóäà çàïèñàòü          3. отноÑ�ительно Ñ�трок из table $MAIN:CLASS_PATH, Ñ�низу вверх.
              $MAIN:CLASS_PATH - глобальнаÑ� Ñ�трока или таблица Ñ� путём или путÑ�ми к каталогу
     !use(^use èëè @USE) èùåò ôàéë...             Ñ� клаÑ�Ñ�ами (от корнÑ� веб проÑ�транÑ�тва), задавайте её в конфигурационном auto.p
     !1. ...åñëè ïóòü íà÷èíàåòñÿ ñ /, òî ñ÷èòàåòñÿ, ÷òî ýòî ïóòü îò êîðíÿ âåá ïðîñòðàíñòâà  
     !åñòü ãëîáàëüíàÿ ñòðîêà/òàáëèöà $MAIN:CLASS_PATH ñ ïóò¸ì/ïóòÿìè ê êàòàëîãó ñ êëàññàìè.      глобальнаÑ� табличка $CHARSETS[$.название[имÑ� файла]]
         !êîðåíü ïóòÿ/ïóòåé ñ÷èòàåòñÿ îò êîðíÿ âåá ïðîñòðàíñòâà.      задаёт какие буквы Ñ�читаютÑ�Ñ� какими(whitespace, letter, etc), а также их unicode
     !2. ...îòíîñèòåëüíî ñòðî÷êè èç table $MAIN:CLASS_PATH, ñíèçó ââåðõ      формат: tab delimited файл, Ñ� заголовком:
        çàäàâàéòå å¸ â êîíôèãóðàöèîííîì auto.p âàøåãî ñàéòà          char    white-space    digit    hex-digit    letter    word    lowercase    unicode1    unicode2
           A            x    x    x    a    0x0041    0xFF21
     !ãëîáàëüíàÿ òàáëè÷êà $CHARSETS[$.íàçâàíèå[èìÿ ôàéëà]]          где char и lowercase могут быть буквами, а могут быть и 0xКОДÐ�МИ
     !çàäà¸ò êàêèå áóêâû ñ÷èòàþòñÿ êàêèìè(whitespace, letter, etc), à òàêæå èõ unicode          еÑ�ли Ñ�имвол имеет единÑ�твенное unicode предÑ�тавление, равное Ñ�амому Ñ�имволу, можно не указывать unicode
     !ôîðìàò: tab delimited ôàéë, ñ çàãîëîâêîì:      вÑ�егда еÑ�ть кодировка UTF-8, она Ñ�влÑ�етÑ�Ñ� кодировкой по-умолчанию длÑ� request и response
     !    char    white-space    digit    hex-digit    letter    word    lowercase    unicode1    unicode2          Ð’Ð�ИМÐ�Ð�ИЕ: имÑ� кодировки case insensitive
     !    A            x    x    x    a    0x0041    0xFF21  
     ! ãäå char è lowercase ìîãóò áûòü áóêâàìè, à ìîãóò áûòü è 0xÊÎÄÀÌÈ  
     ! åñëè ñèìâîë èìååò åäèíñòâåííîå unicode ïðåäñòàâëåíèå, ðàâíîå ñàìîìó ñèìâîëó,   Ñ�интакÑ�иÑ�
     ! ìîæíî íå óêàçûâàòü unicode      $имÑ�[новое значение]
     !âñåãäà åñòü êîäèðîâêà UTF-8,       $имÑ�(математичеÑ�кое выражение нового значениÑ�)
     !îíà ÿâëÿåòñÿ êîäèðîâêîé ïî-óìîë÷àíèþ äëÿ request è response      $имÑ�{код нового значениÑ�}
     !ÂÍÈÌÀÍÈÅ: èìÿ êîäèðîâêè case sensitive      $имÑ� whitespace или ${имÑ�}неважно  Ð¿Ð¾Ð´Ñ�тановка значениÑ�
       ^имÑ� параметры  Ð²Ñ‹Ð·Ð¾Ð²
 ñèíòàêñèñ      $имÑ�.CLASS клаÑ�Ñ� значениÑ�
     !$èìÿ[íîâîå çíà÷åíèå]      $имÑ�.CLASS_NAME имÑ� клаÑ�Ñ�а
     !$èìÿ(ìàòåìàòè÷åñêîå âûðàæåíèå íîâîãî çíà÷åíèÿ)      $имÑ�[$.key[] () {}]  ÐºÐ¾Ð½Ñ�труктор Ñ�лемента переменной-хеша $имÑ�.key
     !$èìÿ{êîä íîâîãî çíà÷åíèÿ}      ^method[$.key[] () {}] конÑ�труктор Ñ�лемента параметра-хеша $parameter.key
     !$èìÿ whitespace èëè ${èìÿ}íåâàæíî  ïîäñòàíîâêà çíà÷åíèÿ      $CLASS.имÑ�  Ð¾Ð±Ñ€Ð°Ñ‰ÐµÐ½Ð¸Ðµ к переменной клаÑ�Ñ�а
     !^èìÿ ïàðàìåòðû  âûçîâ  
     !$èìÿ.CLASS êëàññ çíà÷åíèÿ      имÑ� заканчиваетÑ�Ñ� перед: пробел tab linefeed ; ] } ) " < >  + * / % & | = ! ' , ? {уточнить}
     !$èìÿ.CLASS_NAME èìÿ êëàññà          Ñ‚.е. можно $имÑ�,aaaa
     !$èìÿ[$.key[] () {}]  êîíñòðóêòîð ýëåìåíòà ïåðåìåííîé-õýøà $èìÿ.key          но еÑ�ли нужно поÑ�ле имени букву, Ñ�кажем -, то ${имÑ�}-
     !^method[$.key[] () {}] êîíñòðóêòîð ýëåìåíòà ïàðàìåòðà-õåøà $parameter.key  
     $CLASS.èìÿ  îáðàùåíèå ê ïåðåìåííîé êëàññà      в выражениÑ�Ñ… + и - Ñ�влÑ�ÑŽÑ‚Ñ�Ñ� дополнительными концами имени
   
     èìÿ çàêàí÷èâàåòñÿ ïåðåä: ïðîáåë tab linefeed ; ] } ) " < >  + * / % & | = ! ' , ? {óòî÷íèòü}      можно обращатьÑ�Ñ� к Ñ�оÑ�тавным объектам так: $name.subname где subname бывает:
     ò.å. ìîæíî          Ñ�трока
     $èìÿ,aaaa          $переменнаÑ�
     íî åñëè íóæíî ïîñëå èìåíè áóêâó, ñêàæåì -, òî          Ñ�трока$переменнаÑ�
     ${èìÿ}-          [код, вычиÑ�лÑ�ющий Ñ�троку]
     â âûðàæåíèÿõ + è - ÿâëÿþòñÿ äîïîëíèòåëüíûìè êîíöàìè èìåíè      например: $хеш[$.возраÑ�Ñ‚(88)] $доÑ�тать[$.поле[возраÑ�Ñ‚]] ^хеш.[$доÑ�тать.поле].format{%05d}
     !ìîæíî îáðàùàòüñÿ ê ñîñòàâíûì îáúåêòàì òàê: $name.subname  
     !ãäå subname áûâàåò:  Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚ры := один или много параметров
     !    ñòðîêà  Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚Ñ€ :=
     !    $ïåðåìåííàÿ      (математичеÑ�кое выражение) вычиÑ�лÑ�етÑ�Ñ� много раз внутри вызова,
     !    ñòðîêà$ïåðåìåííàÿ  |   [код] вычиÑ�лÑ�етÑ�Ñ� один раз перед вызовом,
     !    [êîä, âû÷èñëÿþùèé ñòðîêó]  |   {код} вычиÑ�лÑ�етÑ�Ñ� 0 или много раз внутри вызова,
     íàïðèìåð: $õýø[$.âîçðàñò(88)] $äîñòàòü[$.ïîëå[âîçðàñò]] ^õýø.[$äîñòàòü.ïîëå].format{%05d}      везде допуÑ�тимы ; внутри - делает много параметров в одних Ñ�кобках
   
 ïàðàìåòðû:=îäèí èëè ìíîãî ïàðàìåòðîâ  void
 ïàðàìåòð:=      доÑ�тупны вÑ�е методы, приÑ�утÑ�твующие у объекта клаÑ�Ñ�а string, результат как у пуÑ�той Ñ�троки
     !(ìàòåìàòè÷åñêîå âûðàæåíèå) âû÷èñëÿåòñÿ ìíîãî ðàç âíóòðè âûçîâà,       ^void:sql{запроÑ� без результата}{$.bind[Ñ�м. table::sql]}
 |    ![êîä] âû÷èñëÿåòñÿ îäèí ðàç ïåðåä âûçîâîì,   
 |    !{êîä} âû÷èñëÿåòñÿ 0 èëè ìíîãî ðàç âíóòðè âûçîâà,   int,double
     !âåçäå äîïóñòèìû ; âíóòðè - äåëàåò ìíîãî ïàðàìåòðîâ â îäíèõ ñêîáêàõ      ^имÑ�.int[]  Ñ†ÐµÐ»Ð¾Ñ‡Ð¸Ñ�ленное значение
       ^имÑ�.double[] double значение
       ^имÑ�.bool[] .bool(true|false)  bool значение
 !void      ^имÑ�.inc(на Ñ�колько +)
     !^èìÿ.length[]      ^имÑ�.dec(на Ñ�колько -)
         0      ^имÑ�.mul(на Ñ�колько *)
     !^èìÿ.pos[...]      ^имÑ�.div(на Ñ�колько /)
         -1      ^имÑ�.mod(на Ñ�колько %)
     !^èìÿ.left(n)      ^имÑ�.format[формат]
        íè÷åãî íå âûäà¸ò      ^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[Ñ�м. table::sql]]]
     !^èìÿ.right(n)          запроÑ�, результат которого должен быть один Ñ�толбец/одна Ñ�трока
        íè÷åãî íå âûäà¸ò  
     !^èìÿ.mid(p[;n])  
        íè÷åãî íå âûäà¸ò  string
     !^èìÿ.int[]  (default)       в выражении
         0 èëè default          def значение равно "не пуÑ�та?"
     !^èìÿ.double[] (default)          логичеÑ�кое/чиÑ�ловое значение равно попытке преобразовываниÑ� к double,
         0 èëè default              пуÑ�таÑ� Ñ�трока тихо преобразуетÑ�Ñ� к 0
     !^èìÿ.bool[] (default)          пример:
         false èëè default          ^if(def $form:name) не пуÑ�та?
     !^void:sql{çàïðîñ áåç ðåçóëüòàòà}{$.bind[ñì. table::sql]}          ^if($user.isAlive) иÑ�тина? [автопреобразование к чиÑ�лу, не ноль?]
   
       ^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[Ñ�м. table::sql]]]
 !int,double          результат запроÑ�а должен быть один Ñ�толбец/одна Ñ�трока
     !^èìÿ.int[]  öåëî÷èñëåííîå çíà÷åíèå   
     !^èìÿ.double[]+  double çíà÷åíèå       ^Ñ�трока.int[] .int(default) целочиÑ�ленное значение Ñ�троки. 
     !^èìÿ.bool[] + .bool(true|false)  bool çíà÷åíèå          еÑ�ли ломаетÑ�Ñ� преобразование, берётÑ�Ñ� default
     !^èìÿ.inc(íà ñêîëüêî +)  
     !^èìÿ.dec(íà ñêîëüêî -)      ^Ñ�трока.double[] .double(default)  double значение Ñ�троки
     !^èìÿ.mul(íà ñêîëüêî *)          еÑ�ли ломаетÑ�Ñ� преобразование, берётÑ�Ñ� default
     !^èìÿ.div(íà ñêîëüêî /)  
     !^èìÿ.mod(íà ñêîëüêî %)      ^Ñ�трока.bool[] .bool(default)  bool значение Ñ�троки
     !^èìÿ.format[ôîðìàò]          еÑ�ли ломаетÑ�Ñ� преобразование, берётÑ�Ñ� default
     !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[ñì. table::sql]]]  
         çàïðîñ, ðåçóëüòàò êîòîðîãî äîëæåí áûòü îäèí ñòîëáåö/îäíà ñòðîêà      ^Ñ�трока.format[формат] %d  %.2f %02d...
   
 !string      ^Ñ�трока.match[шаблон-Ñ�трока|шаблон-regex][[опции поиÑ�ка]]  $prematch $match $postmatch $1 $2...
     !â âûðàæåíèè           опции поиÑ�ка=
         !def çíà÷åíèå ðàâíî "íå ïóñòà?"  
         !ëîãè÷åñêîå/÷èñëîâîå çíà÷åíèå ðàâíî ïîïûòêå ïðåîáðàçîâûâàíèÿ ê double,  
             ïóñòàÿ ñòðîêà òèõî ïðåîáðàçóåòñÿ ê 0      
   
         ïðèìåð:  
         ^if(def $form:name) íå ïóñòà?  
         ^if($user.isAlive) èñòèíà? [àâòîïðåîáðàçîâàíèå ê ÷èñëó, íå íîëü?]  
     !^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[ñì. table::sql]]]  
         ðåçóëüòàò çàïðîñà äîëæåí áûòü îäèí ñòîëáåö/îäíà ñòðîêà  
     !^ñòðîêà.int[] .int(default) öåëî÷èñëåííîå çíà÷åíèå ñòðîêè.   
         åñëè ëîìàåòñÿ ïðåîáðàçîâàíèå, áåð¸òñÿ default  
     !^ñòðîêà.double[]+ .double(default)  double çíà÷åíèå ñòðîêè  
     !^ñòðîêà.bool[] + .bool(default)  bool çíà÷åíèå ñòðîêè  
         åñëè ëîìàåòñÿ ïðåîáðàçîâàíèå, áåð¸òñÿ default  
     !^ñòðîêà.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
         n âåðíóòü öèñëî ñ êîëè÷åñòâîì íàéäåííûõ ñîâïàäåíèé, à íå òàáëèöó ñ ðåçóëüòàòàìè          n вернуть циÑ�ло Ñ� количеÑ�твом найденных Ñ�овпадений, а не таблицу Ñ� результатами
         U èíâåðòèðîâàòü ñìûñë ìîäèôèêàòîðà '?'          U инвертировать Ñ�мыÑ�л модификатора '?'
     !^ñòðîêà.match[øàáëîí-ñòðîêà|øàáëîí-regex][îïöèè ïîèñêà]{çàìåíà}  
         îïöèè ïîèñêà+=      ^Ñ�трока.match[шаблон-Ñ�трока|шаблон-regex][опции поиÑ�ка]{замена}
         g çàìåíèòü âñå âõîæäåíèÿ, à íå îäíî          опции поиÑ�ка+=
     !^ñòðîêà.split[ðàçäåëèòåëü][[lrhv]][[íàçâàíèå ñòîëáöà äëÿ âåðòèêàëüíîãî ðàçáèåíèÿ]]          g заменить вÑ�е вхождениÑ�, а не одно
         l ñëåâà íàïðàâî [default]  
         r ñïðàâà íàëåâî      ^Ñ�трока.split[разделитель|regex][[lrhv]][[название Ñ�толбца длÑ� вертикального разбиениÑ�]]
         h nameless òàáëèöà ñ êëþ÷àìè 0, 1, 2, ...          l Ñ�лева направо [default]
         v òàáëèöà èç 1 ñòîëáöà 'piece' èëè êàê ïåðåäàäóò [default]          r Ñ�права налево
     !^ñòðîêà.{l|r}split[ðàçäåëèòåëü] òàáëèöà èç ñòîëáöà $piece          h nameless таблица Ñ� ключами 0, 1, 2, ...
         îñòàâëåí äëÿ ñîâìåñòèìîñòè          v таблица из 1 Ñ�толбца 'piece' или как передадут [default]
     !^ñòðîêà.upper|lower[]   
     X^ñòðîêà.truncate(ïðåäåë òåðïåíüÿ) ñòèëü :(      ^Ñ�трока.{l|r}split[разделитель] таблица из Ñ�толбца $piece
     !^ñòðîêà.length[]          оÑ�тавлен длÑ� Ñ�овмеÑ�тимоÑ�ти
     !^ñòðîêà.mid(P[;N])  
         áåç N - "äî êîíöà ñòðîêè"      ^Ñ�трока.upper|lower[]
     !^ñòðîêà.left(N)  
     !^ñòðîêà.right(N)      ^Ñ�трока.length[]
     !^ñòðîêà.pos[ïîäñòðîêà]  
     !^ñòðîêà.pos[ïîäñòðîêà](ïîçèöèÿ, ñ êîòîðîé èùåì)      ^Ñ�трока.mid(P[;N])
         <0 = íå íàéäåíî          без N - "до конца Ñ�троки"
     !^ñòðîêà.replace[$òàáëèöà_ïîäñòàíîâîê_ñòðîêà_íà_ñòðîêó]  
     !^ñòðîêà.save[[append;]ïóòü]      ^Ñ�трока.left(N), -1 выдает вÑ�ÑŽ Ñ�троку
     !^ñòðîêà.save[ïóòü[;$.charset[â êàêîé êîäèðîâêå ñîõðàíÿåì] $.append(true)]]  
     !^ñòðîêà.normalize[] âûäàåò äðóãóþ ñòðîêó, â êîòîðîé ôðàãìåíòû íà îäíîì ÿçûêå îáúåäèíåíû      ^Ñ�трока.right(N)
         ïîëåçíî äåëàòü ïåðåä ñëîæíûìè match îïåðàöèÿìè, åñëè âû çíàåòå, ÷òî âõîäíàÿ ñòðîêà  
         ñîñòîèò èç áîëüøîãî ÷èñëà ôðàãìåíòîâ      ^Ñ�трока.pos[подÑ�трока]
     !^ñòðîêà.trim[start|both|end|left|right[;chars]] âûêèäûâàåò chars èç íà÷àëà/êîíöà/è íà÷àëà è êîíöà  
       ^Ñ�трока.pos[подÑ�трока](позициÑ�, Ñ� которой ищем)
           <0 = не найдено
   
       ^Ñ�трока.replace[$таблица_подÑ�тановок_Ñ�трока_на_Ñ�троку]
   
       ^Ñ�трока.replace[$что;$на-что]
   
       ^Ñ�трока.save[[append;]путь]
   
       ^Ñ�трока.save[путь[;$.charset[в какой кодировке Ñ�охранÑ�ем] $.append(true)]]
   
       ^Ñ�трока.trim[start|both|end|left|right[;chars]] выкидывает chars из начала/конца/и начала и конца
         default 'chars' -- whitespace chars          default 'chars' -- whitespace chars
     !^ñòðîêà.append[string]  
     !^ñòðîêà.base64[] encode      ^Ñ�трока.trim[chars] выкидывает chars из начала и конца
     !^string:base64[encoded] decode  
       ^Ñ�трока.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode
 !table      ^string:base64[encoded[; $.pad(bool) $.strict(bool) url-safe(bool) ]] decode
     â âûðàæåíèè   
         ëîãè÷åñêîå çíà÷åíèå ðàâíî "íå ïóñòà?"      ^Ñ�трока.idna[]
         ÷èñëîâîå çíà÷åíèå ðàâíî count[]          IDNA кодирование, поддержка кирилличеÑ�ких доменов
     !^table::create[[nameless]]{äàííûå}[[$.separator[^#09]]] ñòàðîå èìÿ "set"  
     !^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]      ^string:idna[encoded]
         êëîíèðóåò òàáëèöó              IDNA декодирование, поддержка кирилличеÑ�ких доменов
         reverse << ñçàäó íà ïåð¸ä (ðàáîòàåò ïîêà òîëüêî â locate, â table::create ÍÅ ðàáîòàåò)  
     !^table::load[[nameless;]ïóòü[;îïöèè]]      ^Ñ�трока.js-escape[] кодирование длÑ� передачи в JS (%uXXXX)
         !åñëè íå nameless, íàçâàíèÿ êîëîíîê áåðóòñÿ èç ïåðâîé ñòðîêè  
         !ïóñòûå ñòðîêè, è ñòðîêè â ïåðâîé êîëîíêå ñîäåðæàùèå '#', èãíîðèðóþòñÿ              ^string:js-unescape[escaped] декодирование переданного из js
         !$.separator[^#09]  
         !$.encloser["] ïî-óìîë÷àíèþ, íåò.      ^string:unescape[js|uri;escaped; $.charset[] ] декодирование переданного из js или uri
     !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]]  
         bind ïðèâÿçûâàåò ïåðåìåííûå â çàïðîñå ê èõ çíà÷åíèÿì  
         ïîêà ðåàëèçîâàí òîëüêî äëÿ oracle  table
         â çàïðîñå íàäî íàïèñàòü ":èìÿ"      в выражении
         â ïàðàìåòðå bind ïåðåäàòü hash, èç êîòîðîãî âîçüì¸òñÿ(èëè êóäà çàïèøåòñÿ) çíà÷åíèå          логичеÑ�кое значение равно "не пуÑ�та?"
     !^òàáëèöà.save[[nameless|append;]ïóòü[;îïöèè, ñì. load]]          чиÑ�ловое значение равно count[]
     !$òàáëèöà.ïîëå      ^table::create[[nameless]]{данные}[[$.separator[^#09] $.encloser[]]]
     !$òàáëèöà.fields  èç named òàáëèöû âûäà¸ò òåêóùóþ çàïèñü êàê Hash      ^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
     !^òàáëèöà.menu{òåëî}[[ðàçäåëèòåëü]]          клонирует таблицу
     !^òàáëèöà.offset[] ïå÷àòàåò offset          reverse - в обратном порÑ�дке
     !^òàáëèöà.offset[[whence]](5) ñäâèãàåò      ^table::load[[nameless;]путь[;опции]]
         !whence=cur|set          еÑ�ли не nameless, названиÑ� колонок берутÑ�Ñ� из первой Ñ�троки
         !áåç whence - ýòî cur          пуÑ�тые Ñ�троки, и Ñ�троки в первой колонке Ñ�одержащие '#', игнорируютÑ�Ñ�
     !^òàáëèöà.count[]          $.separator[^#09]
     !^òàáëèöà.line[] 1-based offset          $.encloser["] по-умолчанию, нет.
     !^òàáëèöà.sort{{êëþ÷åäåëàòåëü ñòðîêà}|(êëþ÷åäåëàòåëü ÷èñëî)}[{desc|asc}] default=asc      ^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash]]]
     !^òàáëèöà.append{äàííûå}          bind привÑ�зывает переменные в запроÑ�е к их значениÑ�м
     X^òàáëèöà.insert{äàííûå}[(n)] äîáàâèòü çàïèñü           пока реализован только длÑ� oracle
         íà òåêóùóþ ïîçèöèþ [äîáàâèòü çàïèñü íà ïîçèöèþ n]          в запроÑ�е надо напиÑ�ать ":имÑ�"
     X^òàáëèöà.remove(position[;count]) - ñòèðàåò çàïèñü           в параметре bind передать hash, из которого возьмётÑ�Ñ� (или куда запишетÑ�Ñ�) значение
         èç òåêóùåé ïîçèöèè [ñòèðàåò çàïèñü èç êîíêðåòíîé ïîçèöèè]       ^таблица.save[[nameless|append;]путь[;опции, Ñ�м. load]]
             [ñòèðàåò count çàïèñåé]      $таблица.поле
     !^òàáëèöà.join[òàáëèöà][$.limit(1) $.offset(5) $.offset[cur]] - äîáàâëÿåò çàïèñè èç òàáëèöû.       $таблица.поле[новое значение]
         òàáëèöû äîëæíû èìåòü îäèíàêîâóþ ñòðóêòóðó.      $таблица.fields  Ð¸Ð· named таблицы выдаёт текущую запиÑ�ÑŒ как Hash
     !^òàáëèöà.flip[] âûäà¸ò òðàíñïîíèðîâàííóþ, íàäî êóäà-òî ñëîæèòü, ïîòîì ïîëüçîâàòü      ^таблица.menu{тело}[[разделитель]]
     !^òàáëèöà.locate[ïîëå;çíà÷åíèå][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]       ^таблица.foreach[позициÑ�;значение]{тело}[[разделитель]]
         ïåðåäâèãàåò òåêóùóþ ñòðîêó, åñëè íàéä¸ò. âûäà¸ò bool      ^таблица.line[] 1-based offset
     !^òàáëèöà.locate(ëîãè÷åñêîå âûðàæåíèå)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]      ^таблица.offset[] печатает offset
         ïåðåäâèãàåò òåêóùóþ ñòðîêó, åñëè íàéä¸ò. âûäà¸ò bool      ^таблица.offset[[whence]](5) Ñ�двигает
     !^òàáëèöà.hash{[ïîëå]|{êîä}|(âûðàæåíèå)}[[ïîëå çíà÷åíèé|table ïîëÿ çíà÷åíèé]][[$.distinct(1) $.distinct[tables]]]          whence=cur|set, без whence - Ñ�то cur
         çíà÷åíèåì $hash.êëþ÷ áóäåò hash â êîòîðîì ïîëÿ çíà÷åíèé áóäóò êëþ÷àìè      ^таблица.count[], ^таблица.count[rows] - количеÑ�тво Ñ�трок в таблице
         ïîëÿ çíà÷åíèé ìîãóò áûòü íå óêàçàíû, òîãäà èìè áóäóò âñå ñòîëáöû, âêëþ÷àÿ êëþ÷åâîé      ^таблица.count[columns] - количеÑ�тво Ñ�толбцов таблицы
         åñëè distinct ñîäåðæèò true, òî íå áóäåò îøèáêè ïðè ïîâòîðÿþùèõñÿ êëþ÷àõ      ^таблица.count[cells] - количеÑ�тво Ñ�чеек в текущей Ñ�троке таблицы
         åñëè distinct ñîäåðæèò tables, òî áóäåò ñîçäàí hash èç òàáëèö, ñîäåðæàùèõ ñòðîêè ñ êëþ÷îì      ^таблица.sort{{ключеделатель Ñ�трока}|(ключеделатель чиÑ�ло)}[{desc|asc}] default=asc
     !^òàáëèöà.columns[[íàçâàíèå ñòîëáöà]]+ òàáëèöà èç îäíîãî ñòîëáöà 'column' èëè êàê ïåðåäàäóò      ^таблица.append{данные}
     !$îòîáðàííîå[^òàáëèöà.select(âûðàæåíèå)] = òàáëèöà èç òåõ æå ñòîëáöîâ è ñòðîê, ó êîòîðûõ óñëîâèå ñîâïàëî      ^таблица.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[]
     !$õåø.êëþ÷      $хеш.ключ
         !_default - ñïåöèàëüíûé êëþ÷, åñëè çàäàí,           _default - Ñ�пециальный ключ, еÑ�ли задан,
         òî ïðè îáðàùåíèè ïî êëþ÷ó, êîòîðîìó íåò ñîîòâåòñòâèÿ, âûäà¸òñÿ _default çíà÷åíèå           то при обращении по ключу, которому нет Ñ�оответÑ�твиÑ�, выдаётÑ�Ñ� _default значение
     !$õåø.fields âûäàåò $hash. ÷òîáû êëàññ hash áûë ÷óòü áîëüøå ïîõîæ íà êëàññ table      $хеш.fields выдает $hash. чтобы клаÑ�Ñ� hash был чуть больше похож на клаÑ�Ñ� table
     !^hash::create[[!copy_from_hash|copy_from_hashfile]]      ^hash::create[[|copy_from_hash|copy_from_hashfile]]
         ñîçäà¸ò íîâûé hash, êîïèþ ñòàðîãî          Ñ�оздаёт новый hash, копию Ñ�тарого
     !^õåø.add[ñëàãàåìîå]      ^хеш.add[Ñ�лагаемое]
         ïåðåçàïèñûâàåò îäíîèì¸ííûå          перезапиÑ�ывает одноимённые
     !^õåø.sub[âû÷èòàåìîå]      ^хеш.sub[вычитаемое]
     !^õåø.union[b] = îáúåäèíåíèå      ^хеш.union[b] = объединение
         îäíîèì¸ííûå îñòàþòñÿ          одноимённые оÑ�таютÑ�Ñ�
     !^õåø.intersection[b] = ïåðåñå÷åíèå      ^хеш.intersection[b] = переÑ�ечение
         çíà÷åíèÿ õåø          значениÑ� хеш
     !^õåø.intersects[b] = bool      ^хеш.intersects[b] = bool
     !^hash::sql{çàïðîñ}[[$.distinct(1) $.limit(2) $.offset(4) todo:$.default{$.field[]...}]]      ^hash::sql{запроÑ�}[[$.distinct(1) $.limit(2) $.offset(4) $.type[hash|string|table]]]
         ïîëó÷àåòñÿ hash(êëþ÷è=çíà÷åíèÿ ïåðâàÿ êîëîíêà îòâåòà)          получаетÑ�Ñ� hash(ключи=значениÑ� перваÑ� колонка ответа) of hash(ключи=названиÑ� оÑ�тальных колонкок ответа) или
         of hash(êëþ÷è=íàçâàíèÿ îñòàëüíûõ êîëîíêîê îòâåòà)          string=значение каждого Ñ�лемента - Ñ�трока, при Ñ�том надо указать ровно два Ñ�толбца или
     !^õåø._keys[[íàçâàíèå êîëîíêè ñ êëþ÷àìè]]+ òàáëèöà èç îäíîãî ñòîëáöà $key èëè êàê ïåðåäàäóò          table=значение каждого Ñ�лемента - таблица
     !^õåø._count[]      ^хеш.keys[[название колонки Ñ� ключами]] + таблица из одного Ñ�толбца key или как передадут
     !^õåø.foreach[key;value]{òåëî}[[ðàçäåëèòåëü]|{ðàçäåëèòåëü êîòîðûé âûïîëíÿåòñÿ ïåðåä íåïóñòûì î÷åðåäíûì íå ïåðâûì òåëîì}]      ^хеш.count[]
     !^õåø.delete[êëþ÷]  óäàëèòü êëþ÷      ^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
     !^õåø.contain[êëþ÷] - ñóùåñòâóåò ëè â õåøå êëþ÷ (bool)      ^хеш.delete[ключ]  ÑƒÐ´Ð°Ð»Ð¸Ñ‚ÑŒ ключ
     !^õýø._at[first|last]      ^хеш.contain[ключ] - Ñ�ущеÑ�твует ли в хеше ключ (bool)
     !^õýø._at([-]N)      ^хеш.at[first|last][[key|value|hash]]
         äîñòóï ê çàäàííûì ýëåìåíòàì óïîðÿäî÷åííîãî õåøà      ^хеш.at([-]N)[[key|value|hash]]
           доÑ�туп к заданным Ñ�лементам упорÑ�доченного хеша
 !hashfile      ^хеш.sort[key;value]{{ключеделатель Ñ�трока}|(ключеделатель чиÑ�ло)}[[desc|asc]] default=asc
     !^hashfile::open[filename]      $обратный_хеш[^хеш.reverse[]]
     !^õåøôàéë.clear[]  çàáûòü âñ¸      $отобранное[^хеш.select[key;value](выражение)[ $.limit(N) $.reverse(bool) $.default(bool) ]] = хеш из ключей и значений, длÑ� которых уÑ�ловие иÑ�тинно
     !$õåøôàéë.êëþ÷[çíà÷åíèå]  ïîëîæèòü çíà÷åíèå  
     !$õåøôàéë.êëþ÷[$.value[çíà÷åíèå] $.expires[ÇÍÀ×ÅÍÈÅ]}  
       ïîëîæèòü çíà÷åíèå äî expires  hashfile
       çíà÷åíèå ïîëÿ expires ìîæåò áûòü date, èëè ÷èñëî äíåé(0äíåé=íà âå÷íî)      ^hashfile::open[filename]
     !$õåøôàéë.êëþ÷  äîñòàòü      ^хешфайл.clear[]  Ð·Ð°Ð±Ñ‹Ñ‚ÑŒ вÑ�Ñ‘
     !^õåøôàéë.delete[êëþ÷]  óäàëèòü êëþ÷      $хешфайл.ключ[значение]  Ð¿Ð¾Ð»Ð¾Ð¶Ð¸Ñ‚ÑŒ значение
     !^õåøôàéë.delete[]  óäàëèòü ôàéëû, ñîäåðæàùèå äàííûå      $хешфайл.ключ[$.value[значение] $.expires[ЗÐ�Ð�ЧЕÐ�ИЕ]}
     !^õåøôàéë.hash[]        положить значение до expires
         ïðåîáðàçîâàòü â îáû÷íûé hash        значение полÑ� expires может быть date, или чиÑ�ло дней(0дней=на вечно)
         ïîïóòíî ñòèðàåò óñòàðåâøèå ïàðû      $хешфайл.ключ  Ð´Ð¾Ñ�тать
     !^õåøôàéë.foreach[key;value]{òåëî}[[ðàçäåëèòåëü]|{ðàçäåëèòåëü êîòîðûé âûïîëíÿåòñÿ ïåðåä íåïóñòûì î÷åðåäíûì íå ïåðâûì òåëîì}]      ^хешфайл.delete[ключ]  ÑƒÐ´Ð°Ð»Ð¸Ñ‚ÑŒ ключ
     !^õåøôàéë.release[]      ^хешфайл.delete[]  ÑƒÐ´Ð°Ð»Ð¸Ñ‚ÑŒ файлы, Ñ�одержащие данные
         çàïèñàòü äàííûå è ñíÿòü áëîêèðîâêè.      ^хешфайл.hash[]
         ïðè ïîâòîðíîì îáðàùåíèè ê ýëåìåíòàì îòêðîåòñÿ àâòîìàòè÷åñêè.          преобразовать в обычный hash
     !^õåøôàéë.cleanup[]  ïðîáåæàòüñÿ ïî âñåì ýëåìåíòàì è óäàëèòü óñòàðåâøèå.          попутно Ñ�тирает уÑ�таревшие пары
       ^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
       ^хешфайл.release[]
           запиÑ�ать данные и Ñ�нÑ�ть блокировки.
           при повторном обращении к Ñ�лементам откроетÑ�Ñ� автоматичеÑ�ки.
       ^хешфайл.cleanup[]  Ð¿Ñ€Ð¾Ð±ÐµÐ¶Ð°Ñ‚ÑŒÑ�Ñ� по вÑ�ем Ñ�лементам и удалить уÑ�таревшие.
   
     ïðèìåð:      пример:
     $sessions[^hashfile::open[/db/sessions]]      $sessions[^hashfile::open[/db/sessions]]
      
     $sid[^math:uuid[]]      $sid[^math:uuid[]]
     $sessions.$sid[$.value[$uid] $.expires(1)]      $sessions.$sid[$.value[$uid] $.expires(1)]
     $uid[$sessions.$sid]      $uid[$sessions.$sid]
   
   
 !form  array
     [áåð¸òñÿ ïåðâûé ýëåìåíò èç îäíîèì¸ííûõ èç GET, ïîòîì ïåðâûé èç POST]      в выражении
     !$form:ïîëå = string/file           логичеÑ�кое значение равно "не пуÑ�Ñ‚?"
     !$form:nameless = ïîëå ñî çíà÷åíèåì ïîëÿ áåç èìåíè "?value&...", "...&value&...", "...&value"          чиÑ�ловое значение равно count[]
     !$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          Ñ�оздание маÑ�Ñ�ива Ñ� заданными значениÑ�ми
       ^array::create[]
       ^array::create[значение;значение;...]
 !env          Ñ�оздание маÑ�Ñ�ива Ñ� заданными значениÑ�ми или пуÑ�того маÑ�Ñ�ива
     !$env:ïåðåìåííàÿ      ^array::copy[копируемый маÑ�Ñ�ив или хеш Ñ� цифровыми ключами]
     !$env:PARSER òî æå ñàìîå, ÷òî ïîêàçûâàåòñÿ ïðè çàïóñêå parser.cgi          копирование маÑ�Ñ�ива или хеша Ñ� цифровыми ключами
       ^маÑ�Ñ�ив.add[добавлÑ�емый маÑ�Ñ�ив или хеш Ñ� цифровыми ключами]
           добавление Ñ�лементов из другого маÑ�Ñ�ива или хеша Ñ� перезапиÑ�ью значений у Ñ�овпадающих индекÑ�ов
 !cookie      ^маÑ�Ñ�ив.join[добавлÑ�емый маÑ�Ñ�ив или произвольный хеш]
     !$cookie:èìÿ ñ÷èòàòü ñòàðîå èëè ñâåæåçàäàííîå          добавление Ñ�лементов другого маÑ�Ñ�ива или хеша в конец маÑ�Ñ�ива
     !$cookie:èìÿ[çíà÷åíèå] íà 90 äíåé      ^маÑ�Ñ�ив.append[значение;значение;...]
     !$cookie:èìÿ[$.value[çíà÷åíèå]  $.expires[ÇÍÀ×ÅÍÈÅ] $.secure(true)]          добавление Ñ�лементов в конец маÑ�Ñ�ива
     !çíà÷åíèå ïîëÿ expires ìîæåò áûòü 'session', date, èëè ÷èñëî äíåé(0äíåé=session)      ^маÑ�Ñ�ив.insert(индекÑ�)[значение;значение;...]
     ! åñëè äàòà, îíà áóäåò ïðåîáðàçîâàíà ê ôîðìàòó "Sun, 25-Aug-2002 12:03:45 GMT"          вÑ�тавка Ñ�лементов в указанную позицию маÑ�Ñ�ива
     ! ìîæíî óñòàíàâëèâàòü bool ñâîéñòâà, íàïðèìåð $.secure(true), $.httponly(true)      ^маÑ�Ñ�ив.left(n)
     !$cookie:fields = hash ñî âñåìè cookies          возвращает новый маÑ�Ñ�ив из n первых Ñ�лементов маÑ�Ñ�ива
       ^маÑ�Ñ�ив.right(n)
           возвращает новый маÑ�Ñ�ив из n поÑ�ледних Ñ�лементов маÑ�Ñ�ива
 !request      ^маÑ�Ñ�ив.mid(m;n)
     !$request:query              возвращает новый маÑ�Ñ�ив, Ñ�одержащий n инициализированных Ñ�лементов маÑ�Ñ�ива, начинаÑ� Ñ� позиции m
     !$request:body unprocessed POST request body      ^маÑ�Ñ�ив.delete(index)
     !$request:uri          удаление Ñ�лемента маÑ�Ñ�ива Ñ� оÑ�тавлением пуÑ�того меÑ�та
     !$request:document-root      ^маÑ�Ñ�ив.remove(index)
         êàòàëîã, îòíîñèòåëüíî êîòîðîãî ñ÷èòàþòñÿ ïóòè â parser, ïî-óìîë÷àíèþ = $env:DOCUMENT_ROOT          удаление Ñ�лемента Ñ�о Ñ�двигом поÑ�ледующих Ñ�лементов на его меÑ�то
         ìîæíî èçìåíèòü, åñëè íà hosting ÷òî-òî íåóäîáíî íàñòðîåíî      ^маÑ�Ñ�ив.push[значение]
     !$request:argv = hash ñ ïàðàìåòðàìè êîììàíäíîé ñòðîêè. êëþ÷è 0, 1, ... [0 -- èìÿ îáðàáàòûâàåìîãî ôàéëà].          добавление Ñ�лемента в конец маÑ�Ñ�ив
     X!$request:browser  ýòî hash, ïîëÿ:      ^маÑ�Ñ�ив.pop[]
         !$type = ie/nn è !$version = íîìåð, ñêàæåì 5.5                 возвращает поÑ�ледний Ñ�лемент и удалÑ�ет его из маÑ�Ñ�ива
     X$request:user      ^маÑ�Ñ�ив.contain(индекÑ�)
     X$request:password          Ñ�ущеÑ�твует ли в маÑ�Ñ�иве Ñ�лемент по переданому индекÑ�у (bool)
     !$request:charset      ^array::sql{запроÑ�}[[ $.sparse(false) $.distinct(false) $.limit(2) $.offset(4) $.type[hash|string|table]]]
         Êîäèðîâêà èñõîäíîãî äîêóìåíòà           Ñ�оздание маÑ�Ñ�ива на оÑ�нове выборки из базы данных
         !èñïîëüçóåòñÿ ïðè upper/lower è match[][i]          $.sparse(false), по умолчанию - Ñ�оздать обычный маÑ�Ñ�ив. ЗначениÑ� Ñ�трок выборки поÑ�ледовательно добавлÑ�ÑŽÑ‚Ñ�Ñ� в маÑ�Ñ�ив
         ÏÐÅÄÓÏÐÅÆÄÅÍÈÅ: êëàññ form ïîëó÷àåò ñâîè ïîëÿ ïîñëå îáðàáîòêè âñåõ auto êëàññà MAIN          $.sparse(true) - Ñ�оздать разреженный маÑ�Ñ�ив. ПерваÑ� колонка данных должна Ñ�одержать индекÑ�Ñ‹,
         ïîýòîìó íåîáõîäèìî çàäàòü $request/response:charset â îäíîì èç íèõ. íå ïîñëå.          по которым будут размещены значениÑ� (аналогично ^hash::sql{})
           получаетÑ�Ñ� array of hash (ключи=названиÑ� оÑ�тальных колонкок ответа) или
           string=значение каждого Ñ�лемента - Ñ�трока, при Ñ�том надо указать ровно два Ñ�толбца или
 !response          table=значение каждого Ñ�лемента - таблица
     !$response:ïîëå[çíà÷åíèå]  è ìîæíî ñ÷èòàòü ñòàðîå -- $response:ïîëå      ^маÑ�Ñ�ив.keys[[название колонки Ñ� ключами]]
         !çíà÷åíèå ìîæåò áûòü string à ìîæåò áûòü hash:          таблица из одного Ñ�толбца key или переданного названиÑ� Ñ� индекÑ�ами инициализированных Ñ�лементов маÑ�Ñ�ива
         ! $value[abc] field: {abc}<<÷àñòü      ^маÑ�Ñ�ив.count[]
         ! $attribute[zzz] field: abc; {attribute=zzz}<<÷àñòü          количеÑ�тво инициализированных Ñ�лементов маÑ�Ñ�ива
         !çíà÷åíèå ïîëÿ èëè àòðèáóòà ìîæåò áûòü string èëè date      ^маÑ�Ñ�ив.count[all]
         ! åñëè äàòà, îíà áóäåò ïðåîáðàçîâàíà ê ôîðìàòó "Sun, 25-Aug-2002 12:03:45 GMT"          общее количеÑ�тво Ñ�лементов маÑ�Ñ�ива, включаÑ� неинициализированные
     !$response:headers íàêîïëåííûå ïîëÿ      ^маÑ�Ñ�ив.foreach[index;value]{тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
     !$response:body[DATA]  çàìåùàåò ñòàíäàðòíûé îòâåò          перебирает вÑ�е инициализированные Ñ�лементы маÑ�Ñ�ива
     !$response:download[DATA]  çàìåùàåò ñòàíäàðòíûé îòâåò,       ^маÑ�Ñ�ив.for[index;value]{тело}[[разделитель]|{разделитель который выполнÑ�етÑ�Ñ� перед непуÑ�тым очередным не первым телом}]
         âûñòàâëÿåò ôëàã, çàñòàâëÿþùèé browser ïðåäëîæèòü download          перебирает вÑ�е Ñ�лементы маÑ�Ñ�ива
     !$response:status      ^маÑ�Ñ�ив.at[first|last][[key|value|hash]]
     !^response:clear[] çàáûòü âñå çàäàííûå response ïîëÿ      ^маÑ�Ñ�ив.at([-]чиÑ�ло)[[key|value|hash]]
     !$response:charset          доÑ�туп к Ñ�лементу маÑ�Ñ�ива по порÑ�дковому номеру
         êîäèðîâêà êëèåíòà ò.å. òà,       ^маÑ�Ñ�ив.set[first|last][значение]
         1) èç êîòîðîé áóäóò ïåðåêîäèðîâàíû $form:ïîëÿ ïîñëå çàáèðàíèÿ èç browser'à      ^маÑ�Ñ�ив.set([-]чиÑ�ло)[значение]
         2) â êîòîðóþ äîêóìåíò áóäåò ïåðåêîäèðîâàí ïåðåä îòäàâàíèåì â browser          уÑ�тановка значениÑ� Ñ�лемента маÑ�Ñ�ива по порÑ�дковому номеру
         3) â êîòîðóþ áóäåò ïåðåêîäèðîâàí òåêñò ÿçûêà uri      ^маÑ�Ñ�ив.compact[]
         íå äîáàâëÿåò ê content-type íè÷åãî, åñëè õî÷åòñÿ, ýòî íàäî ñäåëàòü âðó÷íóþ          удаление неинициализированных Ñ�лементов маÑ�Ñ�ива
         ÏÐÅÄÓÏÐÅÆÄÅÍÈÅ: êëàññ form ïîëó÷àåò ñâîè ïîëÿ ïîñëå îáðàáîòêè âñåõ auto êëàññà MAIN      ^маÑ�Ñ�ив.compact[undef]
         ïîýòîìó íåîáõîäèìî çàäàòü $request/response:charset â îäíîì èç íèõ. íå ïîñëå.          удаление неинициализированных и пуÑ�тых Ñ�лементов маÑ�Ñ�ива
       ^маÑ�Ñ�ив.sort[key;value]{{ключеделатель Ñ�трока}|(ключеделатель чиÑ�ло)}[[desc|asc]] default=asc
           Ñ�ортировка маÑ�Ñ�ива
 !regex      $обратный_маÑ�Ñ�ив[^маÑ�Ñ�ив.reverse[]]
     !â âûðàæåíèè           возвращает новый маÑ�Ñ�ив из Ñ�лементов иÑ�ходного в обратном порÑ�дке
         !ëîãè÷åñêîå çíà÷åíèå âñåãäà ðàâíî true      $отобранное[^маÑ�Ñ�ив.select[key;value](выражение)[ $.limit(N) $.reverse(bool) ]]
         !÷èñëîâîå çíà÷åíèå ðàâíî êîëè÷åñòâó áàéò ñêîìïèëèðîâàííîãî øàáëîíà.          отбор Ñ�лементов маÑ�Ñ�ива, длÑ� которых уÑ�ловие иÑ�тинно
     !^regex::create[øàáëîí-ñòðîêà][[îïöèè ïîèñêà]]  
     !^øàáëîí.size[] êîëè÷åñòâî áàéò ñêîìïèëèðîâàííîãî øàáëîíà  form
         åñëè çíà÷åíèå î÷åíü áîëüøîå -- ñòîèò ïî÷èòàòü äîêóìåíòàöèþ ïî pcre è, âîçìîæíî, ïåðåïèñàòü øàáëîí.      [берётÑ�Ñ� первый Ñ�лемент из одноимённых из GET, потом первый из POST]
     !^øàáëîí.study_size[] ðàçìåð study-ñòðóêòóðû. åñëè==0 -- øàáëîí íå ìîæåò áûòü "èçó÷åí"      $form:поле = string/file 
     ^øàáëîí.save[filespec]      $form:nameless = поле Ñ�о значением полÑ� без имени "?value&...", "...&value&...", "...&value"
     ^øàáëîí.load[filespec]      $form:qtail = Ñ�трока Ñ�о значением текÑ�та поÑ�ле второго "?xxxxx", еÑ�ли там не было ',' [imap]
       $form:fields = hash Ñ�о вÑ�еми полÑ�ми формы
       $form:tables.поле = table Ñ� одним Ñ�толбцом "field" Ñ�о значениÑ�ми "полÑ�", длÑ� множеÑ�твенных значений
 !reflection      $form:files.поле = hash Ñ�о значениÑ�ми полей типа файл, ключи - 0, 1, ..., значение - файл
     !^reflection:create[êëàññ;êîíñòðóêòîð[;ïàðà;[ìåò[;ðû]]]]  âûçûâàåò óêàçàííûé êîíñòðóêòîð êëàññà (íå áîëåå 100 ïàðàìåòðîâ)      $form:imap = хеш Ñ� ключами 'x' и 'y'
     !^reflection:classes[]                 õåø ñî âñåìè êëàññàìè. êëþ÷ -- èìÿ êëàññà, çíà÷åíèå áûâàåò methoded (êëàññ ñ ìåòîäàìè) èëè void          Ñ�о значением ?1,2 припиÑ�ки при иÑ�пользовании server-site image map
     !^reflection:class[îáúåêò]             êëàññ ïåðåäàííîãî îáúåêòà  
     !^reflection:class_name[îáúåêò]        èìÿ êëàññà ïåðåäàííîãî îáúåêòà  env
     !^reflection:base[îáúåêò]              ðîäèòåëüñêèé êëàññ ïåðåäàííîãî îáúåêòà      $env:переменнаÑ�
     !^reflection:base_name[îáúåêò]         èìÿ ðîäèòåëüñêîãî êëàññà ïåðåäàííîãî îáúåêòà      $env:fields хеш Ñ� переменными окружениÑ�
     !^reflection:methods[êëàññ]            õåø ñî ñïèñêîì ìåòîäîâ óêàçàííîãî êëàññà, çíà÷åíèÿ -- ñòðîêè 'native' èëè 'parser'      $env:PARSER_VERSION верÑ�иÑ� парÑ�ера
     !^reflection:fields[êëàññ èëè îáúåêò]  õåø ñî ñïèñêîì ñòàòè÷åñêèõ ïîëåé óêàçàííîãî êëàññà èëè äèíàìè÷åñêèõ ïîëåé óêàçàííîãî îáúåêòà  
     !^reflection:method_info[êëàññ;ìåòîä]  õåø ñ ïàðàìåòðàìè óêàçàííîãî ìåòîäà êëàññà  cookie
          $.inherited[êëàññ]                èìÿ êëàññà, ãäå ìåòîä áûë îïðåäåë¸í (âîçâðàùàåòñÿ òîëüêî åñëè ìåòîä áûë îïðåäåë¸í â ïðåäêå)      $cookie:имÑ� Ñ�читать Ñ�тарое или Ñ�вежезаданное
          äëÿ native êëàññîâ âîçâðàùàåòñÿ õåø:      $cookie:имÑ�[значение] на 90 дней
              .min_params(ìèíèìàëüíî íåîáõîäèìîå ÷èñëî ïàðàìåòðîâ)      $cookie:имÑ�[$.value[значение] $.expires[ЗÐ�Ð�ЧЕÐ�ИЕ] $.secure(true) $.domain[имÑ� домена] $.httponly(true)]
              .max_params(ìàêñèìàëüíî âîçìîæíîå ÷èñëî ïàðàìåòðîâ)          значение полÑ� expires может быть 'session', date, или чиÑ�ло дней(0дней=session)
              .call_type[dynamic|static|any]          еÑ�ли дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
          äëÿ parser êëàññîâ âîçâðàùàåòñÿ õåø:      $cookie:fields = hash Ñ�о вÑ�еми cookies
              êëþ÷ -- íîìåð ïàðàìåòðà (0, 1, ...), çíà÷åíèå - èìÿ ïàðàìåòðà  
     !^reflection:dynamical[[object or class, caller if absent]]    âîçâðàùàåò true, åñëè ìåòîä áûë âûçâàí èç äèíàìè÷åñêîãî êîíòåêñòà  request
                                                                    ïðè ïåðåäà÷å ïàðàìåòðà âîçâðàùàåò true, åñëè ïåðåäàí äèíàìè÷åñêèé îáúåêò,      $request:query
                                                                    false åñëè êëàññ      $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
     !$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[
         $.options[-odd]          $.options[-odd]
             unix: ñòðîêà, êîòîðàÿ áóäåò äîáàâëåíà ê êîìàíäå çàïóñêà sendmail              unix: Ñ�трока, котораÑ� будет добавлена к команде запуÑ�ка sendmail
                 -odd îçíà÷àåò "áûñòðî ïîñòàâü â î÷åðåäü áåç ïðîâåðêè email"                  -odd означает "быÑ�тро поÑ�тавь в очередь без проверки email"
             win32: èãíîðèðóåòñÿ              win32: игнорируетÑ�Ñ�
         $.charset[êîäèðîâêà çàãîëîâêà è òåêñòîâûõ áëîêîâ]           $.charset[кодировка заголовка и текÑ�товых блоков]
         $.any-header-field           $.any-header-field
         $.text[string]          $.text[string]
         $.text[          $.text[
            $.any-header-field              $.any-header-field
            $.value[string]             $.value[string]
         ]          ]
         $.html{string}          $.html{string}
         $.html[          $.html[
             $.any-header-field               $.any-header-field
             $.value{string}              $.value{string}
         ]          ]
         $.file#[FILE]          $.file#[FILE]
         $.file#[          $.file#[
             $.any-header-field               $.any-header-field
             $value[FILE]              $value[FILE]
         ]          ]
     ]      ]
     !åñëè charset óêàçàí, ïèñüìî ïåðåêîäèðóåòñÿ â ýòîò charset      еÑ�ли charset указан, пиÑ�ьмо перекодируетÑ�Ñ� в Ñ�тот charset
     !content-type.charset íå âëèÿåò íà ïåðåêîäèðîâàíèå      content-type.charset не влиÑ�ет на перекодирование
     !ïîñëå èìåíè ÷àñòè ìîæåò èäòè # ÷èñëî      поÑ�ле имени чаÑ�ти может идти # чиÑ�ло
         ^mail:send[  
 #           ïî-óìîë÷àíèþ, ñîâïàäàåò ñ source encoding.      ^mail:send[
 #           çàäà¸ò êîäèðîâêó body  #       по-умолчанию, Ñ�овпадает Ñ� source encoding.
             $.charset[windows-1251]   #       задаёт кодировку body
 #           íåò óìîë÷àíèÿ          $.charset[windows-1251]
             $.content-type[$.value[text/plain] $.charset[windows-1251]]  #       нет умолчаниÑ�
             $.from["âàñÿ" <vasya@design.ru>]          $.content-type[$.value[text/plain] $.charset[windows-1251]]
             $.to["ïåòÿ" <petya@design.ru>]          $.from["ваÑ�Ñ�" <vasya@design.ru>]
             $.subject[ïîéä¸ì ïèâêà]          $.to["петÑ�" <petya@design.ru>]
             $.body[          $.subject[пойдём пивка]
                 ñëîâà          $.body[
             ]              Ñ�лова
         ]          ]
     !:send[$.header-field[] $.charset[êîäèðîâêà ïèñüìà] $.body[êîãäà body íå ñòðîêà,       ]
         à hash, îòñûëàåòñÿ multipart ïèñüìî]]  
     !åñëè charset óêàçàí, ïèñüìî ïåðåêîäèðóåòñÿ â ýòîò charset      ^mail:send[$.header-field[] $.charset[кодировка пиÑ�ьма] $.body[когда body не Ñ�трока, а hash, отÑ�ылаетÑ�Ñ� multipart пиÑ�ьмо]]
     !content-type.charset íå âëèÿåò íà ïåðåêîäèðîâàíèå          еÑ�ли charset указан, пиÑ�ьмо перекодируетÑ�Ñ� в Ñ�тот charset
     !ïîñëå èìåíè ÷àñòè ìîæåò èäòè öåëîå ÷èñëî, ÷àñòè ïîéäóò â ïîðÿäêå ÷èñåë.          content-type.charset не влиÑ�ет на перекодирование
     !åñëè body óêàçàí ñòðîêîé, òî ýòî òåêñò ïèñüìà, íèêàêèõ âëîæåíèé.          поÑ�ле имени чаÑ�ти может идти целое чиÑ�ло, чаÑ�ти пойдут в порÑ�дке чиÑ�ел.
     !åñëè body óêàçàí hash, òî ýòî ÷àñòè, áóäóò ñîáðàíû òåêñòîâûå áëîêè, çàòåì âëîæåíèÿ          еÑ�ли body указан Ñ�трокой, то Ñ�то текÑ�Ñ‚ пиÑ�ьма, никаких вложений.
     !ýòî ñòàðûé ôîðìàò, ïîääåðæèâàåòñÿ äëÿ îáðàòíîé ñîâìåñòèìîñòè          еÑ�ли body указан hash, то Ñ�то чаÑ�ти, будут Ñ�обраны текÑ�товые блоки, затем вложениÑ�
     !åñëè èìÿ ÷àñòè íà÷èíàåòñÿ ñî ñëîâà text, òî ýòî òåêñòîâûé áëîê.          Ñ�то Ñ�тарый формат, поддерживаетÑ�Ñ� длÑ� обратной Ñ�овмеÑ�тимоÑ�ти
     !åñëè èìÿ ÷àñòè íà÷èíàåòñÿ ñî ñëîâà file, òî ýòî âëîæåíèå, ôîðìàò çàäàíèÿ::          еÑ�ли имÑ� чаÑ�ти начинаетÑ�Ñ� Ñ�о Ñ�лова text, то Ñ�то текÑ�товый блок.
         !$file[$.format[!uue|!base64] $.value[DATA] $.name[user-file-name]]          еÑ�ли имÑ� чаÑ�ти начинаетÑ�Ñ� Ñ�о Ñ�лова file, то Ñ�то вложение, формат заданиÑ�::
     !âàæíî: ïðè multipart íå óêàçûâàòü content-type              $file[$.format[uue|base64] $.value[DATA] $.name[user-file-name]]
           важно: при multipart не указывать content-type
   
         ^mail:send[          ^mail:send[
 #           ïî-óìîë÷àíèþ, ñîâïàäàåò ñ source encoding.  #           по-умолчанию, Ñ�овпадает Ñ� source encoding.
 #           çàäà¸ò êîäèðîâêó body  #           задаёт кодировку body
             $.charset[windows-1251]               $.charset[windows-1251]
 #           íåò óìîë÷àíèÿ  #           нет умолчаниÑ�
             $.content-type[$.value[text/plain] $.charset[windows-1251]]              $.content-type[$.value[text/plain] $.charset[windows-1251]]
             $.from["âàñÿ" <vasya@design.ru>]              $.from["ваÑ�Ñ�" <vasya@design.ru>]
             $.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
                 $.file[                  $.file[
                    $.value[^file::load[my beloved.doc]]                     $.value[^file::load[my beloved.doc]]
                    $.name[ìîé ëþáèìûé.doc]                     $.name[мой любимый.doc]
                    $.format[base64]                     $.format[base64]
                 ]                  ]
                 $.file2[                  $.file2[
                    $.value[^file::load[my beloved.doc]]                     $.value[^file::load[my beloved.doc]]
                    $.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,
     !$êàðòèíêà.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          выÑ�ота Ñ�имвола = выÑ�ота картинки/количеÑ�тво букв в наборе
     !^êàðòèíêà.font[íàáîð_áóêâ;èìÿ_ôàéëà_øðèôòà.gif;          еÑ�ли указана ширина_Ñ�имвола, то monospaced, еÑ�ли 0, то ширина_Ñ�имвола = ширине gif
            $.space(øèðèíà_ïðîáåëà)             // ïî óìîë÷àíèþ = øèðèíå gif      ^картинка.font[набор_букв;имÑ�_файла_шрифта.gif;
            $.width(øèðèíà_ñèìâîëà)             // ñì. âûøå, ïî óìîë÷àíèþ proportional             $.space(ширина_пробела)             // по умолчанию = ширине gif
            $.spacing(ðàññòîÿíèå ìåæäó áóêâàìè) // ïî óìîë÷àíèþ = 1             $.width(ширина_Ñ�имвола)             // Ñ�м. выше, по умолчанию proportional
      ]             $.spacing(раÑ�Ñ�тоÑ�ние между буквами) // по умолчанию = 1
     !^êàðòèíêà.text(x;y)[òåêñò_íàäïèñè] AS_IS      ]
     !^êàðòèíêà.length[òåêñò_íàäïèñè] AS_IS      ^картинка.text(x;y)[текÑ�Ñ‚_надпиÑ�и] AS_IS
     !^êàðòèíêà.gif[âîçìîæíî, èìÿ ôàéëà] -- êîäèðóåò â FILE ñ content-type=image/gif      ^картинка.length[текÑ�Ñ‚_надпиÑ�и] AS_IS
         èìÿ ôàéëà áóäåò èñïîëüçîâàíî ïðè $response:download      ^картинка.gif[возможно, имÑ� файла] -- кодирует в FILE Ñ� content-type=image/gif
     !^êàðòèíêà.arc(center x;center y;width;height;start in degrees;end in degrees;color)          имÑ� файла будет иÑ�пользовано при $response:download
     !^êàðòèíêà.sector(center x;center y;width;height;start in degrees;end in degrees;color)      ^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color)
     !^êàðòèíêà.circle(center x;center y;r;color)      ^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color)
     !^êàðòèíêà.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]])      ^картинка.circle(center x;center y;r;color)
         ïðè çàäàííûõ dest_w/dest_h äåëàåò èçìåíåíèå ðàçìåðà êóñî÷êà      ^картинка.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]])
             ïðè óìåíüøåíèè äåëàåò resample          при заданных dest_w/dest_h делает изменение размера куÑ�очка
             ãîäèòñÿ òîëüêî äëÿ óìåíüøåíèÿ ïðîñòîé[ìàëîöâåòíîé] äðåáåäåíè âðîäå ãðàôèêîâ/pie,              при уменьшении делает resample
             äëÿ thumbnais íå ãîäèòñÿ.              годитÑ�Ñ� только длÑ� уменьшениÑ� проÑ�той[малоцветной] дребедени вроде графиков/pie,
         ïðè íå óêàçàííîì dest_h ñîõðàíÿåò aspect ratio              длÑ� thumbnais не годитÑ�Ñ�.
         tolerance - íåêîå ÷èñëî[êâàäðàò ðàññòîÿíèÿ â RGB ïðîñòðàíñòâå äî èñêîìîãî öâåòà],           при не указанном dest_h Ñ�охранÑ�ет aspect ratio
         îïðåäåëÿþùåå ïðîæîðëèâîñòü âûäåëÿëêè öâåòîâ èç ïàëèòðû [default=150]          tolerance - некое чиÑ�ло[квадрат раÑ�Ñ�тоÑ�ниÑ� в RGB проÑ�транÑ�тве до иÑ�комого цвета], 
             ìåíüøå - òî÷íåå ïðèáëèæàåò öâåòà, íî îíè áûñòðî êîí÷àþòñÿ          определÑ�ющее прожорливоÑ�ть выделÑ�лки цветов из палитры [default=150]
             áîëüøå - íåòî÷íî ïðèáëèæàåò öâåò, íî áÎëüøåé ÷àñòè õâàòèò              меньше - точнее приближает цвета, но они быÑ�тро кончаютÑ�Ñ�
     !^êàðòèíêà.pixel(x;y)[(color)]              больше - неточно приближает цвет, но бОльшей чаÑ�ти хватит
         óçíàòü èëè çàäàòü öâåò ïèêñåëà      ^картинка.pixel(x;y)[(color)]
           узнать или задать цвет пикÑ�ела
   
 !file  
     !$ôàéë_èç_post.name   file
     !$ôàéë_èç_post.size       $файл_из_post.name
     !$ôàéëtèç_post.text      $файл_из_post.size
     !^ôàéë.save[text|binary;èìÿ ôàéëà[;$.charset[â êàêîé êîäèðîâêå ñîõðàíÿåì]]]      $файлt_из_post.text
     !^file:delete[èìÿ ôàéëà]      ^файл.save[text|binary;имÑ� файла[;$.charset[в какой кодировке Ñ�охранÑ�ем]]]
     !^file:find[èìÿ ôàéëà][{êîãäà íå íàøëè}]      ^file:delete[имÑ� файла]
     !^file:list[ïóòü[;øàáëîí-ñòðîêà|øàáëîí-regex]] = table ñ êîëîíêîé name      ^file:find[имÑ� файла][{когда не нашли}]
     !^file::load[text|binary;!big.zip[;!domain_press_release_2001_03_01.zip][;îïöèè]]      ^file:list[путь[;шаблон-Ñ�трока|шаблон-regex]] = table Ñ� колонками name dir
     !^file::create[text;èìÿ;data]      ^file:list[путь;$.filter[шаблон-Ñ�трока|шаблон-regex] $.stat(true)] = table Ñ� колонками name dir size [mca]date
     !^file::create[text;èìÿ;data[;$.charset[êîäèðîâêà áóêâ â ñîçäàâàåìîì ôàéëå]]]      ^file::load[text|binary;big.zip[;domain_press_release_2001_03_01.zip][;опции]]
     !$ôàéë_êîòîðûé_áûë_loaded.size      ^file::create[text|binary;имÑ�;data]
     !$ôàéë_êîòîðûé_áûë_loaded_èëè_created.mode = text/binary      ^file::create[text|binary;имÑ�;data[;$.charset[кодировка букв в Ñ�оздаваемом файле] $.content-type[...]]]
     !^file::stat[èìÿ ôàéëà]      ^file::create[string-or-file-content[;$.name[имÑ�] $.mode[text|binary] $.content-type[...] $.charset[...]]]
     !$ôàéë_êîòîðûé_áûë_stated_èëè_loaded.size !.adate !.mdate !.cdate      $файл_который_был_loaded.size
     !^file::cgi[[text|binary;]èìÿ ôàéëà[;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]]      $файл_который_был_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[[text|binary;]èìÿ ôàéëà[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under unix max 50 args]]]]]]]      ^file::exec[[text|binary;]имÑ� файла[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under unix max 50 args]]]]]]]
         options:          options:
             $.stdin[òåêñò]  åñëè òåêñò ïóñò, îòêëþ÷àåòñÿ àâòîìàòè÷åñêîå ïåðåñîâûâàíèå äàííûõ HTTP-POST               $.stdin[текÑ�Ñ‚|файл]  ÐµÑ�ли пуÑ�то, отключаетÑ�Ñ� автоматичеÑ�кое переÑ�овывание данных HTTP-POST
     !^file:move[ñòàðîå èìÿ ôàéëà;íîâîå èìÿ ôàéëà]       ^file:move[Ñ�тарое имÑ� файла;новое имÑ� файла]
         ìîæíî ïåðåèìåíîâûâàòü è äâèãàòü êàòàëîãè[win32: íî íå ÷åðåç ãðàíèöó äèñêîâ]          можно переименовывать и двигать каталоги[win32: но не через границу диÑ�ков]
         êàòàëîãè äëÿ dest ñîçäàþòñÿ ñ ïðàâàìè 775          каталоги длÑ� dest Ñ�оздаютÑ�Ñ� Ñ� правами 775
         êàòàëîã ñòàðîãî ôàéëà ñòèðàåòñÿ, åñëè ïîñëå move îí îñòà¸òñÿ ïóñò          каталог Ñ�тарого файла Ñ�тираетÑ�Ñ�, еÑ�ли поÑ�ле move он оÑ�таётÑ�Ñ� пуÑ�Ñ‚
     !^file:copy[èìÿ ôàéëà;èìÿ êîïèè ôàéëà]       ^file:copy[имÑ� файла;имÑ� копии файла[; $.append(1) ]]
         ìîæíî êîïèðîâàòü òîëüêî ôàéëû          можно копировать только файлы
     !^file:lock[èìÿ ôàéëà]{êîä}      ^file:lock[имÑ� файла]{код}
         ôàéë ïðè íåîáõîäèìîñòè ñîçäà¸òñÿ          файл при необходимоÑ�ти Ñ�оздаётÑ�Ñ�
         áëîêèðóåòñÿ          блокируетÑ�Ñ�
         âûïîëíÿåòñÿ êîä          выполнÑ�етÑ�Ñ� код
         ðàçáëîêèðóåòñÿ          разблокируетÑ�Ñ�
     Xchmod[...] ÍÅÒ È ÍÅ ÁÓÄÅÒ, ×ÒÎÁÛ ÍÅ ÌÎÃËÈ ÑÄÅËÀÒÜ executable è çàïóñòèòü, äàæå åñëè ftp çàïðåùàåò chmod.      ^file:dirname[/a/some.tar.gz]=/a (работает аналогично комманде *nix)
     !^file:dirname[/a/some.tar.gz]=/a      ^file:dirname[/a/b/]=/a (работает аналогично комманде *nix)
     !^file:dirname[/a/b/]=/a      ^file:basename[/a/some.tar.gz]=some.tar.gz (работает аналогично комманде *nix)
     !^file:basename[/a/some.tar.gz]=some.tar.gz      ^file:basename[/a/b/]=b (работает аналогично комманде *nix)
     !^file:justname[/a/some.tar.gz]=some.tar      ^file:justname[/a/some.tar.gz]=some.tar
     !^file:justext[/a/some.tar.gz]=gz      ^file:justext[/a/some.tar.gz]=gz
     !/some/page.html: ^file:fullpath[a.gif] => /some/a.gif      /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
     !^ôàéë.sql-string[] âíóòðè ^connect äàñò ïðàâèëüíî escaped ñòðîêó, êîòîðóþ ìîæíî â çàïðîñ îòäàòü      ^файл.sql-string[] внутри ^connect даÑ�Ñ‚ правильно escaped Ñ�троку, которую можно в запроÑ� отдать
     X^file::sql[[èìÿ_ôàéëà_äëÿ_download]]{}      ^file::sql{query}[[
     !^file::sql{}[[          $.name[имÑ�_файла_длÑ�_download]
         $.name[èìÿ_ôàéëà_äëÿ_download]          $.content-type[пользовательÑ�кий content-type]
         $.content-type[ïîëüçîâàòåëüñêèé content-type]  
     ]]      ]]
         ðåçóëüòàò çàïðîñà äîëæåí áûòü "îäíà ñòðîêà".          результат запроÑ�а должен быть "одна Ñ�трока".
         êîëîíêè:          колонки:
         ïåðâàÿ êîëîíêà - äàííûå          перваÑ� колонка - данные
         åñëè åñòü âòîðàÿ - ýòî èìÿ ôàéëà          еÑ�ли еÑ�ть втораÑ� - Ñ�то имÑ� файла
         åñëè åñòü òðåòüÿ - ýòî content-type          еÑ�ли еÑ�ть третьÑ� - Ñ�то content-type
     !^ôàéë.base64[] encode      ^файл.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode
     !^file:base64[èìÿ ôàéëà]      ^file:base64[имÑ� файла[; $.pad(bool) $.wrap(bool) $.url-safe(bool) ]]
         encode          encode
     !^file::base64[encoded string]      ^file::base64[encoded string[; $.pad(bool) $.strict(bool) url-safe(bool) ]]
     !^file::base64[mode;èìÿ ôàéëà;encoded string[;$.content-type[...]]]      ^file::base64[mode;имÑ� файла;encoded string[; $.content-type[...] $.pad(bool) $.strict(bool) url-safe(bool) ]]
         decode          decode
     !^file:crc32[èìÿ ôàéëà]      ^file:crc32[имÑ� файла]
         âû÷èñëÿåò crc32 ôàéëà ñ óêàçàííûì èìåíåì          вычиÑ�лÑ�ет crc32 файла Ñ� указанным именем
     !^ôàéë.crc32[]      ^файл.crc32[]
         âû÷èñëÿåò crc32 îáúåêòà          вычиÑ�лÑ�ет crc32 объекта
     !^ôàéë.md5[]      ^файл.md5[]
     !^file:md5[èìÿ ôàéëà]      ^file:md5[имÑ� файла]
         âûäàåò digest ôàéëà, äëèíîé 16 áàéò â âèäå ñòðîêè,           выдает digest файла, длиной 16 байт в виде Ñ�троки, 
         ãäå áàéòû digest âûäàíû â hex âèäå, âïðèòûê, â íèæíåì ðåãèñòðå          где байты digest выданы в hex виде, впритык, в нижнем региÑ�тре
   
   
 !math  math
     !$math:PI      $math:PI
     !^math:round floor ceiling       ^math:round floor ceiling
     !^math:trunc frac      ^math:trunc frac
     !^math:abs sign       ^math:abs sign
     !^math:exp log       ^math:exp log
     !^math:sin asin cos acos tan atan       ^math:sin asin cos acos tan atan
     !^math:degrees radians      ^math:degrees radians
     !^math:pow sqrt      ^math:pow sqrt
     !^math:random(øèðèíà äèàïàçîíà)      ^math:random(ширина диапазона)
     !^math:uuid[]      ^math:convert[number](base-from;base-to)
           преобразует Ñ�троку Ñ� чиÑ�лом из одной Ñ�иÑ�темы иÑ�чиÑ�лениÑ� в другую
       ^math:uuid[ $.lower(bool) $.solid(bool) ]
         22C0983C-E26E-4169-BD07-77ECE9405BA5          22C0983C-E26E-4169-BD07-77ECE9405BA5
         win32: ïîëüçóåòñÿ cryptapi          win32: пользуетÑ�Ñ� cryptapi
         unix: ïîëüçóåòñÿ /dev/urandom,           unix: пользуетÑ�Ñ� /dev/urandom,
             åñëè íåò, /dev/random,               еÑ�ли нет, /dev/random,
             åñëè íåò, rand               еÑ�ли нет, rand
             [íà solaris /dev/random ìîæíî äîáàâèòü]              [на solaris /dev/random можно добавить]
     !^math:uid64[]      ^math:uid64[ $.lower(bool) ]
        BA39BAB6340BE370          BA39BAB6340BE370
     !^math:md5[string]      ^math:md5[string]
         âûäàåò digest ñòðîêè, äëèíîé 16 áàéò â âèäå ñòðîêè,           выдает digest Ñ�троки, длиной 16 байт в виде Ñ�троки, 
         ãäå áàéòû digest âûäàíû â hex âèäå, âïðèòûê, â íèæíåì ðåãèñòðå          где байты digest выданы в hex виде, впритык, в нижнем региÑ�тре
     !^math:crypt[password;salt]      ^math:crypt[password;salt]
        salt prefix $apr1$ âûçûâàåò âñòðîåííûé MD5 àëãîðèòì,           salt prefix $apr1$ вызывает вÑ�троенный MD5 алгоритм,
          åñëè íåò òåëà salt, îíî ñîçäà¸òñÿ ñëó÷àéíûì          еÑ�ли нет тела salt, оно Ñ�оздаётÑ�Ñ� Ñ�лучайным
        $1$ âûçûâàåò MD5 àëãîðèòì ôóíêöèè OS 'crypt', åñëè ïîääåðæèâàåòñÿ [çàâåäîìî íåò íà solaris].          $1$ вызывает MD5 алгоритм функции OS 'crypt', еÑ�ли поддерживаетÑ�Ñ� [заведомо нет на solaris].
        äðóãèå salt ÷èòàéòå äîêóìåíòàöèþ ïî ôóíêöèè OS 'crypt'.          другие salt читайте документацию по функции OS 'crypt'.
     !^math:crc32[string]      ^math:crc32[string]
        âû÷èñëÿåò crc32 ñòðîêè          вычиÑ�лÑ�ет crc32 Ñ�троки
     !^math:sha1[string]      ^math:sha1[string]
     !^math:convert[number](base-from;base-to) ïðåîáðàçóåò ñòðîêó ñ ÷èñëîì èç îäíîé ñèñòåìû èñ÷èñëåíèÿ â äðóãóþ      ^math:digest[[md5|sha1|sha256|sha512];Ñ�трока или файл][[ $.format[hex|base64] $.hmac[ключ] ]]
           объединÑ�ет в Ñ�ебе возможноÑ�ть работы Ñ� разными алгоритмами криптографичеÑ�кого хешированиÑ�.
           $.hmac[ключ] длÑ� проверки целоÑ�тноÑ�ти переданных данных
 !inet  
     !^inet:ntoa(long)  
     !^inet:aton[IP]  inet
       ^inet:ntoa(long)
 !json      ^inet:aton[IP]
     !^json:parse[-json-ñòðîêà-[;      ^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]] прÑ�мое преобразование имени в IP адреÑ�
         $.depth(ìàêñèìàëüíàÿ ãëóáèíà, default == 19)      ^inet:ip2name[ip][ $.ipv[4|6|any] ]] обратное преобразование из IP адреÑ�а в имÑ�
         $.double(false)              îòêëþ÷èòü âñòðîåííûé ïàðñèíã ÷èñåë ñ ïëàâàþùåé òî÷êîé (ïî óìîë÷àíèþ âêëþ÷åí)  
                                      â ýòîì ñëó÷àå îíè ïîïàäóò â ðåçóëüòèðóþùèé îáúåêò êàê ñòðîêè  
         $.distinct[first|last|all]   êàê áóäåò ïðîèñõîäèòü ðàçáîð äóáëèðóþùèõñÿ êëþ÷åé ó îáúåêòîâ  json
                                      first -- áóäåò îñòàâëåí ïåðâûé âñòðåòèâøèéñÿ ýëåìåíò      ^json:parse[-json-Ñ�трока-[;
                                      last  -- áóäåò îñòàâëåí ïîñëåäíèé âñòðåòèâøèéñÿ ýëåìåíò          $.depth(макÑ�имальнаÑ� глубина, default == 19)
                                      all   -- áóäóò îñòàâëåíû âñå ýëåìåíòû. ïðè ýòîì ýëåìåíòû, íà÷èíàÿ ñî 2          $.double(false)              Ð¾Ñ‚ключить вÑ�троенный парÑ�инг чиÑ�ел Ñ� плавающей точкой (по умолчанию включен)
                                               ïîëó÷àò ÷èñëîâûå ñóôôèêñû (key_2 èòä)                                       Ð² Ñ�том Ñ�лучае они попадут в результирующий объект как Ñ�троки
                                      ïî óìîë÷àíèþ äóáëèðóþùèåñÿ êëþ÷è ïðèâåäóò ê exception          $.int(false)                 отключить вÑ�троенный парÑ�инг целых чиÑ�ел (по умолчанию включен)
         $.object[method-junction]    ïîëüçîâàòåëüñêèé ìåòîä[êëþ÷;îáúåêò], êîòîðîìó áóäóò ïåðåäàâàòüñÿ âñå ðàçîáðàííûå                                        Ð² Ñ�том Ñ�лучае они попадут в результирующий объект как Ñ�троки
                                      îáúåêòû è êëþ÷è îáúåêòà, ìåòîä âîçâðàùàåò íîâûé îáúåêò          $.distinct[first|last|all]   как будет проиÑ�ходить разбор дублирующихÑ�Ñ� ключей у объектов
                                        first -- будет оÑ�тавлен первый вÑ�третившийÑ�Ñ� Ñ�лемент
                                        last  -- будет оÑ�тавлен поÑ�ледний вÑ�третившийÑ�Ñ� Ñ�лемент
                                        all   -- будут оÑ�тавлены вÑ�е Ñ�лементы. при Ñ�том Ñ�лементы, начинаÑ� Ñ�о 2
                                                 получат чиÑ�ловые Ñ�уффикÑ�Ñ‹ (key_2 итд)
                                        Ð¿Ð¾ умолчанию дублирующиеÑ�Ñ� ключи приведут к exception
           $.object[method-junction]    Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ельÑ�кий метод[ключ;объект], которому будут передаватьÑ�Ñ� вÑ�е разобранные 
                                        Ð¾Ð±ÑŠÐµÐºÑ‚Ñ‹ и ключи объекта, метод возвращает новый объект
           $.array[method-junction]     пользовательÑ�кий метод, которому будут передаватьÑ�Ñ� маÑ�Ñ�ивы
           $.taint[Ñ�зык преобразованиÑ�] задаёт Ñ�зык преобразованиÑ� длÑ� вÑ�ех Ñ�трок результата
     ]]      ]]
         ïàðñèò json-ñòðîêó â õýø          парÑ�ит json-Ñ�троку в хеш
     !^json:string[system or user object[;  
         $.skip-unknown(false)    îòêëþ÷èòü exception è âûäàâàòü 'null' ïðè ñåðèàëèçàöèè îáúåêòîâ ñ òèïàìè      ^json:string[system or user object[;
                                  îòëè÷íûõ îò void, bool, string, int, double, date, table, hash è file          $.skip-unknown(false)    Ð¾Ñ‚ключить exception и выдавать 'null' при Ñ�ериализации объектов Ñ� типами
         $.date[sql-string|gmt-string|unix-timestamp]    ôîðìàò âûâîäà äàòû, ïî óìîë÷àíèþ -- sql-string                                   Ð¾Ñ‚личных от void, bool, string, int, double, date, table, hash и file
         $.table[object|array|compact]    ôîðìàò âûâîäà òàáëèöû, ïî óìîë÷àíèþ -- object          $.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",...},...]                                   object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...]
                                  array:  [["c1","c2",...] || null (for nameless),["v11","v12",...],...]                                   array:  [["c1","c2",...] || null (for nameless),["v11","v12",...],...]
                                  compact:  ["v11" || ["v11","v12",...],...]                                   compact:  ["v11" || ["v11","v12",...],...]
         $.file[text|base64]      âûâåñòè òåëî ôàéëà â óêàçàííîì âèäå (ïî óìîë÷àíèå òåëî ôàéëà           $.file[text|base64|stat] вывеÑ�ти тело файла в указанном виде (по умолчание тело файла 
                                  íå ïîïàäàåò â output)                                   Ð½Ðµ попадает в output)
         $.òèï[method-junction]   ëþáîé òèï ìîæíî âûâåñòè ñ ïîìîùüþ ïîëüçîâàòåëüñêîãî ìåòîäà, êîòîðûé           $.xdoc[hash]             параметры преобразованиÑ� xdoc в Ñ�троку (как в ^xdoc.string[])
                                  äîëæåí ïðèíèìàòü 3 ïàðàìåòðà: êëþ÷, îáúåêò äàííîãî òèïà è îïöèè           $.тип[method-junction]   любой тип можно вывеÑ�ти Ñ� помощью пользовательÑ�кого метода, который 
                                  âûçîâà ^json:string[]                                   Ð´Ð¾Ð»Ð¶ÐµÐ½ принимать 3 параметра: ключ, объект данного типа и опции 
                                    Ð²Ñ‹Ð·Ð¾Ð²Ð° ^json:string[]
           $._default[метод]        Ð¿Ð¾Ð»ÑŒÐ·Ð¾Ð²Ð°Ñ‚ельÑ�кий метод, будет вызыватьÑ�Ñ� длÑ� вывода вÑ�ех объектов пользовательÑ�ких 
                                    ÐºÐ»Ð°Ñ�Ñ�ов. Метод должен принимать 3 параметра: ключ, объект и опции вызова.
           $._default[имÑ� метода]   имÑ� пользователького метода, при его наличии он будет вызван длÑ�
                                    Ñ�ериализации
           $.void[null|string]      Ð½ÐµÐ¾Ð¿Ñ€ÐµÐ´ÐµÐ»ÐµÐ½Ð½Ð¾Ðµ значение будет выдано в виде null (по умолчанию)
                                    Ð¸Ð»Ð¸ пуÑ�той Ñ�троки
     ]]      ]]
         ñåðèàëèçóåò ñèñòåìíûé èëè ïîëüçîâàòåëüñêèé îáúåêò â json-ñòðîêó          Ñ�ериализует Ñ�иÑ�темный или пользовательÑ�кий объект в json-Ñ�троку
   
   
 !date  date
     !âðåìÿ òèïà time ìîæíî èñïîëüçîâàòü â âûðàæåíèÿõ, ïîäñòàâëÿåò       времÑ� типа time можно иÑ�пользовать в выражениÑ�Ñ…, подÑ�тавлÑ�ет количеÑ�тво дней Ñ� epoch [1 Ñ�нварÑ� 1970 (UTC)], дробное.
         êîëè÷åñòâî äíåé ñ epoch [1 ÿíâàðÿ 1970 (UTC)], äðîáíîå      Строковое значение в меÑ�тном времени, чиÑ�ленное в UTC, диапазон от 0000-00-00 00:00:00 до 9999-12-31 23:59:59.
     !âñ¸ ïðîèñõîäèò â localtime,       по умолчанию иÑ�пользуетÑ�Ñ� уÑ�тановленнаÑ� Ñ�редÑ�твами OS временнаÑ� зона
     !âðåìåííàÿ çîíà çàäà¸òñÿ âíå parser ñðåäñòâàìè OS      ^date::now[]
     $date:UTC-offset  ñêîëüêî äíåé íàäî ïðèáàâèòü,÷òîáû ïîïàñòü â local âðåìÿ      ^date::now(Ñ�мещение в днÑ�Ñ…) выдаёт Ñ�ейчаÑ�+Ñ�мещение
     $date:TZ  íàø ÷àñîâîé ïîÿñ, äðîáíîå, â ÷àñàõ (ãäå-òî åñòü ñ òî÷íîñòüþ äî ïîëó÷àñà)      ^date::today[] дата на 00:00:00 текущего днÑ�
     !^date::now[]      ^date::today(целочиÑ�ленное Ñ�мещение в днÑ�Ñ…) дата на 00:00:00 текущего днÑ�+Ñ�мещение
     !^date::now(ñìåùåíèå â äíÿõ) âûäà¸ò ñåé÷àñ+ñìåùåíèå      ^date::create(дней Ñ� epoch)
     !^date::create(äíåé ñ epoch) // ñòàðîå èìÿ set      ^date::create(year;month[;day[;hour[;minute[;second[;TZ]]]]])
     !^date::create(year;month[;day[;hour[;minute[;second]]]]) // ñòàðîå èìÿ set      ^date::create[дата в формате %Y-%m-%d %H:%M:%S]
     !^date::create[äàòà â ôîðìàòå %Y-%m-%d %H:%M:%S]          длÑ� удобного Ñ�озданиÑ� по значению из базы
         äëÿ óäîáíîãî ñîçäàíèÿ ïî çíà÷åíèþ èç áàçû          формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
         ôîðìàò1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]          формат2: %H:%M[:%S]
         ôîðìàò2: %H:%M[:%S]      ^date::create[дата в формате %Y-%m-%dT%H:%M[:%S]TZ]
     !^date::unix-timestamp()          длÑ� Ñ�озданиÑ� по значению в формате ISO 8601
     !^äàòà.unix-timestamp[]          формат TZ: Z(UTC) или +-hour[:minute] (Ñ�мещение от UTC)
     !$äàòà.year month day  hour minute second  weekday yearday(0...) daylightsaving TZ weekyear      ^date::unix-timestamp()
         read-only      ^дата.unix-timestamp[]
         TZ="" << ëîêàëüíàÿ çîíà      $дата.year month day hour minute second weekday yearday(0...) daylightsaving TZ weekyear
     !^äàòà.roll[year|month|day](+-ñìåùåíèå) ñäâèãàåò äàòó          TZ="" << локальнаÑ� зона
     !^äàòà.roll[TZ;Íîâàÿ çîíà] ãîâîðèò, ÷òî äàòà â òàêîì-òî ÷àñîâîì ïîÿñå: âëèÿåò íà .hour & Co      $дата.year month day hour minute second можно задать новое значение, оÑ�тальные read only
     !^äàòà.sql-string[] %Y-%m-%d %H:%M:%S      ^дата.roll[year|month|day](+-Ñ�мещение) Ñ�двигает дату
         where published='^äàòà.sql-string[]'      ^дата.roll[TZ;Ð�оваÑ� зона] говорит, что дата в таком-то чаÑ�овом поÑ�Ñ�е: влиÑ�ет на .hour & Co
     !^date:calendar[rus|eng](ãîä;ìåñÿö) âûäà¸ò íåèìåíîâàííóþ òàáëèöó       ^date:roll[TZ;Ð�оваÑ� зона] говорит, что по умолчанию вÑ�е даты в таком-то чаÑ�овом поÑ�Ñ�е
         ñòîëáöû: 0..6, week, year      ^дата.sql-string[[datetime|date|time]]
     !^date:calendar[rus|eng](ãîä;ìåñÿö;äåíü) âûäà¸ò èìåííîâàííóþ òàáëèöó          datetime или без параметра -- %Y-%m-%d %H:%M:%S
         ñòîëáöû: year, month, day, weekday          date                       -- %Y-%m-%d
     !^date:last-day(ãîä;ìåñÿö) âåðí¸ò ïîñëåäíèé äåíü ìåñÿöà          time                       -- %H:%M:%S
     !^äàòà.last-day[] âåðí¸ò ïîñëåäíèé äåíü ìåñÿöà $äàòà          where published='^дата.sql-string[]'
     !^äàòà.gmt-string[]  Fri, 23 Mar 2001 09:32:23 GMT      ^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      $xdoc.search-namespaces hash, where keys=prefixes, values=urls
       
     DOM1 attributes:      DOM1 attributes:
     !readonly attribute DocumentType doctype      readonly attribute DocumentType doctype
     Xreadonly attribute DOMImplementation implementation      readonly attribute Element documentElement
     !readonly attribute Element documentElement  
   
     DOM1 methods:      DOM1 methods:
     !Element createElement(in DOMString tagName)      Element createElement(in DOMString tagName)
     !DocumentFragment createDocumentFragment()      DocumentFragment createDocumentFragment()
     !Text createTextNode(in DOMString data)      Text createTextNode(in DOMString data)
     !Comment createComment(in DOMString data)      Comment createComment(in DOMString data)
     !CDATASection createCDATASection(in DOMString data)      CDATASection createCDATASection(in DOMString data)
     !ProcessingInstruction createProcessingInstruction(in DOMString target,in DOMString data)      ProcessingInstruction createProcessingInstruction(in DOMString target,in DOMString data)
     !Attr createAttribute(in DOMString name)      Attr createAttribute(in DOMString name)
     !EntityReference createEntityReference(in DOMString name)      EntityReference createEntityReference(in DOMString name)
     !NodeList getElementsByTagName(in DOMString tagname)      NodeList getElementsByTagName(in DOMString tagname)
   
     DOM2 some methods:      DOM2 some methods:
     !^.getElementById[elementId] = xnode      ^.getElementById[elementId] = xnode
         The DOM implementation must have information that says which attributes are of type ID.           The DOM implementation must have information that says which attributes are of type ID.
         Attributes with the name "ID" are not of type ID unless so defined.           Attributes with the name "ID" are not of type ID unless so defined.
         Implementations that do not know whether attributes are of type ID or not           Implementations that do not know whether attributes are of type ID or not
         are expected to return null.          are expected to return null.
   
     !êîäèðîâêà ñòðîê è óìîë÷àíèå äëÿ $.encoding       кодировка Ñ�трок и умолчание длÑ� $.encoding 
     !ðàâíî òåêóùåé êîäèðîâêå âûõîäíîé ñòðàíèöû,      равно текущей кодировке выходной Ñ�траницы,
         $response:charset          $response:charset
     ::sql{...}      ::sql{...}
     !::create[[URI]]{<?xml?><string/>} ñòàðîå èìÿ 'set'      ::create[[URI]]{<?xml?><string/>} Ñ�тарое имÑ� 'set'
     !::create[[URI]][qualifiedName]      ::create[[URI]][qualifiedName]
       URI default = disk path to requested document        URI default = disk path to requested document
       äëÿ êàòàëîãîâ êîíå÷íûé / îáÿçàòåëåí        длÑ� каталогов конечный / обÑ�зателен
     !::create[file] can be usable:      ::create[file] can be usable:
         $f[^file::load[binary;http://;some HTTP options here...]]          $f[^file::load[binary;http://;some HTTP options here...]]
         $x[^xdoc::create[$f]]          $x[^xdoc::create[$f]]
     !::load[file.xml[;îïöèè]]      ::load[file.xml[;опции]]
     !.transform[rules.xsl|xdoc][[params hash]] âûäà¸ò dom      .transform[rules.xsl|xdoc][[params hash]] выдаёт dom
         øàáëîí êýøèðóåòñÿ, êýø îáíîâëÿåòñÿ ïðè èçìåíåíèè äàòû ôàéëà øàáëîíà,          шаблон кешируетÑ�Ñ�, кеш обновлÑ�етÑ�Ñ� при изменении даты файла шаблона,
         èëè èçìåíåíèè äàòû ôàéëà "èìÿ øàáëîíà.stamp"[ïðîâåðêà äàòû stamp ïðèîðèòåòíåå]          или изменении даты файла "имÑ� шаблона.stamp"[проверка даты stamp приоритетнее]
         <xsl:output          <xsl:output
         !method = "xml" | "html" | "text"          method = "xml" | "html" | "text"
             X| qname-but-not-ncname           version = nmtoken 
         !version = nmtoken           encoding = string 
         !encoding = string           omit-xml-declaration = "yes" | "no"
         !omit-xml-declaration = "yes" | "no"          standalone = "yes" | "no"
         !standalone = "yes" | "no"          cdata-section-elements = qnames 
         X[ïåðåäàë, íî xsltSaveResultTo íå èñïîëüçîâàë åãî]doctype-public = string           indent = "yes" | "no"
             Xåñëè íà÷èíàåòñÿ ñ "-//W3C//DTD XHTML" òî áóäåò âûâîäèòü XHTML          media-type = string /> 
         X[ïåðåäàë, íî xsltSaveResultTo íå èñïîëüçîâàë åãî]doctype-system = string           параметры передаютÑ�Ñ� как еÑ�ть, не xpath выражениÑ�
         !cdata-section-elements = qnames   
         !indent = "yes" | "no"      .string[[output options]]
         !media-type = string />       .save[file.xml[;output options]] Ñ� шапкой
         !ïàðàìåòðû ïåðåäàþòñÿ êàê åñòü, íå xpath âûðàæåíèÿ      .file[[output options]] = file
           output options идентичны атрибутам xsl:output
     !.string[[output options]]              [иÑ�ключение: игнорируетÑ�Ñ� 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]
           [примечание: в параметр вÑ�егда приходит лидирующаÑ� /, даже, еÑ�ли параметров вообще не было]
   
         !åñëè íà äîêóìåíò ññûëàþòñÿ òàê:  
             parser://method/param/to/that/method  
             òî â êà÷åñòâå äîêóìåíòà èñïîëüçóåòñÿ ^MAIN:method[/param/to/that/method]  
             [ïðèìå÷àíèå: â ïàðàìåòð âñåãäà ïðèõîäèò ëèäèðóþùàÿ /, äàæå, åñëè ïàðàìåòðîâ âîîáùå íå áûëî]  
   
 !xnode  
   xnode
     DOM1 attributes:      DOM1 attributes:
     !$node.nodeName      $node.nodeName
     !$node.nodeValue      $node.nodeValue
         !read          read
         !write          write
     !$node.nodeType = int      $node.nodeType = int
       ELEMENT_NODE                   = 1           ELEMENT_NODE                   = 1
       ATTRIBUTE_NODE                 = 2           ATTRIBUTE_NODE                 = 2
       TEXT_NODE                      = 3           TEXT_NODE                      = 3
       CDATA_SECTION_NODE             = 4           CDATA_SECTION_NODE             = 4
       ENTITY_REFERENCE_NODE          = 5           ENTITY_REFERENCE_NODE          = 5
       ENTITY_NODE                    = 6           ENTITY_NODE                    = 6
       PROCESSING_INSTRUCTION_NODE    = 7           PROCESSING_INSTRUCTION_NODE    = 7
       COMMENT_NODE                   = 8           COMMENT_NODE                   = 8
       DOCUMENT_NODE                  = 9           DOCUMENT_NODE                  = 9
       DOCUMENT_TYPE_NODE             = 10           DOCUMENT_TYPE_NODE             = 10
       DOCUMENT_FRAGMENT_NODE         = 11           DOCUMENT_FRAGMENT_NODE         = 11
       NOTATION_NODE                  = 12           NOTATION_NODE                  = 12
             $vasyaNode.type==$xnode:ELEMENT_NODE              $vasyaNode.type==$xnode:ELEMENT_NODE
     !$node.parentNode      $node.parentNode
     !$node.childNodes = array of nodes      $node.childNodes = array of nodes
     !$node.firstChild      $node.firstChild
     !$node.lastChild      $node.lastChild
     !$node.previousSibling      $node.previousSibling
     !$node.nextSibling      $node.nextSibling
     !$node.ownerDocument = xdoc      $node.ownerDocument = xdoc
     !$node.prefix      $node.prefix
     !$node.namespaceURI      $node.namespaceURI
     !$element_node.attributes = hash of xnodes      $element_node.attributes = hash of xnodes
     !$element_node.tagName      $element_node.tagName
     !$attribute_node.specified = boolean      $attribute_node.specified = boolean
         true if the attribute received its value explicitly in the XML document,           true if the attribute received its value explicitly in the XML document,
         or if a value was assigned programatically with the setValue function.          or if a value was assigned programatically with the setValue function.
         false if the attribute value came from the default value declared in the document's DTD.           false if the attribute value came from the default value declared in the document's DTD.
     !$attribute_node.name      $attribute_node.name
     !$attribute_node.value      $attribute_node.value
     $text_node/cdata_node/comment_node.substringData      $text_node/cdata_node/comment_node.substringData
     !$pi_node.target = target of this processing instruction      $pi_node.target = target of this processing instruction
         XML defines this as being the first token following the markup           XML defines this as being the first token following the markup
         that begins the processing instruction.          that begins the processing instruction.
     !$pi_node.data = The content of this processing instruction      $pi_node.data = The content of this processing instruction
         This is from the first non white space character after the target           This is from the first non white space character after the target
         to the character immediately preceding the ?>.           to the character immediately preceding the ?>.
     document_node.      document_node.
         readonly attribute DocumentType doctype          readonly attribute DocumentType doctype
         readonly attribute DOMImplementation implementation              readonly attribute DOMImplementation implementation
         readonly attribute Element documentElement          readonly attribute Element documentElement
     document_type_node.      document_type_node.
         !readonly attribute DOMString name          readonly attribute DOMString name
         readonly attribute NamedNodeMap entities          readonly attribute NamedNodeMap entities
         readonly attribute NamedNodeMap notations          readonly attribute NamedNodeMap notations
     !notation_node.      notation_node.
         !readonly attribute DOMString publicId          readonly attribute DOMString publicId
         !readonly attribute DOMString systemId          readonly attribute DOMString systemId
   
     !DOM1 node methods:      DOM1 node methods:
     !Node insertBefore(in Node newChild,in Node refChild)      Node insertBefore(in Node newChild,in Node refChild)
     !Node replaceChild(in Node newChild,in Node oldChild)      Node replaceChild(in Node newChild,in Node oldChild)
     !Node removeChild(in Node oldChild)      Node removeChild(in Node oldChild)
     !Node appendChild(in Node newChild)      Node appendChild(in Node newChild)
     !boolean hasChildNodes()      boolean hasChildNodes()
     !Node cloneNode(in boolean deep)      Node cloneNode(in boolean deep)
   
     !DOM1 element methods:      DOM1 element methods:
     !DOMString getAttribute(in DOMString name)      DOMString getAttribute(in DOMString name)
     !void setAttribute(in DOMString name, in DOMString value) raises(DOMException)      void setAttribute(in DOMString name, in DOMString value) raises(DOMException)
     !void removeAttribute(in DOMString name) raises(DOMException)      void removeAttribute(in DOMString name) raises(DOMException)
     !Attr getAttributeNode(in DOMString name)      Attr getAttributeNode(in DOMString name)
     !Attr setAttributeNode(in Attr newAttr) raises(DOMException)      Attr setAttributeNode(in Attr newAttr) raises(DOMException)
     !Attr removeAttributeNode(in Attr oldAttr) raises(DOMException)      Attr removeAttributeNode(in Attr oldAttr) raises(DOMException)
     !NodeList getElementsByTagName(in DOMString name)      NodeList getElementsByTagName(in DOMString name)
     !void normalize()      void normalize()
   
   
     !Introduced in DOM Level 2:      Introduced in DOM Level 2:
     !Node importNode(in Node importedNode, in boolean deep) raises(DOMException)      Node importNode(in Node importedNode, in boolean deep) raises(DOMException)
     !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName)      NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName)
     !boolean hasAttributes()      boolean hasAttributes()
   
     !XPath:      XPath:
     !^node.select[xpath/query/expression] = array of nodes,       ^node.select[xpath/query/expression] = array of nodes, 
         empty array if nothing found          empty array if nothing found
     !^node.selectSingle[xpath/query/expression] = first node if any      ^node.selectSingle[xpath/query/expression] = first node if any
     !^node.selectBool[xpath/query/expression] = bool if any or die      ^node.selectBool[xpath/query/expression] = bool if any or die
     !^node.selectNumber[xpath/query/expression] = double if any or die      ^node.selectNumber[xpath/query/expression] = double if any or die
     !^node.selectString[xpath/query/expression] = string if any or die      ^node.selectString[xpath/query/expression] = string if any or die
   
     !error codes(ïîêà ïðèäóò êàê òåêñò â ñëó÷àå ñîîòâåòñòâóþùèõ îøèáîê):  
         INDEX_SIZE_ERR  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:rusage hash      $status:rusage hash
         !utime user time used          utime user time used
         !stime system time used          stime system time used
         !maxrss max resident set size          maxrss max resident set size
         !ixrss integral shared text memory size          ixrss integral shared text memory size
         !idrss integral unshared data size          idrss integral unshared data size
         !isrss integral unshared stack size          isrss integral unshared stack size
         !tv_sec          tv_sec
         !tv_usec          tv_usec
            $s[$status:rusage]             $s[$status:rusage]
            ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]             ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]
   
     !$status:memory hash      $status:memory hash
         !used          used
             Includes some pages that were allocated but never written.              Includes some pages that were allocated but never written.
           free
         !free          ever_allocated_since_compact
               Return the number of bytes allocated since the last collection.
         !ever_allocated_since_compact          ever_allocated_since_start
             Return the number of bytes allocated since the last collection.       
   
         !ever_allocated_since_start  
             Return the total number of bytes [EVER(c)PAF] allocated in this process.              Return the total number of bytes [EVER(c)PAF] allocated in this process.
             Never decreases.              Never decreases.
   
     !$status:pid process id      $status:pid process id
     !$status:tid thread id      $status:tid thread id
   
   
 console  console
     $console:timeout      $console:timeout
     !$console:line      $console:line
         read/write ñòðîêó          read/write Ñ�троку
   
   
 DATA::=string | file | hash  DATA::=string | file | hash
   
 !hash âèäà      hash вида
 [      [
         $.file[èìÿ ôàéëà íà äèñêå]          $.file[имÑ� файла на диÑ�ке]
         $.name[èìÿ ôàéëà äëÿ ïîëüçîâàòåëÿ]          $.name[имÑ� файла длÑ� пользователÑ�]
         $.mdate[date]          $.mdate[date]
 ]      ]
   
 !MAIN  
     ýòî êëàññ, çàãðóæàåìûé íà àâòîìàòå èç êîíôèãóðàöèîííîãî auto.p,   MAIN
     êó÷è auto.p è çàïðàøèâàåìîãî äîêóìåíòà:      Ñ�то клаÑ�Ñ�, загружаемый на автомате из конфигурационного auto.p, кучи auto.p и запрашиваемого документа:
         !êîíôèãóðàöèîííûé auto.p           конфигурационный 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[]
     !ðåçóëüòàò êîòîðîãî ïåðåäà¸òñÿ â åãî @postprocess[data] if($data is string) ...      результат которого передаётÑ�Ñ� в его @postprocess[data] if($data is string) ...
     !ðåçóëüòàò êîòîðîãî îòäà¸òñÿ ïîëüçîâàòåëþ      результат которого отдаётÑ�Ñ� пользователю
   
 !åñëè âñòðå÷àåòñÿ îøèáêà è try íå çàäàí, å¸ ìîæíî êðàñèâî ñîîáùèòü ïîëüçîâàòåëþ,   ÐµÑ�ли вÑ�тречаетÑ�Ñ� ошибка и try не задан, её можно краÑ�иво Ñ�ообщить пользователю, определив
     !îïðåäåëèâ      @unhandled_exception[exception;stack]
     !@unhandled_exception[exception;stack]          $exception.type  Ñ�трока "тип проблемы"
     !$exception.type  ñòðîêà "òèï ïðîáëåìû"          $exception.file $exception.lineno $exception.colno файл, Ñ�трока и позициÑ�, где Ñ�лучилаÑ�ÑŒ проблема [еÑ�ли не запрещены при компилÑ�ции]
     !$exception.file $exception.lineno $exception.colno ôàéë, ñòðîêà è ïîçèöèÿ, ãäå ñëó÷èëàñü ïðîáëåìà [åñëè íå çàïðåùåíû ïðè êîìïèëÿöèè]          $exception.source Ñ�трока, из-за которой Ñ�лучилаÑ�ÑŒ проблема
     !$exception.source ñòðîêà, èç-çà êîòîðîé ñëó÷èëàñü ïðîáëåìà          $exception.comment комментарий english
     !$exception.comment êîììåíòàðèé english          stack табличка из колонок file line name,
     !stack òàáëè÷êà èç êîëîíîê file line name,              там лежат в обратном порÑ�дке имена[name] и меÑ�та вызовов[file line] 
         òàì ëåæàò â îáðàòíîì ïîðÿäêå èìåíà[name] è ìåñòà âûçîâîâ[file line]               операторов/методов, приведших к ошибке.
         îïåðàòîðîâ/ìåòîäîâ, ïðèâåäøèõ ê îøèáêå.  
   Ð¿Ñ€Ð¸ загрузке файла (file::load, table::load, xdoc::load) можно указать такое имÑ� файла:
 !ïðè çàãðóçêå ôàéëà (file::load, table::load, xdoc::load) ìîæíî óêàçàòü òàêîå èìÿ ôàéëà:      http://domain/document[?params<<deprecated, use $.form[...]]
     !http://domain/document[?params<<deprecated, use $.form[...]]      а также, возможно, указать опции:
     !à òàêæå, âîçìîæíî, óêàçàòü îïöèè:          $.method[GET|POST|HEAD]
         !$.method[GET|POST|HEAD]          $.timeout(3)  << в Ñ�екундах, по-умолчанию =2
         !$.timeout(3)  << â ñåêóíäàõ, ïî-óìîë÷àíèþ =2          $.cookies[
         !$.cookies[              $.имÑ�[значение]
                 $.èìÿ[çíà÷åíèå]          ]
           $.headers[
               $.поле[значение] << значение имеет формат, как $response:ЗÐ�ГОЛОВОК
         ]          ]
         !$.headers[  
         !    $.ïîëå[çíà÷åíèå] << çíà÷åíèå èìååò ôîðìàò, êàê $response:ÇÀÃÎËÎÂÎÊ  
         !]  
         $.enctype[multipart/form-data]          $.enctype[multipart/form-data]
         $.form[          $.form[
             !$.field1[string]              $.field1[string]
             !$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]              $.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]
             $.field3[file]              $.field3[file]
         ]          ]
         !$.body[string]          $.body[string|file]
                 |file          по-умолчанию, user-agent=parser3
         !ïî-óìîë÷àíèþ, user-agent=parser3          по-умолчанию, получение http status != 200 >> Ñ�оздает http.status ошибку, Ñ�то можно отключить, передав $.any-status(1)
         !ïî-óìîë÷àíèþ, ïîëó÷åíèå http status != 200 >> ñîçäàåò http.status îøèáêó,          $.charset[кодировка удалённых документов по-умолчанию], еÑ�ли Ñ�ервер вернёт content-type:charset - ОÐ�Ð�_ПЕРЕБИВÐ�ЕТ
         !ýòî ìîæíî îòêëþ÷èòü, ïåðåäàâ          $.response-charset[кодировка удалённых документов], не перебиваеÑ�Ñ� content-type:charset
         !$.any-status(1)          $.user[пользователь]
         !$.charset[êîäèðîâêà óäàë¸ííûõ äîêóìåòîâ ïî-óìîë÷àíèþ] << åñëè ñåðâåð âåðí¸ò content-type:charset=ÎÍÀ_ÏÅÐÅÁÈÂÀÅÒ          $.password[пароль]
         !$.user[ïîëüçîâàòåëü]      file::load в дополнительные полÑ� запиÑ�ывает
         !$.password[ïàðîëü]          ПОЛЕ:значение (имена полей ответа заглавными буквами)
     !file::load â äîïîëíèòåëüíûå ïîëÿ çàïèñûâàåò          tables << хеш их ПОЛЕ->table Ñ� единÑ�твенным Ñ�толбцом "value".
         !ÏÎËÅ:çíà÷åíèå (èìåíà ïîëåé îòâåòà çàãëàâíûìè áóêâàìè)              в таких таблицах можно брать повторÑ�ющиеÑ�Ñ� заголовки. например, неÑ�колько set-cookies
         !tables << õåø èõ ÏÎËÅ->table ñ åäèíñòâåííûì ñòîëáöîì "value".               todo:Ñ�делать отдельный cookies
             â òàêèõ òàáëèöàõ ìîæíî áðàòü ïîâòîðÿþùèåñÿ çàãîëîâêè. íàïðèìåð, íåñêîëüêî set-cookies  
             todo:ñäåëàòü îòäåëüíûé cookies  Ñ�иÑ�темные типы ошибок:
       parser.compile       ^test[}                ÐºÐ¾Ð¼Ð¿Ð¸Ð»Ñ�циÑ� (непарнаÑ� Ñ�кобка, ...)
 !ñèñòåìíûå òèïû îøèáîê:      parser.runtime       ^if(0).                Ð¿Ð°Ñ€Ð°Ð¼ÐµÑ‚ры (больше/меньше, чем нужно, не тех типов, ...)
     !parser.compile       ^test[}                êîìïèëÿöèÿ (íåïàðíàÿ ñêîáêà, ...)      number.zerodivision  ^eval(1/0) ^eval(1%0)
     !parser.runtime       ^if(0).                ïàðàìåòðû (áîëüøå/ìåíüøå, ÷åì íóæíî, íå òåõ òèïîâ, ...)      number.format        ^eval(abc*5)
     !number.zerodivision  ^eval(1/0) ^eval(1%0)      file.lock                                                        shared/exclusive lock error
     !number.format        ^eval(abc*5)      file.missing         ^file:delete[delme]                         not found
     !file.lock                                                        shared/exclusive lock error      file.access          ^table::load[.]                             no rights
     !file.missing         ^file:delete[delme]                         not found      file.read            ^file::load[...]                            error while reading file
     !file.access          ^table::load[.]                             no rights      file.seek                                                        seek failed
     !file.read            ^file::load[...]                            error while reading file      file.execute         ^file::cgi[...]                             incorrect cgi header/can't execute
     !file.seek                                                        seek failed      image.format         ^image::measure[index.html]                 not gif/jpg
     !file.execute         ^file::cgi[...]                             incorrect cgi header/can't execute      sql.connect          ^connect[mysql://baduser:pass@host/db]{}    not found/timeout
     !image.format         ^image::measure[index.html]                 not gif/jpg      sql.execute          ^void:sql{select bad}                       syntax error
     !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
     !date.range           ^date::create(1950;1;1)                     date out of valid range  
   ÐµÑ�ли в MAIN определён $SIGPIPE(1) то в Ñ�лучае, еÑ�ли обработка была прервана пользователем, Ñ�ообщение
 !íóæíî âûêëþ÷èòü ðóññêèé apache: CharsetDisable on      об Ñ�том будет запиÑ�ано в parser3.log
   
 Xåñëè â MAIN áóäåò îïðåäåë¸í ôëàã $ORIGINS(1) òî âìåñòî îáû÷íîãî âûâîäà ñòðàíèöû áóäåò  
     âûäàí ñïèñîê ôðàãìåíòîâ ðåçóëüòàòà ñ óêàçàíèåì èõ ïðîèñõîæäåíèÿ  
   
 !åñëè â MAIN îïðåäåë¸í $SIGPIPE(1) òî â ñëó÷àå, åñëè îáðàáîòêà áûëà ïðåðâàíà ïîëüçîâàòåëåì, ñîîáùåíèå  
         îá ýòîì áóäåò çàïèñàíî â parser3.log (ðàíüøå îíî âñåãäà ïèñàëîñü)  
   
 !åñëè îïèñàíèå ìåòîäà ñîäåðæèò ëîêàëüíóþ ïåðåìåííóþ result â ÿâíîì âèäå  
     (åñòü è íåÿâíàÿ ïåðåìåííàÿ)  
     òî êîä âûâîäà ñòðîêîâûõ ëèòåðàëîâ íå ïîïàäàåò â êîíå÷íûé áàéò-êîä,  
     à íåïðîáåëüíûå ñèìâîëû ñ÷èòàþòñÿ ñèíòàêñè÷åñêîé îøèáêîé  
     äëÿ âûâîäà ÷åãî áû òî íè áûëî íàäî ïîëüçîâàòüñÿ ýòîé ïåðåìåííîé  
   
   ÐµÑ�ли опиÑ�ание метода Ñ�одержит локальную переменную result в Ñ�вном виде (еÑ�ть и неÑ�внаÑ� переменнаÑ�)
       то код вывода пробельных литералов не попадает в конечный байт-код.

Removed from v.1.236  
changed lines
  Added in v.1.255


E-mail: