Annotation of parser3/operators.ru.txt, revision 1.274

1.249     moko        1: операторы
1.250     moko        2:     ^eval(выражение)[формат] выражение, кроме обычных функций:
                      3:         допустимы #комментарии
1.249     moko        4:             работают до конца строки или закрывающейся круглой скобки
                      5:             внутри комментария допустимы вложенные круглые скобки
1.250     moko        6:         из неочевидных операторов:
                      7:             | побитный xor
                      8:             || логический xor
1.249     moko        9:             ~ побитное отрицание
                     10:             \ целочисленное деление 10\3=3
1.250     moko       11:         def для проверки defined,
1.249     moko       12:             пустая строка не defined
                     13:             пустая таблица не defined
                     14:             пустой hash не defined
1.250     moko       15:         eq ne lt gt le ge для сравнения строк,
                     16:         in "/dir/" для проверки, находится ли текущий документ в каталоге
1.259     moko       17:             ["внутри не допустимы выражения, если надо сравнить со сложным, пусть это будет переменная]
1.250     moko       18:         is 'type' для проверки типа левого операнда,
                     19:             можно проверить, "не hash ли параметр метода?"
                     20:         -f для проверки существования файла на диске,
                     21:         -d для проверки существования каталога на диске,
1.259     moko       22:         строка в кавычках или апострофах - строка, без кавычек или апострофов строка до ближайшего whitespace
1.250     moko       23:         числовой литерал бывает 0xABC
                     24:         приоритеты:
                     25:             /* logical */
                     26:             %left "!||"
                     27:             %left "||"
                     28:             %left "&&"
                     29:             %left '<' '>' "<=" ">="   "lt" "gt" "le" "ge"
                     30:             %left "==" "!="  "eq" "ne"
                     31:             %left "is" "def" "in" "-f" "-d"
                     32:             %left '!'
1.1       paf        33: 
1.259     moko       34:             /* bitwise */
1.250     moko       35:             %left '!|'
                     36:             %left '|'
                     37:             %left '&' 
                     38:             %left '~'
1.1       paf        39: 
1.259     moko       40:             /* numerical */
1.250     moko       41:             %left '-' '+'
                     42:             %left '*' '/' '%' '\\'
                     43:             %left '~'     /* negation: unary */
1.259     moko       44: 
                     45:         литералы:
1.250     moko       46:             true
                     47:             false
                     48: 
                     49:     ^if(условие){когда да}{когда нет}
1.259     moko       50:     ^if(условие1){да}[(условие2){да}[(условие2){да}[...]]]{нет}
                     51:         количество доп. условий не ограничено (в общем elseif это :)
1.250     moko       52: 
                     53:     ^switch[значение]{^case[вариант1[;вариант2...]]{действие}^case[DEFAULT]{действие по умолчанию}}
                     54: 
                     55:     ^while(условие){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
                     56: 
                     57:     ^for[i](0;4){тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
                     58: 
                     59:     ^try{
1.21      paf        60:         ...
1.259     moko       61:         ^throw[sql.connect[;вася[;ошибся]]] // был ^error[текст]
1.250     moko       62:         ^throw[
                     63:             $.type[sql.connect]
                     64:             $.source[вася]
1.259     moko       65:             $.comment[ошибся]
1.207     misha      66:         ]
1.20      paf        67:         ...
                     68:     }{
1.207     misha      69:         ^if($exception.type eq "sql"){
1.249     moko       70:             $exception.handled(1|true)  ^rem{флаг, что exception обработан}
1.21      paf        71:             ....
                     72:         }
1.207     misha      73:         ^switch[$exception.type]{
1.21      paf        74:             ^case[sql;mail]{
                     75:                 $exception.handled(1)
1.249     moko       76:                 код, обрабатывающий sql ошибку
1.21      paf        77:                 $exception.type = sql.connect
1.249     moko       78:                 $exception.file $exception.lineno $exception.colno [если не запрещены при компиляции]
                     79:                 $exception.source = вася
1.259     moko       80:                 $exception.comment = ошибся
1.21      paf        81:             }
1.194     misha      82:             ^case[DEFAULT]{
1.249     moko       83:                 код, обрабатывающий другую ошибку
1.207     misha      84:                 ^throw[$exception] << re-throw // DON'T! It's default behaviour!
1.21      paf        85:             }
                     86:         }
1.20      paf        87:     }
1.250     moko       88: 
1.259     moko       89:     ^break[]
                     90:         обрывает цикл
                     91:     ^break(true|false)
                     92:         обрывает цикл, если true
                     93: 
                     94:     ^continue[]
                     95:         обрывает итерацию цикла
                     96:     ^continue(true|false)
                     97:         обрывает итерацию цикла, если true
                     98: 
                     99:     ^return[]
                    100:         обрывает выполнение метода
                    101:     ^return[value]
                    102:         присваивает $result значение value и обрывает выполнение метода
1.250     moko      103: 
                    104:     ^untaint[[as-is|file-spec|uri|http-header|mail-header|sql|js|json|parser-code|regex|xml|html|optimized-[as-is|xml|html]]]{код}
1.1       paf       105:         default as-is
1.250     moko      106: 
                    107:     ^taint[[lang]][код]
1.1       paf       108:         default "just tainted, language unknown"
1.250     moko      109: 
                    110:     ^apply-taint[[lang;]текст]
                    111:         выполняет заданные в строке преобразования, неопределенно грязное как lang, на выходе чистая строка
                    112: 
                    113:     ^process[[$caller.CLASS|$object|$КЛАСС:CLASS]]{строка, которая будет process-ed, как код}[
1.249     moko      114:         $.main[во что переименовать @main]
                    115:         $.file[имя файла из которого, якобы, данный текст]
1.259     moko      116:         $.lineno(номер строки в файле, откуда данный текст, можно отрицательный)
1.151     paf       117:     ]
1.250     moko      118:     ^process..[путь][во что переименовать @main]
                    119:         по умолчанию, методы компилируются в $self [в случае оператора, $self=$MAIN:CLASS]
                    120: 
                    121:     ^connect[protocol://строка соединения]]{код с ^sql[...]-ями}
1.254     moko      122:         mysql://user:pass@{host[:port][, host[:port]]|[/unix/socket]}/database?
1.161     paf       123:             ClientCharset=parser-charset << charset in which parser thinks client works
1.248     moko      124:             charset=UTF-8&
1.1       paf       125:             timeout=3&
1.210     misha     126:             compress=0&
1.136     paf       127:             named_pipe=1&
1.254     moko      128:             multi_statements=1&  allow execute more then one query in one parser :sql{} request
                    129:             config_file=.my.cnf&
                    130:             config_group=parser3&  use group name from .my.cnf
1.136     paf       131:             autocommit=1
1.249     moko      132:             autocommit если выставить в 0, будет делать commit/rollback
1.1       paf       133: 
1.250     moko      134:         pgsql://user:pass@{host[:port]|[local]}/database?
1.163     paf       135:             client_encoding=win,[to-find-out]
                    136:             &datestyle=ISO,SQL,Postgres,European,NonEuropean=US,German,DEFAULT=ISO
                    137:             &ClientCharset=parser-charset << charset in which parser thinks client works
1.250     moko      138: 
                    139:         odbc://DSN=dsn^;UID=user^;PWD=password^;ClientCharset=parser-charset
1.162     paf       140:             ClientCharset << charset in which parser thinks client works
1.250     moko      141: 
                    142:         sqlite://DBfile?
1.230     misha     143:             ClientCharset=parser-charset& << charset in which parser thinks client works
                    144:             autocommit=1
1.1       paf       145: 
1.259     moko      146:         для работы connect нужно, чтобы заранее (рекомендуется в системном конфигурационном auto.p) была определена таблица
1.1       paf       147: #sql drivers
                    148: $SQL[
1.207     misha     149:     $.drivers[^table::create{protocol  driver  client
1.259     moko      150: mysql  $prefix/libparser3mysql.so      libmysqlclient.so
                    151: pgsql  $prefix/libparser3pgsql.so      libpq.so
                    152: sqlite $prefix/libparser3sqlite.so     sqlite3.so
1.257     moko      153: odbc   parser3odbc.dll
1.1       paf       154: }]
                    155: ]
1.250     moko      156:     ^rem{}
                    157:         комментарий, удаляется при компиляции
                    158: 
1.265     moko      159:     ^syslog[ident;message[;info|warning|error|debug]]
                    160:         пишет message в syslog
                    161: 
1.250     moko      162:     ^cache[файл](секунд){код}[{catch код}]
                    163:         относительное задание времени
                    164:         скешировать строку, которая получается при выполнении кода на 'секунд' секунд
                    165:         если 0 секунд, значит не кешировать, а старый такой стереть
                    166:         в catch коде $exception.handled[cache]  ^rem{флаг, что exception обработан}
                    167:     ^cache[файл][expires date]{код}[{catch код}]
                    168:         абсолютное задание времени
1.274   ! moko      169:     ^cache[файл][ $.expires(секунд)|[expires date] $.stale(секунд) ]{код}[{catch код}]
        !           170:         то же, с опциями
        !           171:         когда кеш протух, его обновляет один запрос, остальные ждут результата и код не выполняется повторно
        !           172:         $.stale(секунд) остальные не ждут, а получают протухшую копию, если она протухла не более 'секунд' назад
        !           173:         на Windows всё равно ждут: обновляемый файл заблокирован для чтения
1.259     moko      174:     ^cache[файл]
                    175:         удалить файл [не ругает, если его нет]
1.250     moko      176:     ^cache(секунд)
                    177:     ^cache[expires date]
                    178:         сигнализирует вышестоящему ^cache "уменьши до стольких-то 'секунд'/'expires'"
                    179:         в пределе: ^cache(0) отменить кеширование
1.259     moko      180:     ^cache[]
                    181:         выдаёт текущую expires date
1.250     moko      182: 
                    183:     у всех методов есть локальная переменная $result, если в неё что положить,
                    184:     то это будет результатом метода, а не его тело
                    185: 
                    186:     у всех методов есть локальная переменная $caller, в ней лежит родительский stack frame,
                    187:     можно записать в его локальную переменную
                    188: 
                    189:     use(^use или @USE) ищет и подключает файл:
                    190:         1. если путь начинается с /, то считается, что это путь от корня веб пространства
1.259     moko      191:         2. относительно текущей директории
                    192:         3. относительно строк из table $MAIN:CLASS_PATH, снизу вверх
1.250     moko      193:            $MAIN:CLASS_PATH - глобальная строка или таблица с путём или путями к каталогу
                    194:            с классами (от корня веб пространства), задавайте её в конфигурационном auto.p
                    195: 
                    196:     глобальная табличка $CHARSETS[$.название[имя файла]]
1.259     moko      197:     задаёт какие буквы считаются какими (whitespace, letter, etc), а также их unicode
1.250     moko      198:     формат: tab delimited файл, с заголовком:
                    199:         char    white-space    digit    hex-digit    letter    word    lowercase    unicode1    unicode2
                    200:         A            x    x    x    a    0x0041    0xFF21
                    201:         где char и lowercase могут быть буквами, а могут быть и 0xКОДАМИ
                    202:         если символ имеет единственное unicode представление, равное самому символу, можно не указывать unicode
                    203:     всегда есть кодировка UTF-8, она является кодировкой по-умолчанию для request и response
                    204:     ВНИМАНИЕ: имя кодировки case insensitive
1.249     moko      205: 
1.255     moko      206: 
1.249     moko      207: синтаксис
1.250     moko      208:     $имя[новое значение]
                    209:     $имя(математическое выражение нового значения)
                    210:     $имя{код нового значения}
1.259     moko      211:     $имя whitespace или ${имя}неважно - вывод значения переменой
                    212:     ^имя параметры - вызов
                    213:     $имя.CLASS - класс значения
                    214:     $имя.CLASS_NAME - имя класса
                    215:     $имя[$.key[] () {}] - конструктор переменной-хеша с элементом $имя.key
                    216:     ^method[$.key[] () {}] - конструктор параметра-хеша с элементом $parameter.key
1.249     moko      217:     $CLASS.имя  обращение к переменной класса
                    218: 
1.259     moko      219:     имя заканчивается перед: пробел tab linefeed ; ] } ) " < >  + * / % & | = ! ' , ?
1.250     moko      220:         т.е. можно $имя,aaaa
1.259     moko      221:         но если нужно после имени символ, скажем -, то ${имя}-
1.250     moko      222: 
1.249     moko      223:     в выражениях + и - являются дополнительными концами имени
1.250     moko      224: 
                    225:     можно обращаться к составным объектам так: $name.subname где subname бывает:
                    226:         строка
                    227:         $переменная
                    228:         строка$переменная
                    229:         [код, вычисляющий строку]
1.255     moko      230:     например: $хеш[$.возраст(88)] $достать[$.поле[возраст]] ^хеш.[$достать.поле].format{%05d}
1.249     moko      231: 
1.250     moko      232: параметры := один или много параметров
1.251     moko      233: параметр :=
1.250     moko      234:     (математическое выражение) вычисляется много раз внутри вызова,
                    235: |   [код] вычисляется один раз перед вызовом,
                    236: |   {код} вычисляется 0 или много раз внутри вызова,
1.259     moko      237:     допустимы ';' чтобы сделать много параметров в одних скобках
1.250     moko      238: 
                    239: void
                    240:     доступны все методы, присутствующие у объекта класса string, результат как у пустой строки
                    241:     ^void:sql{запрос без результата}{$.bind[см. table::sql]}
                    242: 
                    243: int,double
1.259     moko      244:     ^имя.int[]
                    245:         целочисленное значение
                    246:     ^имя.double[]
                    247:         double значение
                    248:     ^имя.bool[] ^name.bool(true|false)
                    249:         bool значение
1.250     moko      250:     ^имя.inc(на сколько +)
                    251:     ^имя.dec(на сколько -)
1.269     moko      252:     ^имя.++[] выводит значение, затем увеличивает на 1
                    253:     ^имя.--[] выводит значение, затем уменьшает на 1
1.250     moko      254:     ^имя.mul(на сколько *)
                    255:     ^имя.div(на сколько /)
                    256:     ^имя.mod(на сколько %)
                    257:     ^имя.format[формат]
                    258:     ^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]]
1.249     moko      259:         запрос, результат которого должен быть один столбец/одна строка
1.1       paf       260: 
1.250     moko      261: string
                    262:     в выражении
                    263:         def значение равно "не пуста?"
                    264:         логическое/числовое значение равно попытке преобразовывания к double,
                    265:             пустая строка тихо преобразуется к 0
1.249     moko      266:         пример:
                    267:         ^if(def $form:name) не пуста?
                    268:         ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?]
1.250     moko      269:     ^string:sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]]
1.249     moko      270:         результат запроса должен быть один столбец/одна строка
1.257     moko      271:     ^строка.int[] ^строка.int(default)
                    272:         целочисленное значение строки, если ломается преобразование, берётся default
                    273:     ^строка.double[] ^строка.double(default)
                    274:         double значение строки, если ломается преобразование, берётся default
                    275:     ^строка.bool[] ^строка.bool(default)
                    276:         bool значение строки, если ломается преобразование, берётся default
1.250     moko      277:     ^строка.format[формат] %d  %.2f %02d...
                    278:     ^строка.match[шаблон-строка|шаблон-regex][[опции поиска]]  $prematch $match $postmatch $1 $2...
1.249     moko      279:         опции поиска=
1.21      paf       280:         i CASELESS
                    281:         x whitespace in regex ignored
1.249     moko      282:         s singleline = $ считается концом всего текста
                    283:         m multiline = $ считается концом строки[\n], не концом всего текста
                    284:         g найти все вхождения, а не одно
                    285:         ' создавать столбцы prematch, match, postmatch
                    286:         n вернуть цисло с количеством найденных совпадений, а не таблицу с результатами
                    287:         U инвертировать смысл модификатора '?'
1.250     moko      288:     ^строка.match[шаблон-строка|шаблон-regex][опции поиска]{замена}
1.249     moko      289:         опции поиска+=
                    290:         g заменить все вхождения, а не одно
1.256     moko      291:     ^строка.split[разделитель|regex][[lrhva]][[название столбца для вертикального разбиения]]
1.249     moko      292:         l слева направо [default]
                    293:         r справа налево
                    294:         h nameless таблица с ключами 0, 1, 2, ...
                    295:         v таблица из 1 столбца 'piece' или как передадут [default]
1.256     moko      296:         a массив
1.250     moko      297:     ^строка.{l|r}split[разделитель] таблица из столбца $piece
1.249     moko      298:         оставлен для совместимости
1.250     moko      299:     ^строка.upper|lower[]
                    300:     ^строка.length[]
                    301:     ^строка.mid(P[;N])
1.249     moko      302:         без N - "до конца строки"
1.250     moko      303:     ^строка.left(N), -1 выдает всю строку
                    304:     ^строка.right(N)
                    305:     ^строка.pos[подстрока]
                    306:     ^строка.pos[подстрока](позиция, с которой ищем)
1.249     moko      307:         <0 = не найдено
1.272     moko      308:     ^строка.rpos[подстрока]
                    309:         последнее вхождение подстроки в строку
                    310:     ^строка.rpos[подстрока](максимальная позиция начала подстроки)
                    311:         последнее вхождение, которое начинается не правее позиции
                    312:         <0 = не найдено
1.250     moko      313:     ^строка.replace[$таблица_подстановок_строка_на_строку]
                    314:     ^строка.replace[$что;$на-что]
                    315:     ^строка.save[[append;]путь]
                    316:     ^строка.save[путь[;$.charset[в какой кодировке сохраняем] $.append(true)]]
1.257     moko      317:         сохраняет строку в файл
                    318:     ^строка.trim[start|both|end|left|right[;chars]]
                    319:         выкидывает chars из начала/конца/и начала и конца
1.259     moko      320:         default 'chars' = whitespace chars
1.257     moko      321:     ^строка.trim[chars]
                    322:         выкидывает chars из начала и конца
1.254     moko      323:     ^строка.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ] encode
1.259     moko      324:     ^string:base64[encoded[; $.pad(bool) $.strict(bool) $.url-safe(bool) ]] decode
1.250     moko      325:     ^строка.idna[]
                    326:         IDNA кодирование, поддержка кириллических доменов
                    327:     ^string:idna[encoded]
                    328:         IDNA декодирование, поддержка кириллических доменов
1.257     moko      329:     ^строка.js-escape[]
                    330:         кодирование для передачи в JS (%uXXXX)
                    331:     ^string:js-unescape[escaped]
                    332:         декодирование переданного из js
                    333:     ^string:unescape[js|uri;escaped; $.charset[] ]
                    334:         декодирование переданного из js или uri
                    335:     ^строка.contains[ключ]
                    336:         для совместимости с hash
1.255     moko      337: 
1.251     moko      338: table
                    339:     в выражении
1.249     moko      340:         логическое значение равно "не пуста?"
                    341:         числовое значение равно count[]
1.257     moko      342:     $таблица.поле
                    343:     $таблица.поле[новое значение]
                    344:     $таблица.fields
                    345:         из named таблицы выдаёт текущую запись как Hash
1.251     moko      346:     ^table::create[[nameless]]{данные}[[$.separator[^#09] $.encloser[]]]
                    347:     ^table::create[table][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
                    348:         клонирует таблицу
                    349:         reverse - в обратном порядке
                    350:     ^table::load[[nameless;]путь[;опции]]
                    351:         если не nameless, названия колонок берутся из первой строки
                    352:         пустые строки, и строки в первой колонке содержащие '#', игнорируются
                    353:         $.separator[^#09]
1.259     moko      354:         $.encloser["] по-умолчанию, нет
1.251     moko      355:     ^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash]]]
1.249     moko      356:         bind привязывает переменные в запросе к их значениям
                    357:         пока реализован только для oracle
                    358:         в запросе надо написать ":имя"
1.251     moko      359:         в параметре bind передать hash, из которого возьмётся (или куда запишется) значение
                    360:     ^таблица.save[[nameless|append;]путь[;опции, см. load]]
1.257     moko      361:         сохраняет таблицу в файл
1.251     moko      362:     ^таблица.menu{тело}[[разделитель]]
1.257     moko      363:         выполняет код тела для каждой строки таблицы
1.251     moko      364:     ^таблица.foreach[позиция;значение]{тело}[[разделитель]]
1.257     moko      365:     ^таблица.line[]
                    366:         текущий ряд таблицы, начинается с 1
                    367:     ^таблица.offset[]
                    368:         смещение текущего ряда таблицы от начала, начинается с 0
                    369:     ^таблица.offset[[whence]](5) 
                    370:         сдвигает whence=cur|set, без whence - это cur
                    371:     ^таблица.count[], ^таблица.count[rows]
                    372:         количество строк в таблице
                    373:     ^таблица.count[columns]
                    374:         количество столбцов таблицы
                    375:     ^таблица.count[cells]
                    376:         количество ячеек в текущей строке таблицы
1.251     moko      377:     ^таблица.sort{{ключеделатель строка}|(ключеделатель число)}[{desc|asc}] default=asc
                    378:     ^таблица.append{данные}
                    379:     ^таблица.append[ $.имя столбца[значение столбца] ]
                    380:     ^таблица.insert{данные} добавить запись на текущую позицию
                    381:     ^таблица.insert[ $.имя столбца[значение столбца] ]
1.259     moko      382:     ^таблица.delete[]
                    383:         стирает запись с текущей позиции
1.257     moko      384:     ^таблица.join[таблица][$.limit(1) $.offset(5) $.offset[cur]]
                    385:         добавляет записи из таблицы, таблицы должны иметь одинаковую структуру
                    386:     ^таблица.flip[]
                    387:         выдаёт транспонированную
1.251     moko      388:     ^таблица.locate[поле;значение][[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
1.249     moko      389:         передвигает текущую строку, если найдёт. выдаёт bool
1.251     moko      390:     ^таблица.locate(логическое выражение)[[$.limit(1) $.offset(5) $.offset[cur] $.reverse(1)]]
1.249     moko      391:         передвигает текущую строку, если найдёт. выдаёт bool
1.251     moko      392:     ^таблица.hash{[поле]|{код}|(выражение)}[[поле значений|table поля значений]{код значения}][[$.distinct(1) $.distinct[tables] $.type[hash]]]
                    393:         по умолчанию значением $hash.ключ будет hash в котором поля значений будут ключами
1.249     moko      394:         поля значений могут быть не указаны, тогда ими будут все столбцы, включая ключевой
                    395:         если distinct содержит true, то не будет ошибки при повторяющихся ключах
                    396:         если distinct содержит tables, то будет создан hash из таблиц, содержащих строки с ключом
1.251     moko      397:         $.type[string/table] поменять значение элемента на строку (указать одну колонку) или таблицу
1.257     moko      398:     ^таблица.columns[[название столбца]]
                    399:         таблица из одного столбца 'column' или как передадут
                    400:     ^таблица.cells[], ^таблица.cells(лимит)
                    401:         выдает массив ячеек текущей строки
                    402:     ^таблица.array[]
                    403:         возвращает массив, элементами которого являются хеши, отображающие данные каждой строки
                    404:     ^таблица.array[колонка]
                    405:         возвращает массив значений указанной колонки
                    406:     ^таблица.array{код}
                    407:         возвращает массив результатов выполнения переданного кода для каждой строки таблицы
                    408:     ^таблица.rename[название столбца;новое навание столбца] ^таблица.rename[ $.название столбца[новое навание столбца] ]
                    409:         переименовывает столбец или столбцы
                    410:     $отобранное[^таблица.select(выражение)]
                    411:         таблица из тех столбцов и строк, у которых условие совпало
1.86      paf       412:         $adults[^man.select($man.age>=18)]
1.249     moko      413:     ^таблица.color[цвет1;цвет2]
1.257     moko      414:         чередует цвет1 и цвет2 последовательно для каждого ряда
1.1       paf       415: 
1.251     moko      416: hash
                    417:     в выражении
                    418:         логическое значение равно "не пуст?", хеш с _default уже не пуст
                    419:         числовое значение равно count[]
                    420:     $хеш.ключ
1.253     moko      421:         _default - специальный ключ, если задан,
1.251     moko      422:         то при обращении по ключу, которому нет соответствия, выдаётся _default значение
1.259     moko      423:     $хеш.fields
                    424:         выдает $hash, чтобы класс hash был чуть больше похож на класс table
1.251     moko      425:     ^hash::create[[|copy_from_hash|copy_from_hashfile]]
1.249     moko      426:         создаёт новый hash, копию старого
1.251     moko      427:     ^хеш.add[слагаемое]
1.249     moko      428:         перезаписывает одноимённые
1.251     moko      429:     ^хеш.sub[вычитаемое]
1.257     moko      430:     ^хеш.union[b]
                    431:         объединение, одноимённые остаются
                    432:     ^хеш.intersection[b][[$.order[self|arg]]]
                    433:         пересечение, новый хеш, order задает порядок элементов (как в исходном хеше или хеше-параметре)
1.251     moko      434:     ^хеш.intersects[b] = bool
                    435:     ^hash::sql{запрос}[[$.distinct(1) $.limit(2) $.offset(4) $.type[hash|string|table]]]
                    436:         получается hash(ключи=значения первая колонка ответа) of hash(ключи=названия остальных колонкок ответа) или
1.255     moko      437:         string=значение каждого элемента - строка, при этом надо указать ровно два столбца или
1.251     moko      438:         table=значение каждого элемента - таблица
1.259     moko      439:     ^хеш.keys[[название колонки с ключами]]
                    440:         таблица из одного столбца key или как передадут
1.251     moko      441:     ^хеш.count[]
                    442:     ^хеш.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
1.257     moko      443:     ^хеш.delete[ключ]
                    444:         удалить ключ
1.263     moko      445:     ^хеш.contains[ключ]
1.257     moko      446:         существует ли в хеше ключ (bool)
1.255     moko      447:     ^хеш.at[first|last][[key|value|hash]]
                    448:     ^хеш.at([-]N)[[key|value|hash]]
1.249     moko      449:         доступ к заданным элементам упорядоченного хеша
1.256     moko      450:     ^хеш.set[first|last;значение]
                    451:     ^хеш.set([-+]N)[значение]
1.257     moko      452:         устанавливает значение заданного элемента упорядоченного хеша
1.256     moko      453:     ^хеш.rename[старый_ключ;новый_ключ]
                    454:     ^хеш.rename[ $.старый_ключ[новый_ключ] ... ]
1.257     moko      455:         переименовывает заданные ключи хеша
1.266     moko      456:     ^хеш.array[[keys|values]]
                    457:         эквивалентен ^array::copy[$хеш] или возвращает массив ключей или значений хеша
1.255     moko      458:     ^хеш.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc
1.254     moko      459:     $обратный_хеш[^хеш.reverse[]]
1.257     moko      460:     $отобранное[^хеш.select[key;value](выражение)[ $.limit(N) $.reverse(bool) $.default(bool) ]]
                    461:         хеш из ключей и значений, для которых условие истинно
1.255     moko      462: 
1.252     moko      463: hashfile
                    464:     ^hashfile::open[filename]
1.259     moko      465:     ^хешфайл.clear[]
                    466:         забыть всё
                    467:     $хешфайл.ключ[значение]
                    468:         положить значение
1.252     moko      469:     $хешфайл.ключ[$.value[значение] $.expires[ЗНАЧЕНИЕ]}
1.259     moko      470:         положить значение до expires
                    471:         значение поля expires может быть date, или число дней(0дней=на вечно)
1.252     moko      472:     $хешфайл.ключ  достать
                    473:     ^хешфайл.delete[ключ]  удалить ключ
                    474:     ^хешфайл.delete[]  удалить файлы, содержащие данные
                    475:     ^хешфайл.hash[]
1.249     moko      476:         преобразовать в обычный hash
                    477:         попутно стирает устаревшие пары
1.252     moko      478:     ^хешфайл.foreach[key;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
                    479:     ^хешфайл.release[]
1.259     moko      480:         записать данные и снять блокировки
                    481:         при повторном обращении к элементам откроется автоматически
                    482:     ^хешфайл.cleanup[]
                    483:         пробежаться по всем элементам и удалить устаревшие.
1.132     paf       484: 
1.249     moko      485:     пример:
1.170     paf       486:     $sessions[^hashfile::open[/db/sessions]]
                    487:     $sid[^math:uuid[]]
                    488:     $sessions.$sid[$.value[$uid] $.expires(1)]
                    489:     $uid[$sessions.$sid]
1.132     paf       490: 
1.255     moko      491: array
                    492:     в выражении
                    493:         логическое значение равно "не пуст?"
                    494:         числовое значение равно count[]
                    495:     $массив.индекс, $массив.(выражение)
                    496:         возврат значения по заданному индексу
                    497:     $массив.индекс[значение], $массив.(выражение)[значение]
                    498:         присваивание значения по индексу
                    499:     $массив[значение;значение;...]
                    500:         создание массива с заданными значениями
                    501:     ^array::create[]
                    502:     ^array::create[значение;значение;...]
                    503:         создание массива с заданными значениями или пустого массива
                    504:     ^array::copy[копируемый массив или хеш с цифровыми ключами]
                    505:         копирование массива или хеша с цифровыми ключами
                    506:     ^массив.add[добавляемый массив или хеш с цифровыми ключами]
                    507:         добавление элементов из другого массива или хеша с перезаписью значений у совпадающих индексов
                    508:     ^массив.join[добавляемый массив или произвольный хеш]
                    509:         добавление элементов другого массива или хеша в конец массива
                    510:     ^массив.append[значение;значение;...]
                    511:         добавление элементов в конец массива
                    512:     ^массив.insert(индекс)[значение;значение;...]
                    513:         вставка элементов в указанную позицию массива
                    514:     ^массив.left(n)
                    515:         возвращает новый массив из n первых элементов массива
                    516:     ^массив.right(n)
                    517:         возвращает новый массив из n последних элементов массива
                    518:     ^массив.mid(m;n)
                    519:         возвращает новый массив, содержащий n инициализированных элементов массива, начиная с позиции m
                    520:     ^массив.delete(index)
                    521:         удаление элемента массива с оставлением пустого места
                    522:     ^массив.remove(index)
                    523:         удаление элемента со сдвигом последующих элементов на его место
                    524:     ^массив.push[значение]
                    525:         добавление элемента в конец массив
                    526:     ^массив.pop[]
                    527:         возвращает последний элемент и удаляет его из массива
1.263     moko      528:     ^массив.contains(индекс)
1.255     moko      529:         существует ли в массиве элемент по переданому индексу (bool)
                    530:     ^array::sql{запрос}[[ $.sparse(false) $.distinct(false) $.limit(2) $.offset(4) $.type[hash|string|table]]]
                    531:         создание массива на основе выборки из базы данных
                    532:         $.sparse(false), по умолчанию - создать обычный массив. Значения строк выборки последовательно добавляются в массив
                    533:         $.sparse(true) - создать разреженный массив. Первая колонка данных должна содержать индексы,
                    534:         по которым будут размещены значения (аналогично ^hash::sql{})
                    535:         получается array of hash (ключи=названия остальных колонкок ответа) или
1.259     moko      536:         string = значение каждого элемента - строка, при этом надо указать ровно два столбца или
                    537:         table = значение каждого элемента - таблица
1.255     moko      538:     ^массив.keys[[название колонки с ключами]]
                    539:         таблица из одного столбца key или переданного названия с индексами инициализированных элементов массива
                    540:     ^массив.count[]
                    541:         количество инициализированных элементов массива
                    542:     ^массив.count[all]
                    543:         общее количество элементов массива, включая неинициализированные
                    544:     ^массив.foreach[index;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
                    545:         перебирает все инициализированные элементы массива
                    546:     ^массив.for[index;value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
                    547:         перебирает все элементы массива
                    548:     ^массив.at[first|last][[key|value|hash]]
                    549:     ^массив.at([-]число)[[key|value|hash]]
                    550:         доступ к элементу массива по порядковому номеру
                    551:     ^массив.set[first|last][значение]
                    552:     ^массив.set([-]число)[значение]
                    553:         установка значения элемента массива по порядковому номеру
                    554:     ^массив.compact[]
                    555:         удаление неинициализированных элементов массива
                    556:     ^массив.compact[undef]
                    557:         удаление неинициализированных и пустых элементов массива
                    558:     ^массив.sort[key;value]{{ключеделатель строка}|(ключеделатель число)}[[desc|asc]] default=asc
                    559:         сортировка массива
                    560:     $обратный_массив[^массив.reverse[]]
                    561:         возвращает новый массив из элементов исходного в обратном порядке
                    562:     $отобранное[^массив.select[key;value](выражение)[ $.limit(N) $.reverse(bool) ]]
                    563:         отбор элементов массива, для которых условие истинно
                    564: 
1.261     moko      565: date
                    566:     время типа date можно использовать в выражениях, подставляет количество дней с epoch [1 января 1970 (UTC)], дробное
                    567:     строковое значение в местном времени, численное в UTC, диапазон от 0000-00-00 00:00:00 до 9999-12-31 23:59:59
                    568:     по умолчанию используется установленная средствами OS временная зона
                    569: 
                    570:     ^date::now[]
                    571:     ^date::now(смещение в днях)
                    572:         выдаёт сейчас+смещение
                    573:     ^date::today[]
                    574:         дата на 00:00:00 текущего дня
                    575:     ^date::today(целочисленное смещение в днях)
                    576:         дата на 00:00:00 текущего дня+смещение
                    577:     ^date::create(дней с epoch)
                    578:     ^date::create(year;month[;day[;hour[;minute[;second[;TZ]]]]])
                    579:     ^date::create[дата в формате %Y-%m-%d %H:%M:%S]
                    580:         для удобного создания по значению из базы
                    581:         формат1: %Y[-%m[-%d[ %H[:%M[:%S]]]]]
                    582:         формат2: %H:%M[:%S]
                    583:     ^date::create[дата в формате %Y-%m-%dT%H:%M[:%S]TZ]
                    584:         для создания по значению в формате ISO 8601
                    585:         формат TZ: Z(UTC) или +-hour[:minute] (смещение от UTC)
                    586:     ^date::unix-timestamp()
                    587:     ^дата.unix-timestamp[]
                    588:     $дата.year month day hour minute second weekday yearday(0...) daylightsaving TZ weekyear
                    589:         TZ="" << локальная зона
                    590:     $дата.year month day hour minute second можно задать новое значение, остальные read only
                    591:     ^дата.double[] ^дата.int[]
                    592:         количество дней с epoch [1 января 1970 (UTC)], дробное или целое
                    593:     ^дата.roll[year|month|day](+-смещение)
                    594:         сдвигает дату
                    595:     ^дата.roll[TZ;Новая зона]
                    596:         говорит, что дата в таком-то часовом поясе: влияет на .hour & Co
                    597:     ^date:roll[TZ;Новая зона]
                    598:         говорит, что по умолчанию все даты в таком-то часовом поясе
                    599:     ^дата.sql-string[[datetime|date|time]]
                    600:         datetime или без параметра - %Y-%m-%d %H:%M:%S
                    601:         date                       - %Y-%m-%d
                    602:         time                       - %H:%M:%S
                    603:         where published='^дата.sql-string[]'
1.267     moko      604:     ^date:sql-string[[datetime|date|time]]
                    605:         sql-string для сейчас
1.261     moko      606:     ^date:calendar[rus|eng](год;месяц)
                    607:         выдаёт неименованную таблицу, столбцы: 0..6, week, year
                    608:     ^date:calendar[rus|eng](год;месяц;день)
                    609:         выдаёт именнованную таблицу, столбцы: year, month, day, weekday
                    610:     ^date:last-day(год;месяц)
                    611:         вернёт последний день месяца
                    612:     ^дата.last-day[]
                    613:         вернёт последний день месяца $дата
                    614:     ^дата.gmt-string[]
                    615:         Fri, 23 Mar 2001 09:32:23 GMT
1.267     moko      616:     ^date:gmt-string[]
                    617:         gmt-string для сейчас
1.261     moko      618:     ^дата.iso-string[]
                    619:         2001-03-23T12:32:23+03
1.267     moko      620:     ^date:iso-string[]
                    621:         iso-string для сейчас
1.261     moko      622: 
                    623: file
                    624:     $файл_из_post.name
                    625:     $файл_из_post.size
                    626:     $файлt_из_post.text
1.266     moko      627:     ^файл.save[text|binary;имя файла[;$.charset[в какой кодировке сохраняем] $.append(false)]]
1.261     moko      628:     ^file:delete[имя файла]
1.272     moko      629:     ^file:rmdir[имя каталога[; $.exception(false) ]]
                    630:         удаляет пустой каталог
1.261     moko      631:     ^file:find[имя файла][{когда не нашли}]
                    632:     ^file:list[путь[;шаблон-строка|шаблон-regex]]
                    633:         table с колонками name dir
                    634:     ^file:list[путь;$.filter[шаблон-строка|шаблон-regex] $.stat(true)]
                    635:         table с колонками name dir size [mca]date
                    636:     ^file::load[text|binary;big.zip[;domain_press_release_2001_03_01.zip][;опции]]
                    637:     ^file::create[text|binary;имя;data]
                    638:     ^file::create[text|binary;имя;data[;$.charset[кодировка букв в создаваемом файле] $.content-type[...]]]
                    639:     ^file::create[string-or-file-content[;$.name[имя] $.mode[text|binary] $.content-type[...] $.charset[...]]]
                    640:     $файл_который_был_loaded.size
                    641:     $файл_который_был_loaded_или_created.mode = text/binary
                    642:     ^file::stat[имя файла]
                    643:     $файл_который_был_stated_или_loaded.size .adate .mdate .cdate
                    644:     ^file::cgi[[text|binary;]имя файла[;env hash +options[;1cmd[;2line[;3ar[;4g[;5s]]]]]]]
                    645:         любой аргумент может быть строкой или массивом строк
                    646:         возвращённый заголовок рассыпается на $поля
                    647:         $status
                    648:         $stderr
                    649:     ^file::exec[[text|binary;]имя файла[;env hash[;1cmd[;2line[;3ar[;4g[;5s;...under unix max 50 args]]]]]]]
                    650:         любой аргумент может быть строкой или массивом строк
                    651:         options:
                    652:             $.stdin[текст|файл] если пусто, отключается автоматическое пересовывание данных HTTP-POST
                    653:     ^file:move[старое имя файла;новое имя файла]
1.272     moko      654:         можно переименовывать и двигать файлы и каталоги, но не через границу дисков
                    655:         существующий файл заменяется, а при перемещении каталога заменяется и пустой каталог
1.261     moko      656:         каталоги для dest создаются с правами 775
                    657:         каталог старого файла стирается, если после move он остаётся пуст
                    658:     ^file:copy[имя файла;имя копии файла[; $.append(1) ]]
                    659:         можно копировать только файлы
                    660:     ^file:lock[имя файла]{код}
                    661:         файл при необходимости создаётся
                    662:         блокируется
                    663:         выполняется код
                    664:         разблокируется
                    665:     ^file:dirname[/a/some.tar.gz|file]=/a (работает аналогично комманде *nix)
                    666:     ^file:dirname[/a/b/|file]=/a (работает аналогично комманде *nix)
                    667:     ^file:basename[/a/some.tar.gz|file]=some.tar.gz (работает аналогично комманде *nix)
                    668:     ^file:basename[/a/b/|file]=b (работает аналогично комманде *nix)
                    669:     ^file:justname[/a/some.tar.gz|file]=some.tar
                    670:     ^file:justext[/a/some.tar.gz|file]=gz
                    671:     /some/page.html: ^file:fullpath[a.gif] => /some/a.gif
                    672:     ^файл.sql-string[]
                    673:         внутри ^connect даст правильно escaped строку, которую можно в запрос отдать
                    674:     ^file::sql{query}[[ $.name[имя_файла_для_download] $.content-type[пользовательский content-type] ]]
                    675:         результат запроса должен быть "одна строка".
                    676:         колонки:
                    677:         первая колонка - данные
                    678:         если есть вторая - это имя файла
                    679:         если есть третья - это content-type
                    680:     ^файл.base64[ $.pad(bool) $.wrap(bool) $.url-safe(bool) ]
                    681:         encode
                    682:     ^file:base64[имя файла[; $.pad(bool) $.wrap(bool) $.url-safe(bool) ]]
                    683:         encode
                    684:     ^file::base64[encoded string[; $.pad(bool) $.strict(bool) url-safe(bool) ]]
                    685:         decode
                    686:     ^file::base64[mode;имя файла;encoded string[; $.content-type[...] $.pad(bool) $.strict(bool) url-safe(bool) ]]
                    687:         decode
                    688:     ^file:crc32[имя файла]
                    689:         вычисляет crc32 файла с указанным именем
                    690:     ^файл.crc32[]
                    691:         вычисляет crc32 объекта
                    692:     ^файл.md5[], ^file:md5[имя файла]
                    693:         выдает digest файла, длиной 16 байт в виде строки,
                    694:         где байты digest выданы в hex виде, впритык, в нижнем регистре
                    695: 
                    696: image
                    697:     $картинка[^image::measure[DATA[; $.exif(bool) $.xmp(bool) $.xmp-charset[] $.video(bool) ]]]
                    698:         смотрит на .ext case insensitive,
                    699:         умеет мерить gif, jpg, tiff, bmp, webp и mp4 (mov)
                    700:     $картинка.exif << hash после measure jpeg с exif информацией и $.exif(true)
                    701:         $image.exif.DateTime & co
                    702:             [полный список см. https://exiftool.org/TagNames/EXIF.html]
                    703:         числа типа int/double,
                    704:         даты типа dateб
                    705:         перечисления в виде hash с ключами 0..count-1
                    706:     $картинка.src .width .height
                    707:     $картинка.line-width  число=ширина линий
                    708:         $картинка.line-style строка=стиль линий '*** * '='*** * *** * *** * '
                    709:     ^картинка.html[[hash]]
                    710:         <img ...>
                    711:     ^image::load[фон.gif]
                    712:         только gif пока
                    713:     ^image::create(размер X;размер Y[;цвет фона default белый]])
                    714:     ^картинка.line(x0;y0;x1;y1;0xffFFff)
                    715:     ^картинка.fill(x;y;0xffFFff)
                    716:     ^картинка.rectangle(x0;y0;x1;y1;0xffFFff)
                    717:     ^картинка.bar(x0;y0;x1;y1;0xffFFff)
                    718:     ^картинка.replace(hex-цвет1;hex-цвет2)[table x:y вершины_многоугольника]
                    719:     ^картинка.polyline(цвет)[table x:y точки]
                    720:     ^картинка.polygon(цвет)[table x:y вершины_многоугольника]
                    721:     ^картинка.polybar(цвет)[table x;y вершины_многоугольника]
                    722:     ^картинка.font[набор_букв;имя_файла_шрифта.gif][(ширина_пробела[;ширина_символа])]
                    723:         высота символа = высота картинки/количество букв в наборе
                    724:         если указана ширина_символа, то monospaced, если 0, то ширина_символа = ширине gif
                    725:     ^картинка.font[набор_букв;имя_файла_шрифта.gif;
                    726:         $.space(ширина_пробела)             // по умолчанию = ширине gif
                    727:         $.width(ширина_символа)             // см. выше, по умолчанию proportional
                    728:         $.spacing(расстояние между буквами) // по умолчанию = 1
                    729:     ]
                    730:     ^картинка.text(x;y)[текст_надписи] AS_IS
                    731:     ^картинка.length[текст_надписи] AS_IS
                    732:     ^картинка.gif[возможно, имя файла]
                    733:         кодирует в FILE с content-type=image/gif имя файла будет использовано при $response:download
                    734:     ^картинка.arc(center x;center y;width;height;start in degrees;end in degrees;color)
                    735:     ^картинка.sector(center x;center y;width;height;start in degrees;end in degrees;color)
                    736:     ^картинка.circle(center x;center y;r;color)
                    737:     ^картинка.copy[source](src x;src y;src w;src h;dst x;dst y[;dest w[;dest h[;tolerance]]])
                    738:         при заданных dest_w/dest_h делает изменение размера кусочка
                    739:             при уменьшении делает resample
                    740:             годится только для уменьшения простой[малоцветной] дребедени вроде графиков/pie,
                    741:             для thumbnais не годится
                    742:         при не указанном dest_h сохраняет aspect ratio
                    743:         tolerance - некое число[квадрат расстояния в RGB пространстве до искомого цвета],
                    744:         определяющее прожорливость выделялки цветов из палитры [default=150]
                    745:             меньше - точнее приближает цвета, но они быстро кончаются
                    746:             больше - неточно приближает цвет, но большей части хватит
                    747:     ^картинка.pixel(x;y)[(color)]
                    748:         узнать или задать цвет пиксела
                    749: 
                    750: regex
                    751:     в выражении
                    752:         логическое значение всегда равно true
                    753:         числовое значение равно количеству байт скомпилированного шаблона
                    754:     ^regex::create[шаблон-строка|regex][[опции поиска]]
                    755:     ^шаблон.size[]
                    756:         количество байт скомпилированного шаблона
                    757:         если значение очень большое - стоит почитать документацию по pcre и, возможно, переписать шаблон
                    758:     ^шаблон.study_size[]
                    759:         размер study-структуры. если==0 - шаблон не может быть "изучен"
                    760:     $шаблон.pattern
                    761:         текст шаблона
                    762:     $шаблон.options
                    763:         строка с исходным текстом опций
                    764: 
1.270     moko      765: amqp
                    766:     ^amqp::create[[
                    767:         $.host[localhost] $.port(5672) $.user[guest] $.password[guest] $.vhost[/] $.locale[en_US]
                    768:         $.heartbeat(30) $.auto_reconnect(секунд)
                    769:         $.tls[ $.ca[файл] $.cert[файл] $.key[файл] $.verify(true) ]
                    770:     ]]
                    771:         подключается к брокеру RabbitMQ
                    772:         auto_reconnect(N): после потери соединения переподключиться перед следующей операцией, выждав N секунд
                    773:         tls: сертификат сервера проверяется, только если задан ca
                    774:     ^amqp.publish[сообщение][[
                    775:         $.exchange[] $.routing_key[ключ]|$.queue[имя] $.mandatory(false)
                    776:         свойства сообщения: $.content_type[] $.content_encoding[] $.delivery_mode(1|2) $.priority(N) $.correlation_id[] $.reply_to[]
                    777:             $.expiration[] $.message_id[] $.timestamp(N) $.type[] $.user_id[] $.app_id[] $.cluster_id[] $.headers[хеш]
                    778:     ]]
                    779:     ^amqp.consume[ $.queue[имя] $.ack(true) $.count(1) $.timeout(0) $.exclusive(false) $.consumer_tag[] ]
                    780:         массив сообщений, готовых за timeout секунд (ждётся только первое)
                    781:     ^amqp.consume[ $.queue[имя] $.callback[$метод] ... ]
                    782:         вызывает @метод[сообщение] для каждого сообщения до ^amqp.stop_consume[], count сообщений или timeout секунд без сообщений
                    783:         count и timeout по умолчанию не ограничены
                    784:     сообщение: хеш с msg, delivery_tag, routing_key, exchange, redelivered, consumer_tag и заданными свойствами
                    785:     ^amqp.ack(delivery_tag)
                    786:         при $.ack(true) (по умолчанию) полученные сообщения нужно подтверждать
                    787:     ^amqp.nack(delivery_tag)[ $.requeue(false) ]
                    788:     ^amqp.reject(delivery_tag)[ $.requeue(true) ]
                    789:     ^amqp.qos[ $.prefetch_count(N) ]
                    790:     ^amqp.declare[ $.queue[имя] $.durable(false) $.exclusive(false) $.auto_delete(false) $.passive(false) $.arguments[хеш] ]
                    791:         для пустого имени сервер создаёт очередь со своим именем, оно возвращается
                    792:     ^amqp.declare[ $.exchange[имя] $.type[direct] $.durable(false) $.auto_delete(false) $.internal(false) $.passive(false) $.arguments[хеш] ]
                    793:     ^amqp.delete[ $.queue[имя]|$.exchange[имя] $.if_unused(false) $.if_empty(false) ]
                    794:     ^amqp.bind[ $.exchange[имя] $.queue[имя] $.routing_key[] ]
                    795:     ^amqp.unbind[ $.exchange[имя] $.queue[имя] $.routing_key[] ]
                    796:     ^amqp.purge[ $.queue[имя] ]
                    797:         число удалённых сообщений
                    798:     ^amqp.info[ $.queue[имя] ]
                    799:         хеш с queue, messages, consumers
                    800:     ^amqp.release[]
                    801:         закрывает соединение
                    802:     значения в arguments и headers: [строка], (число), (true|false)
                    803: 
1.261     moko      804: console
                    805:     $console:timeout
                    806:     $console:line
                    807:         read/write строку
                    808: 
                    809: cookie
                    810:     $cookie:имя считать старое или свежезаданное
                    811:     $cookie:имя[значение] на 90 дней
                    812:     $cookie:имя[$.value[значение] $.expires[ЗНАЧЕНИЕ] $.secure(true) $.domain[имя домена] $.httponly(true)]
                    813:         значение поля expires может быть 'session', date, или число дней (0дней=session)
                    814:         если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
                    815:     $cookie:fields
                    816:         hash со всеми cookies
                    817: 
1.262     moko      818: curl
                    819:     ^curl:load[[
                    820:         $.url[http://URL]
                    821:         $.timeout(N)
                    822:         $.ssl_verifypeer(0)
                    823:         $.mode[text|binary] тип создаваемого файла
                    824:     ]]
                    825:         загружает файл с удалённого сервера, можно вызывать многократно в одной сессии,
                    826:         можно указать любую опцию libcurl, имена опций строчными буквами без префикса CURLOPT_
                    827:     ^curl:options[[
                    828:         $.library[libcurl.so.4]
                    829:         $.charset[UTF-8]
                    830:         ...
                    831:     ]]
                    832:         последующие вызовы ^curl:load наследуют заданные опции, путь к libcurl задаётся до начала использования curl
                    833:     ^curl:session{код}
                    834:         создаёт cURL-сессию, можно задать общие опции, сделать несколько загрузок
                    835:     ^curl:info[название], ^curl:info[]
                    836:         информация о последнем запросе (значение или хеш)
                    837:     ^curl:version[]
                    838:         версия используемой библиотеки cURL
                    839: 
1.261     moko      840: env
                    841:     $env:переменная
                    842:     $env:fields хеш с переменными окружения
                    843:     $env:PARSER_VERSION версия парсера
                    844: 
1.252     moko      845: form
1.249     moko      846:     [берётся первый элемент из одноимённых из GET, потом первый из POST]
1.257     moko      847:     $form:поле
                    848:         string/file
                    849:     $form:nameless
                    850:         поле со значением поля без имени "?value&...", "...&value&...", "...&value"
                    851:     $form:qtail
                    852:         строка со значением текста после второго "?xxxxx", если там не было ',' [imap]
                    853:     $form:fields
                    854:         hash со всеми полями формы
                    855:     $form:elements.поле
                    856:         array со всеми значениями поля - как строковыми, так и файловыми
                    857:     $form:tables.поле
                    858:         table с одним столбцом "field" со значениями "поля", для множественных значений
                    859:     $form:files.поле
                    860:         hash со значениями полей типа файл, ключи - 0, 1, ..., значение - файл
                    861:     $form:imap
                    862:         хеш с ключами 'x' и 'y' со значением ?1,2 приписки при использовании server-site image map
1.1       paf       863: 
1.261     moko      864: inet
                    865:     ^inet:ntoa(long)
                    866:     ^inet:aton[IP]
                    867:     ^inet:name2ip[name][[ $.ipv[4|6|any] $.table(true) ]]
                    868:         прямое преобразование имени в IP адрес
                    869:     ^inet:ip2name[ip][ $.ipv[4|6|any] ]]
                    870:         обратное преобразование из IP адреса в имя
                    871:     ^inet:hostname[]
                    872:         имя хоста
1.252     moko      873: 
1.261     moko      874: json
                    875:     ^json:parse[-json-строка-[;
                    876:         $.depth(максимальная глубина, default == 19)
                    877:         $.double(false)              отключить встроенный парсинг чисел с плавающей точкой (по умолчанию включен)
                    878:                                      в этом случае они попадут в результирующий объект как строки
                    879:         $.int(false)                 отключить встроенный парсинг целых чисел (по умолчанию включен)
                    880:                                      в этом случае они попадут в результирующий объект как строки
                    881:         $.distinct[first|last|all]   как будет происходить разбор дублирующихся ключей у объектов
                    882:                                      first - будет оставлен первый встретившийся элемент
                    883:                                      last  - будет оставлен последний встретившийся элемент
                    884:                                      all   - будут оставлены все элементы. при этом элементы, начиная со 2
                    885:                                               получат числовые суффиксы (key_2 итд)
                    886:                                      по умолчанию дублирующиеся ключи приведут к exception
                    887:         $.object[method-junction]    пользовательский метод[ключ;объект], которому будут передаваться все разобранные 
                    888:                                      объекты и ключи объекта, метод возвращает новый объект
                    889:         $.array[method-junction]     пользовательский метод, которому будут передаваться массивы
                    890:         $.taint[язык преобразования] задаёт язык преобразования для всех строк результата
                    891:     ]]
                    892:         парсит json-строку в хеш
1.252     moko      893: 
1.261     moko      894:     ^json:string[system or user object[;
                    895:         $.skip-unknown(false)    отключить exception и выдавать 'null' при сериализации объектов с типами
                    896:                                  отличных от void, bool, string, int, double, date, table, hash и file
                    897:         $.indent(true)           форматировать результирующую строку табуляциями по глубине вложенности
                    898:         $.date[sql-string|gmt-string|iso-string|unix-timestamp]
                    899:                                  формат вывода даты, по умолчанию -- sql-string
                    900:         $.table[object|array|compact]
                    901:                                  формат вывода таблицы, по умолчанию -- object
                    902:                                  object: [{"c1":"v11","c2":"v12",...},{"c1":"v21","c2":"v22",...},...]
                    903:                                  array:  [["c1","c2",...] || null (for nameless),["v11","v12",...],...]
                    904:                                  compact:  ["v11" || ["v11","v12",...],...]
                    905:         $.file[text|base64|stat] вывести тело файла в указанном виде (по умолчание тело файла 
                    906:                                  не попадает в output)
                    907:         $.xdoc[hash]             параметры преобразования xdoc в строку (как в ^xdoc.string[])
                    908:         $.тип[method-junction]   любой тип можно вывести с помощью пользовательского метода, который 
                    909:                                  должен принимать 3 параметра: ключ, объект данного типа и опции 
                    910:                                  вызова ^json:string[]
                    911:         $._default[метод]        пользовательский метод, будет вызываться для вывода всех объектов пользовательских
                    912:                                  классов. Метод должен принимать 3 параметра: ключ, объект и опции вызова.
                    913:         $._default[имя метода]   имя пользователького метода, при его наличии он будет вызван для сериализации
                    914:         $.void[null|string]      неопределенное значение будет выдано в виде null (по умолчанию)
                    915:                                  или пустой строки
                    916:     ]]
                    917:         сериализует системный или пользовательский объект в json-строку
1.220     misha     918: 
1.252     moko      919: mail
                    920:     $mail.received=MESSAGE:
1.51      paf       921:         .from
                    922:         .reply-to
                    923:         .subject
1.249     moko      924:         .date класса date
1.51      paf       925:         .message-id
                    926:         .raw[
1.249     moko      927:             .СЫРОЕ_ПОЛЬЗОВАТЕЛЬСКОЕ-ПОЛЕ-ЗАГОЛОВКА
1.51      paf       928:         ]
1.249     moko      929:         $.{text|html|file#}[ << нумеруется как и в mail:send (text, text2, ...) (file, file2, ...)
1.51      paf       930:             $.content-type[
                    931:                 $.value[{text|...|x-unknown}/{plain|html|...|x-unknown}]
1.249     moko      932:                 [$.charset[windows-1251]] << в каком пришло, сейчас уже перекодировано
                    933:                 $.ПОЛЬЗОВАТЕЛЬСКИЙ-ПАРАМЕТР-ЗАГОЛОВКА
1.51      paf       934:             ]
                    935:             $.description
                    936:             $.content-id
                    937:             $.content-md5
                    938:             $.content-location
                    939:             .raw[
1.249     moko      940:                 .СЫРОЕ_ПОЛЬЗОВАТЕЛЬСКОЕ-ПОЛЕ-ЗАГОЛОВКА
1.51      paf       941:             ]
1.249     moko      942:             $.value[строка|FILE]
1.51      paf       943:         ]
1.52      paf       944:         $.message#[MESSAGE] (message, message2, ...)
1.51      paf       945: 
1.274   ! moko      946:     ^mail:parse[строка|файл]
        !           947:         разбирает письмо и возвращает MESSAGE, такой же как $mail.received для входящего письма
        !           948: 
1.252     moko      949:     ^mail:send[
1.230     misha     950:         $.options[-odd]
1.249     moko      951:             unix: строка, которая будет добавлена к команде запуска sendmail
                    952:                 -odd означает "быстро поставь в очередь без проверки email"
                    953:             win32: игнорируется
1.252     moko      954:         $.charset[кодировка заголовка и текстовых блоков]
                    955:         $.any-header-field
1.51      paf       956:         $.text[string]
                    957:         $.text[
1.252     moko      958:            $.any-header-field
1.51      paf       959:            $.value[string]
                    960:         ]
                    961:         $.html{string}
                    962:         $.html[
1.252     moko      963:             $.any-header-field
1.51      paf       964:             $.value{string}
                    965:         ]
                    966:         $.file#[FILE]
                    967:         $.file#[
1.252     moko      968:             $.any-header-field
1.51      paf       969:             $value[FILE]
                    970:         ]
                    971:     ]
1.262     moko      972:         если charset указан, письмо перекодируется в этот charset
                    973:         content-type.charset не влияет на перекодирование
                    974:         после имени части может идти # число
1.252     moko      975: 
                    976:     ^mail:send[
                    977: #       по-умолчанию, совпадает с source encoding.
                    978: #       задаёт кодировку body
                    979:         $.charset[windows-1251]
                    980: #       нет умолчания
                    981:         $.content-type[$.value[text/plain] $.charset[windows-1251]]
                    982:         $.from["вася" <vasya@design.ru>]
                    983:         $.to["петя" <petya@design.ru>]
1.259     moko      984:         $.subject[тема]
1.252     moko      985:         $.body[
                    986:             слова
1.51      paf       987:         ]
1.252     moko      988:     ]
                    989: 
                    990:     ^mail:send[$.header-field[] $.charset[кодировка письма] $.body[когда body не строка, а hash, отсылается multipart письмо]]
                    991:         если charset указан, письмо перекодируется в этот charset
                    992:         content-type.charset не влияет на перекодирование
                    993:         после имени части может идти целое число, части пойдут в порядке чисел.
                    994:         если body указан строкой, то это текст письма, никаких вложений.
                    995:         если body указан hash, то это части, будут собраны текстовые блоки, затем вложения
                    996:         это старый формат, поддерживается для обратной совместимости
                    997:         если имя части начинается со слова text, то это текстовый блок.
1.259     moko      998:         если имя части начинается со слова file, то это вложение, формат задания:
1.253     moko      999:             $file[$.format[uue|base64] $.value[DATA] $.name[user-file-name]]
1.252     moko     1000:         важно: при multipart не указывать content-type
                   1001: 
1.1       paf      1002:         ^mail:send[
1.259     moko     1003: #           по-умолчанию, совпадает с source encoding
1.249     moko     1004: #           задаёт кодировку body
1.252     moko     1005:             $.charset[windows-1251]
1.249     moko     1006: #           нет умолчания
1.1       paf      1007:             $.content-type[$.value[text/plain] $.charset[windows-1251]]
1.249     moko     1008:             $.from["вася" <vasya@design.ru>]
                   1009:             $.to["петя" <petya@design.ru>]
1.259     moko     1010:             $.subject[тема]
1.1       paf      1011:             $.body[
1.249     moko     1012:                 слова
1.1       paf      1013:             ]
                   1014:         ]
1.252     moko     1015: 
1.1       paf      1016:         ^mail:send[
1.249     moko     1017:             $.from["вася" <vasya@design.ru>]
                   1018:             $.to["петя" <petya@design.ru>]
1.259     moko     1019:             $.subject[тема]
1.1       paf      1020:             $.body[
                   1021:                 $.text[
1.249     moko     1022: #                   задаёт кодировку body
1.1       paf      1023:                     $.charset[windows-1251]
1.249     moko     1024: #                   нет умолчания
1.1       paf      1025:                     $.content-type[$.value[text/plain] $.charset[windows-1251]]
1.249     moko     1026:                     $.body[слова]
1.1       paf      1027:                 ]
1.252     moko     1028: #               для удобства можно указать только одну часть, при этом не будет multipart
1.189     misha    1029:                 $.file[
1.259     moko     1030:                     $.value[^file::load[my beloved.doc]]
                   1031:                     $.name[my beloved.doc]
                   1032:                     $.format[base64]
1.1       paf      1033:                 ]
1.189     misha    1034:                 $.file2[
1.259     moko     1035:                     $.value[^file::load[my beloved.doc]]
                   1036:                     $.name[my beloved.doc]
                   1037:                 ]
1.1       paf      1038:             ]
                   1039:         ]
1.252     moko     1040:     для отправки под unix используется программа с параметрами, задаваемая
1.249     moko     1041:         $MAIL.sendmail[команда]
1.252     moko     1042:     если не будет задана, проверяется, доступна ли /usr/sbin/sendmail или
                   1043:     /usr/lib/sendmail и, если доступна, то запускается с параметром "-t".
                   1044: 
1.259     moko     1045:     под Windows используется SMTP протокол, сервер задаётся
1.21      paf      1046:         $MAIL.SMTP[smtp.domain.ru]
1.1       paf      1047: 
1.253     moko     1048: math
                   1049:     $math:PI
                   1050:     ^math:round floor ceiling
                   1051:     ^math:trunc frac
                   1052:     ^math:abs sign
1.272     moko     1053:     ^math:min(a;b[;c...]) max(a;b[;c...])
1.256     moko     1054:     ^math:exp log log10
                   1055:     ^math:sin asin cos acos tan atan atan2
1.253     moko     1056:     ^math:degrees radians
                   1057:     ^math:pow sqrt
                   1058:     ^math:random(ширина диапазона)
1.257     moko     1059:     ^math:convert[number|файл](base-from;base-to)[[ $.format[string|file] ]]
                   1060:     ^math:convert[number|файл][алфавит](base-to)[[ $.format[string|file] ]]
                   1061:     ^math:convert[number|файл](base-from)[алфавит][[ $.format[string|file] ]]
                   1062:         преобразует строку или файл с числом из одной системы исчисления в другую
                   1063:         система счисления может быть задана алфавитом, числом от 2 до 16 (эквивалентно алфавиту 0123456789ABCDEF), числом 256 (все ASCII символы)
1.268     moko     1064:     ^math:eq(a;b[;max ULP])
                   1065:         истина, если разница между числами меньше или равна max ULP (по умолчанию 3)
1.254     moko     1066:     ^math:uuid[ $.lower(bool) $.solid(bool) ]
1.113     paf      1067:         22C0983C-E26E-4169-BD07-77ECE9405BA5
1.249     moko     1068:         win32: пользуется cryptapi
1.253     moko     1069:         unix: пользуется /dev/urandom,
                   1070:             если нет, /dev/random,
                   1071:             если нет, rand
1.256     moko     1072:     ^math:uuid7[ $.lower(bool) $.solid(bool) ]
1.261     moko     1073:         0193CBF0-7898-7000-A391-AC513CC15658
                   1074:         https://www.rfc-editor.org/rfc/rfc9562.html#name-uuid-version-7
                   1075:     ^math:uid64[ $.lower(bool) ]
                   1076:         BA39BAB6340BE370
                   1077:     ^math:md5[string]
                   1078:         выдает digest строки, длиной 16 байт в виде строки, 
                   1079:         где байты digest выданы в hex виде, впритык, в нижнем регистре
                   1080:     ^math:crypt[password;salt]
                   1081:         salt prefix $apr1$ вызывает встроенный MD5 алгоритм,
                   1082:         если нет тела salt, оно создаётся случайным
                   1083:         $1$ вызывает MD5 алгоритм функции OS 'crypt', если поддерживается.
                   1084:         другие salt читайте документацию по функции OS 'crypt'.
                   1085:     ^math:crc32[string]
                   1086:         вычисляет crc32 строки
                   1087:     ^math:sha1[string]
                   1088:     ^math:digest[[md5|sha1|sha256|sha512];строка или файл][[ $.format[hex|base64|file] $.hmac[ключ строка|ключ файл] ]]
                   1089:         объединяет в себе возможность работы с разными алгоритмами криптографического хеширования.
                   1090:         $.hmac[ключ] для проверки целостности переданных данных
1.273     moko     1091:     ^math:xxhash[xxh32|32|xxh64|64;строка или файл][[ $.format[hex|base64|file] ]]
                   1092:         быстрый некриптографический xxHash, 4 или 8 байт, старший байт первым
1.261     moko     1093: 
                   1094: memory
                   1095:     ^memory:compact[]
                   1096:         собрать мусор, освободив место под новые данные (предупреждение: память процесса никогда не освобождается)
                   1097:         полезно делать перед XSL transform
                   1098:     ^memory:auto-compact(частота сборки)
                   1099:         задает режим автоматической сборки мусора, от 0 (выключена) до 5 (максимальная)
                   1100: 
                   1101: reflection
                   1102:     ^reflection:create[класс;конструктор[;пара[;мет[;ры]]]]
                   1103:         вызывает указанный конструктор класса (не более 100 параметров)
                   1104:     ^reflection:create[ $.class[name] $.constructor[name] $.arguments[ $.1[па] $.2[рам] $.3[етры] ] ]
                   1105:         вызывает указанный конструктор класса
                   1106:     ^reflection:classes[]
                   1107:         хеш со всеми классами. ключ = имя класса, значение бывает methoded (класс с методами) или void
                   1108:     ^reflection:class[объект]
                   1109:         класс переданного объекта
                   1110:     ^reflection:class_name[объект]
                   1111:         имя класса переданного объекта
                   1112:     ^reflection:base[объект]
                   1113:         родительский класс переданного объекта
                   1114:     ^reflection:base_name[объект]
                   1115:         имя родительского класса переданного объекта
                   1116:     ^reflection:class_by_name[имя класса]
                   1117:         получение класса по имени
                   1118:     ^reflection:class_alias[имя класса;новое имя класса]
                   1119:         задает псевдоним для указанного класса
                   1120:     ^reflection:def[class;имя класса]
                   1121:         проверка класса на существование
                   1122:     ^reflection:methods[класс]
                   1123:         хеш со списком методов указанного класса, значения - строки 'native' или 'parser'
                   1124:     ^reflection:method[класс или объект;имя метода]
                   1125:         возвращает junction-method класса или объекта
                   1126:     ^reflection:filename[объект или класс или метод]
                   1127:         возвращает имя файла, где определен объект, класс или метод
                   1128:     ^reflection:fields[класс или объект]
                   1129:         хеш со списком статических полей указанного класса или динамических полей указанного объекта
                   1130:     ^reflection:fields_reference[объект]
                   1131:         редактируемый хеш динамических полей указанного объекта
                   1132:     ^reflection:field[класс или объект;имя поля]
                   1133:         возвращает значение указанного поля класса или объекта. getter-ы игнорируются.
                   1134:     ^reflection:copy[источник;назначение]
                   1135:         копирует поля из одного объекта или класса в другой
                   1136:     ^reflection:uid[класс или объект]
                   1137:         возвращает идентификатор объекта или класса
                   1138:     ^reflection:method_info[класс;метод]
                   1139:         хеш с параметрами указанного метода класса
                   1140:         $.inherited[класс]  имя класса, где метод был определён (возвращается только если метод был определён в предке)
                   1141:         $.overridden[класс] имя класса, где метод был определён (возвращается только если метод был определён в предке)
                   1142:         для native классов возвращается хеш:
                   1143:             .min_params(минимально необходимое число параметров)
                   1144:             .max_params(максимально возможное число параметров)
                   1145:             .call_type[dynamic|static|any]
                   1146:         для parser классов возвращается хеш:
                   1147:             ключ - номер параметра (0, 1, ...), значение - имя параметра
                   1148:     ^reflection:dynamical[[object or class, caller if absent]]
                   1149:         возвращает true, если метод был вызван из динамического контекста при передаче
                   1150:         параметра возвращает true, если передан динамический объект, false если класс
                   1151:     ^reflection:delete[класс или объект;имя переменной]
                   1152:         удаляет переменную с указанным именем в указанном классе или объекте
                   1153:     ^reflection:is[имя элемента;имя класса][[контекст]]
                   1154:         аналог оператора 'is', позволяющий определить, является ли элемент кодом.
                   1155:     ^reflection:tainting[[язык|tainted|optimized];строка]
                   1156:         строка, в которой каждому символу исходной строки соотвествует символ с кодом преобразования
                   1157:     ^reflection:stack[ $.args(false/true) $.locals(false/true) $.limit(n) $.offset(o)]
                   1158:         текущее состояние стека вызовов методов на парсере
                   1159:     ^reflection:mixin[источник; $.to[получатель] $.name[имя] $.methods(true/false) $.fields(true/false) $.overwrite(false/true) ]
                   1160:         копирует в класс методы и поля другого класса
1.267     moko     1161:     ^reflection:override[метод[; $.to[получатель] $.name[новое имя]]]
                   1162:         переопределяет или определяет метод
1.253     moko     1163: 
1.270     moko     1164: redis
                   1165:     ^redis::open[[
                   1166:         $.host[localhost] $.port(6379)|$.unix_socket[путь]
                   1167:         $.user[] $.password[] $.db(0) $.timeout(2) $.protocol(3) $.auto_reconnect(секунд)
                   1168:         $.tls[ $.ca[файл] $.cert[файл] $.key[файл] $.verify(true) ]
                   1169:     ]]
                   1170:         подключается к серверу redis
                   1171:         timeout в секундах на подключение и на каждую команду, 0 - без ограничения
                   1172:         protocol(2) для серверов до redis 6
                   1173:         auto_reconnect(N): после потери соединения переподключиться перед следующей командой, выждав N секунд
                   1174:         tls: сертификат сервера проверяется, только если задан ca
                   1175:     ^redis.имя_команды[аргументы;...]
                   1176:         любая команда redis, например ^redis.set[ключ;значение] ^redis.get[ключ] ^redis.hgetall[ключ]
                   1177:     ^redis.call[команда;аргументы;...]
                   1178:     ^redis.f-имя_команды[аргументы;...], ^redis.f-call[команда;аргументы;...]
                   1179:         строки ответа выдаются файлами (двоичные данные)
                   1180:     аргументы: строка, число, bool как 1/0, файл своим содержимым; массив - его элементы, хеш - пары ключ значение
                   1181:     ответ: string, int, double, bool, void (nil), array, hash (map); ответ-ошибка - исключение
                   1182:     ^redis.release[]
                   1183:         закрывает соединение
                   1184: 
1.261     moko     1185: request
1.264     moko     1186:     https://site.name/a%20b/?name=some%20value
1.261     moko     1187:     $request:query
1.264     moko     1188:         name=some%20value
1.261     moko     1189:     $request:uri
1.264     moko     1190:         /a%20b/?name=value
                   1191:     $request:path
                   1192:         /a b/
1.261     moko     1193:     $request:document-root
                   1194:         каталог, относительно которого считаются пути в parser, по-умолчанию = $env:DOCUMENT_ROOT
                   1195:     $request:argv
                   1196:         hash с параметрами коммандной строки. ключи 0, 1, ... [0 -- имя обрабатываемого файла]
                   1197:     $request:charset
                   1198:         кодировка исходного документа 
                   1199:         используется при upper/lower и match[][i]
                   1200:         ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form
                   1201:     $request:method
                   1202:         метод запроса (GET|POST|PUT)
                   1203:     $request:body
                   1204:         тело POST-запроса в виде текста
                   1205:     $request:body-file
                   1206:         тело POST-запроса в виде файла
                   1207:     $request:body-charset
                   1208:         кодировка POST-запроса
                   1209:     $request:headers
                   1210:         хеш с заголовками запроса (без префикса HTTP_)
1.1       paf      1211: 
1.261     moko     1212: response
                   1213:     $response:поле[значение]  и можно считать старое - $response:поле
                   1214:         значение может быть string а может быть hash:
                   1215:             $value[abc] field: {abc}<<часть
                   1216:             $attribute[zzz] field: abc; {attribute=zzz}<<часть
                   1217:         значение поля или атрибута может быть string или date
                   1218:             если дата, она будет преобразована к формату "Sun, 25-Aug-2002 12:03:45 GMT"
                   1219:     $response:headers
                   1220:         накопленные поля
                   1221:     $response:body[DATA]
                   1222:         замещает стандартный ответ
                   1223:     $response:download[DATA]
                   1224:         замещает стандартный ответ, выставляет флаг, заставляющий browser предложить download
                   1225:     $response:status
                   1226:     ^response:clear[] забыть все заданные response поля
                   1227:     $response:charset
                   1228:         кодировка клиента т.е. та,
                   1229:         1) из которой будут перекодированы $form:поля после забирания из browser'а
                   1230:         2) в которую документ будет перекодирован перед отдаванием в browser
                   1231:         3) в которую будет перекодирован текст языка uri
                   1232:         не добавляет к content-type ничего, если хочется, это надо сделать вручную
                   1233:         ПРЕДУПРЕЖДЕНИЕ: необходимо задать $request/response:charset до использования полей класса form
1.252     moko     1234: 
1.261     moko     1235: status
                   1236:     $status:sql
                   1237:         cache table
                   1238:             url    time
                   1239:             url    time
                   1240:             url    time
                   1241:     $status:stylesheet
                   1242:         cache table
                   1243:             file    time
                   1244:             file    time
                   1245:             file    time
                   1246:     $status:rusage hash
                   1247:         utime user time used
                   1248:         stime system time used
                   1249:         maxrss max resident set size
                   1250:         ixrss integral shared text memory size
                   1251:         idrss integral unshared data size
                   1252:         isrss integral unshared stack size
                   1253:         tv_sec
                   1254:         tv_usec
                   1255:            $s[$status:rusage]
                   1256:            ^s.tv_sec.format[%.0f].^s.tv_usec.format[%06.0f]
                   1257:     $status:memory hash
                   1258:         used
                   1259:             includes some pages that were allocated but never written
                   1260:         free
                   1261:         ever_allocated_since_compact
                   1262:             return the number of bytes allocated since the last collection
                   1263:         ever_allocated_since_start
                   1264:             return the total number of bytes [EVER(c)PAF] allocated in this process,
                   1265:             never decreases
                   1266:     $status:pid
                   1267:         process id
                   1268:     $status:tid
                   1269:         thread id
                   1270:     $status:mode
                   1271:         режим работы, cgi|console|mail|httpd|apache|isapi
                   1272:     $status:log-filename
                   1273:         путь к журналу ошибок parser3.log
1.205     misha    1274: 
1.1       paf      1275: xdoc(xnode)
1.253     moko     1276:     $xdoc.search-namespaces hash, where keys=prefixes, values=urls
                   1277: 
1.1       paf      1278:     DOM1 attributes:
1.253     moko     1279:     readonly attribute DocumentType doctype
                   1280:     readonly attribute Element documentElement
1.1       paf      1281: 
                   1282:     DOM1 methods:
1.253     moko     1283:     Element createElement(in DOMString tagName)
                   1284:     DocumentFragment createDocumentFragment()
                   1285:     Text createTextNode(in DOMString data)
                   1286:     Comment createComment(in DOMString data)
                   1287:     CDATASection createCDATASection(in DOMString data)
                   1288:     ProcessingInstruction createProcessingInstruction(in DOMString target,in DOMString data)
                   1289:     Attr createAttribute(in DOMString name)
                   1290:     EntityReference createEntityReference(in DOMString name)
                   1291:     NodeList getElementsByTagName(in DOMString tagname)
1.1       paf      1292: 
                   1293:     DOM2 some methods:
1.253     moko     1294:     ^.getElementById[elementId] = xnode
                   1295:         The DOM implementation must have information that says which attributes are of type ID.
                   1296:         Attributes with the name "ID" are not of type ID unless so defined.
                   1297:         Implementations that do not know whether attributes are of type ID or not
1.1       paf      1298:         are expected to return null.
                   1299: 
1.259     moko     1300:     кодировка строк и умолчание для $.encoding равно текущей кодировке выходной страницы, $response:charset
                   1301: 
1.1       paf      1302:     ::sql{...}
1.253     moko     1303:     ::create[[URI]]{<?xml?><string/>} старое имя 'set'
                   1304:     ::create[[URI]][qualifiedName]
1.56      paf      1305:       URI default = disk path to requested document
1.249     moko     1306:       для каталогов конечный / обязателен
1.253     moko     1307:     ::create[file] can be usable:
                   1308:         $f[^file::load[binary;http://;some HTTP options here...]]
                   1309:         $x[^xdoc::create[$f]]
                   1310:     ::load[file.xml[;опции]]
                   1311:     .transform[rules.xsl|xdoc][[params hash]] выдаёт dom
1.250     moko     1312:         шаблон кешируется, кеш обновляется при изменении даты файла шаблона,
1.249     moko     1313:         или изменении даты файла "имя шаблона.stamp"[проверка даты stamp приоритетнее]
1.1       paf      1314:         <xsl:output
1.253     moko     1315:         method = "xml" | "html" | "text"
1.259     moko     1316:         version = nmtoken
                   1317:         encoding = string
1.253     moko     1318:         omit-xml-declaration = "yes" | "no"
                   1319:         standalone = "yes" | "no"
1.259     moko     1320:         cdata-section-elements = qnames
1.253     moko     1321:         indent = "yes" | "no"
1.259     moko     1322:         media-type = string />
1.253     moko     1323:         параметры передаются как есть, не xpath выражения
                   1324: 
                   1325:     .string[[output options]]
                   1326:     .save[file.xml[;output options]] с шапкой
                   1327:     .file[[output options]] = file
                   1328:         output options идентичны атрибутам xsl:output
1.249     moko     1329:             [исключение: игнорируется cdata-section-elements, нужно будет, сделаю]
                   1330:         выдаёт media-type при подстановке $response:body[сюда]
1.1       paf      1331: 
1.253     moko     1332:     если на документ ссылаются так:
                   1333:         parser://method/param/to/that/method
                   1334:         то в качестве документа используется ^MAIN:method[/param/to/that/method]
                   1335:         [примечание: в параметр всегда приходит лидирующая /, даже, если параметров вообще не было]
1.144     paf      1336: 
1.253     moko     1337: xnode
1.1       paf      1338:     DOM1 attributes:
1.253     moko     1339:     $node.nodeName
                   1340:     $node.nodeValue
                   1341:         read
                   1342:         write
                   1343:     $node.nodeType = int
                   1344:         ELEMENT_NODE                   = 1
                   1345:         ATTRIBUTE_NODE                 = 2
                   1346:         TEXT_NODE                      = 3
                   1347:         CDATA_SECTION_NODE             = 4
                   1348:         ENTITY_REFERENCE_NODE          = 5
                   1349:         ENTITY_NODE                    = 6
                   1350:         PROCESSING_INSTRUCTION_NODE    = 7
                   1351:         COMMENT_NODE                   = 8
                   1352:         DOCUMENT_NODE                  = 9
                   1353:         DOCUMENT_TYPE_NODE             = 10
                   1354:         DOCUMENT_FRAGMENT_NODE         = 11
                   1355:         NOTATION_NODE                  = 12
1.1       paf      1356:             $vasyaNode.type==$xnode:ELEMENT_NODE
1.253     moko     1357:     $node.parentNode
                   1358:     $node.childNodes = array of nodes
                   1359:     $node.firstChild
                   1360:     $node.lastChild
                   1361:     $node.previousSibling
                   1362:     $node.nextSibling
                   1363:     $node.ownerDocument = xdoc
                   1364:     $node.prefix
                   1365:     $node.namespaceURI
                   1366:     $element_node.attributes = hash of xnodes
                   1367:     $element_node.tagName
                   1368:     $attribute_node.specified = boolean
                   1369:         true if the attribute received its value explicitly in the XML document,
1.259     moko     1370:         or if a value was assigned programmatically with the setValue function.
1.253     moko     1371:         false if the attribute value came from the default value declared in the document's DTD.
                   1372:     $attribute_node.name
                   1373:     $attribute_node.value
1.1       paf      1374:     $text_node/cdata_node/comment_node.substringData
1.253     moko     1375:     $pi_node.target = target of this processing instruction
1.259     moko     1376:         XML defines this as the first token following the markup
1.1       paf      1377:         that begins the processing instruction.
1.253     moko     1378:     $pi_node.data = The content of this processing instruction
1.259     moko     1379:         From the first non-whitespace character after the target
1.253     moko     1380:         to the character immediately preceding the ?>.
1.1       paf      1381:     document_node.
                   1382:         readonly attribute DocumentType doctype
1.253     moko     1383:         readonly attribute DOMImplementation implementation
1.1       paf      1384:         readonly attribute Element documentElement
                   1385:     document_type_node.
1.253     moko     1386:         readonly attribute DOMString name
1.1       paf      1387:         readonly attribute NamedNodeMap entities
                   1388:         readonly attribute NamedNodeMap notations
1.253     moko     1389:     notation_node.
                   1390:         readonly attribute DOMString publicId
                   1391:         readonly attribute DOMString systemId
                   1392: 
                   1393:     DOM1 node methods:
                   1394:     Node insertBefore(in Node newChild,in Node refChild)
                   1395:     Node replaceChild(in Node newChild,in Node oldChild)
                   1396:     Node removeChild(in Node oldChild)
                   1397:     Node appendChild(in Node newChild)
                   1398:     boolean hasChildNodes()
                   1399:     Node cloneNode(in boolean deep)
                   1400: 
                   1401:     DOM1 element methods:
                   1402:     DOMString getAttribute(in DOMString name)
                   1403:     void setAttribute(in DOMString name, in DOMString value) raises(DOMException)
                   1404:     void removeAttribute(in DOMString name) raises(DOMException)
                   1405:     Attr getAttributeNode(in DOMString name)
                   1406:     Attr setAttributeNode(in Attr newAttr) raises(DOMException)
                   1407:     Attr removeAttributeNode(in Attr oldAttr) raises(DOMException)
                   1408:     NodeList getElementsByTagName(in DOMString name)
                   1409:     void normalize()
                   1410: 
                   1411:     Introduced in DOM Level 2:
                   1412:     Node importNode(in Node importedNode, in boolean deep) raises(DOMException)
                   1413:     NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName)
                   1414:     boolean hasAttributes()
1.1       paf      1415: 
1.253     moko     1416:     XPath:
                   1417:     ^node.select[xpath/query/expression] = array of nodes, 
1.21      paf      1418:         empty array if nothing found
1.253     moko     1419:     ^node.selectSingle[xpath/query/expression] = first node if any
                   1420:     ^node.selectBool[xpath/query/expression] = bool if any or die
                   1421:     ^node.selectNumber[xpath/query/expression] = double if any or die
                   1422:     ^node.selectString[xpath/query/expression] = string if any or die
1.1       paf      1423: 
1.176     paf      1424: DATA::=string | file | hash
1.253     moko     1425:     hash вида
                   1426:     [
                   1427:         $.file[имя файла на диске]
                   1428:         $.name[имя файла для пользователя]
                   1429:         $.mdate[date]
                   1430:     ]
                   1431: 
                   1432: MAIN
                   1433:     это класс, загружаемый на автомате из конфигурационного auto.p, кучи auto.p и запрашиваемого документа:
                   1434:         конфигурационный auto.p
                   1435:             cgi:
                   1436:                 1. или полный путь из переменной окружения CGI_PARSER_SITE_CONFIG или рядом с бинарником parser'а
1.1       paf      1437:             isapi: windows directory
1.253     moko     1438:             apache module:
1.43      paf      1439:                 1) ParserConfig [can be in .htaccess]
1.253     moko     1440:         auto.p вниз от DOCUMENT_ROOT/ по дереву до каталога с обрабатываемым файлом включительно
1.249     moko     1441:     класс собирается из всех этих файлов, последующие становятся родителями предыдущих
                   1442:     имя последнего загруженного MAIN, имён у предыдущих нет
1.253     moko     1443: 
                   1444:     после загрузки MAIN класса вызывается его @main[]
                   1445:     результат которого передаётся в его @postprocess[data] if($data is string) ...
                   1446:     результат которого отдаётся пользователю
                   1447: 
                   1448: если встречается ошибка и try не задан, её можно красиво сообщить пользователю, определив
                   1449:     @unhandled_exception[exception;stack]
                   1450:         $exception.type  строка "тип проблемы"
                   1451:         $exception.file $exception.lineno $exception.colno файл, строка и позиция, где случилась проблема [если не запрещены при компиляции]
                   1452:         $exception.source строка, из-за которой случилась проблема
                   1453:         $exception.comment комментарий english
                   1454:         stack табличка из колонок file line name,
1.259     moko     1455:             там лежат в обратном порядке имена[name] и места вызовов[file line] операторов/методов, приведших к ошибке.
1.253     moko     1456: 
                   1457: при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:
                   1458:     http://domain/document[?params<<deprecated, use $.form[...]]
                   1459:     а также, возможно, указать опции:
                   1460:         $.method[GET|POST|HEAD]
                   1461:         $.timeout(3)  << в секундах, по-умолчанию =2
                   1462:         $.cookies[
                   1463:             $.имя[значение]
                   1464:         ]
                   1465:         $.headers[
                   1466:             $.поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
                   1467:         ]
1.166     paf      1468:         $.enctype[multipart/form-data]
                   1469:         $.form[
1.253     moko     1470:             $.field1[string]
                   1471:             $.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]
1.166     paf      1472:             $.field3[file]
                   1473:         ]
1.253     moko     1474:         $.body[string|file]
                   1475:         по-умолчанию, user-agent=parser3
                   1476:         по-умолчанию, получение http status != 200 >> создает http.status ошибку, это можно отключить, передав $.any-status(1)
1.259     moko     1477:         $.charset[кодировка удалённых документов по-умолчанию], если сервер вернёт content-type:charset - ОНА ПЕРЕБИВАЕТ
1.253     moko     1478:         $.response-charset[кодировка удалённых документов], не перебиваеся content-type:charset
                   1479:         $.user[пользователь]
                   1480:         $.password[пароль]
                   1481:     file::load в дополнительные поля записывает
                   1482:         ПОЛЕ:значение (имена полей ответа заглавными буквами)
1.259     moko     1483:         tables << хеш их ПОЛЕ->table с единственным столбцом "value"
1.249     moko     1484:             в таких таблицах можно брать повторяющиеся заголовки. например, несколько set-cookies
                   1485:             todo:сделать отдельный cookies
                   1486: 
1.253     moko     1487: системные типы ошибок:
                   1488:     parser.compile       ^test[}                компиляция (непарная скобка, ...)
                   1489:     parser.runtime       ^if(0).                параметры (больше/меньше, чем нужно, не тех типов, ...)
                   1490:     number.zerodivision  ^eval(1/0) ^eval(1%0)
                   1491:     number.format        ^eval(abc*5)
                   1492:     file.lock                                                        shared/exclusive lock error
                   1493:     file.missing         ^file:delete[delme]                         not found
                   1494:     file.access          ^table::load[.]                             no rights
                   1495:     file.read            ^file::load[...]                            error while reading file
                   1496:     file.seek                                                        seek failed
                   1497:     file.execute         ^file::cgi[...]                             incorrect cgi header/can't execute
                   1498:     image.format         ^image::measure[index.html]                 not gif/jpg
                   1499:     sql.connect          ^connect[mysql://baduser:pass@host/db]{}    not found/timeout
                   1500:     sql.execute          ^void:sql{select bad}                       syntax error
1.57      paf      1501:     sql.duplicate
                   1502:     sql.access
                   1503:     sql.missing
1.253     moko     1504:     xml                  ^xdoc::create{<forgot?>}                    any error in xml/xslt libs
                   1505:     smtp.connect                                                     not found/timeout
                   1506:     smtp.execute                                                     communication error
1.259     moko     1507:     email.format         hren tam@null.ru                            wrong email format (bad chars/empty)
1.253     moko     1508:     email.send           $MAIL.sendmail[/shit]                       sendmail not executable
                   1509:     http.host            ^file::load[http://notfound/there]          host not found
1.259     moko     1510:     http.connect         ^file::load[http://not_accepting/there]     host found, but does not accept connections
                   1511:     http.timeout         ^file::load[http://host/doc]                load operation failed to complete in # seconds
1.253     moko     1512:     http.response        ^file::load[http://ok/there]                host found, connection accepted, bad answer
                   1513:     http.status          ^file::load[http://ok/there]                host found, connection accepted, status!=200
                   1514:     date.range           ^date::create(10000;1;1)                    date out of valid range
1.270     moko     1515:     amqp                 ^amqp::create[$.port(1)]                    connection failed/error from the broker
                   1516:     redis                ^redis::open[$.port(1)]                     connection failed/error reply
1.213     misha    1517: 
1.253     moko     1518: если описание метода содержит локальную переменную result в явном виде (есть и неявная переменная)
1.258     moko     1519:     то код вывода пробельных литералов не попадает в конечный байт-код
1.260     moko     1520: 
1.274   ! moko     1521: $Id: operators.ru.txt,v 1.273 2026/11/04 13:41:23 moko Exp $

E-mail: