--- parser3/operators.ru.txt	2004/03/10 10:04:30	1.168
+++ parser3/operators.ru.txt	2004/07/26 14:43:08	1.176
@@ -88,7 +88,7 @@ Xне сделано, видимо, не будет сделано
         выдавая нестандартный результат
     X^break[] + - обрывает цикл
     X^continue[] + - обрывает итерацию цикла
-    !^untaint[[as-is|file-spec|http-header|mail-header|uri|table|sql|js|xml|html|optimized-html]]{код}
+    !^untaint[[as-is|file-spec|http-header|mail-header|uri|sql|js|xml|html|optimized-html]]{код}
         default as-is
     !^taint[[lang]][код]
         default "just tainted, language unknown"
@@ -252,7 +252,7 @@ odbc    c:\drives\y\parser3project\odbc\
         0 или default
     !^имя.double[] (default)
         0 или default
-    !^void:sql{запрос без результата}
+    !^void:sql{запрос без результата}{$.bind[см. table::sql]}
 
 
 !int,double
@@ -264,7 +264,7 @@ odbc    c:\drives\y\parser3project\odbc\
     !^имя.div(на сколько /)
     !^имя.mod(на сколько %)
     !^имя.format[формат]
-    !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0}]]
+    !^int/double:sql{query}[[$.limit(2) $.offset(4) $.default{0} $.bind[см. table::sql]]]
         запрос, результат которого должен быть один столбец/одна строка
 
 !string
@@ -276,7 +276,7 @@ odbc    c:\drives\y\parser3project\odbc\
         пример:
         ^if(def $form:name) не пуста?
         ^if($user.isAlive) истина? [автопреобразование к числу, не ноль?]
-    !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a}]]
+    !^string::sql{query}[[$.limit(1) $.offset(4) $.default{n/a} $.bind[см. table::sql]]]
         результат запроса должен быть один столбец/одна строка
     !^имя.int[] .int(default) целочисленное значение строки. 
         если ломается преобразование, берётся default
@@ -317,6 +317,7 @@ odbc    c:\drives\y\parser3project\odbc\
         состоит из большого числа фрагментов
     !^string.trim[start|both|end[;chars]] выкидывает charset из начала/конца/и начала и конца
         default 'chars' -- whitespace chars
+    !^string.append[string]
 
 !table
     в выражении 
@@ -331,7 +332,11 @@ odbc    c:\drives\y\parser3project\odbc\
         !пустые строки, и строки в первой колонке содержащие '#', игнорируются        
         !$.separator[^#09]
         !$.encloser["] по-умолчанию, нет.
-    !^table::sql{query}[[$.limit(2) $.offset(4) todo:$.default{ ^table::create[...] }]]
+    !^table::sql{query}[[$.limit(2) $.offset(4) $.bind[hash] todo:$.default{ ^table::create[...] }]]
+    	bind привязывает переменные в запросе к их значениям
+    	пока реализован только для oracle
+    	в запросе надо написать ":имя"
+    	в параметре bind передать hash, из которого возьмётся(или куда запишется) значение
     !^таблица.save[[nameless|append;]путь[;опции, см. load]]
     !$таблица.поле
     !$таблица.fields  из named таблицы выдаёт текущую запись как Hash
@@ -408,11 +413,11 @@ odbc    c:\drives\y\parser3project\odbc\
     !^foreach[key|value]{тело}[[разделитель]|{разделитель который выполняется перед непустым очередным не первым телом}]
 
     пример:
-    $uids[^hashfile::open[/db/uids]]
-    
-    $random[23847387taduigh345XGHWElxjgdjg]
-    $uids.$random[$.value[$uid] $.expires(1)]
-    $uid[$persistent.logins.$random]
+    $sessions[^hashfile::open[/db/sessions]]
+   
+    $sid[^math:uuid[]]
+    $sessions.$sid[$.value[$uid] $.expires(1)]
+    $uid[$sessions.$sid]
 
 !form
     [берётся первый элемент из одноимённых из GET, потом первый из POST]
@@ -746,6 +751,8 @@ odbc    c:\drives\y\parser3project\odbc\
         столбцы: year, month, day, weekday
     
 xdoc(xnode)
+    !$xdoc.search-namespaces hash, where keys=prefixes, values=urls
+    
     DOM1 attributes:
     !readonly attribute DocumentType doctype
     Xreadonly attribute DOMImplementation implementation
@@ -887,13 +894,12 @@ xdoc(xnode)
     !NodeList getElementsByTagNameNS(in DOMString namespaceURI, in DOMString localName);
 
     !XPath:
-    !^node.select[xpath/query/expression][[namespaces]] = array of nodes, 
+    !^node.select[xpath/query/expression] = array of nodes, 
         empty array if nothing found
-    !^node.selectSingle[xpath/query/expression][[namespaces]] = first node if any
-    !^node.selectBool[xpath/query/expression][[namespaces]] = bool if any or die
-    !^node.selectNumber[xpath/query/expression][[namespaces]] = double if any or die
-    !^node.selectString[xpath/query/expression][[namespaces]] = string if any or die
-        ![[namespaces]] hash, where keys=prefixes, values=urls
+    !^node.selectSingle[xpath/query/expression] = first node if any
+    !^node.selectBool[xpath/query/expression] = bool if any or die
+    !^node.selectNumber[xpath/query/expression] = double if any or die
+    !^node.selectString[xpath/query/expression] = string if any or die
 
     !error codes(пока придут как текст в случае соответствующих ошибок):
         INDEX_SIZE_ERR
@@ -988,7 +994,14 @@ console
     !$console:line
         read/write строку
 
-!DATA::=string | file
+DATA::=string | file | hash
+
+!hash вида
+[
+	$.file[имя файла на диске]
+	$.name[имя файла для пользователя]
+	$.mdate[date]
+]
 
 !MAIN
     это класс, загружаемый на автомате из parser3.conf, 
@@ -1077,5 +1090,12 @@ console
     
 !нужно выключить русский apache: CharsetDisable on
 
-!если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
+Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения
+
+!если описание метода содержит локальную переменную result в явном виде
+    (есть и неявная переменная)
+    то код вывода строковых литералов не попадает в конечный байт-код,
+    а непробельные символы считаются синтаксической ошибкой
+    для вывода чего бы то ни было надо пользоваться этой переменной
+