--- parser3/operators.ru.txt	2004/03/05 13:27:44	1.165
+++ parser3/operators.ru.txt	2004/06/22 14:12:57	1.175
@@ -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
@@ -1019,13 +1026,21 @@ console
         операторов/методов, приведших к ошибке.
 
 !при загрузке файла (file::load, table::load, xdoc::load) можно указать такое имя файла:
-    !http://domain/document?params
+    !http://domain/document[?params<<deprecated, use $.form[...]]
     !а также, возможно, указать опции:
-        !$.method[GET|HEAD]
+        !$.method[GET|POST|HEAD]
         !$.timeout(3)  << в секундах, по-умолчанию =2
         !$.headers[
         !    $поле[значение] << значение имеет формат, как $response:ЗАГОЛОВОК
         !]
+        $.enctype[multipart/form-data]
+        $.form[
+            !$.field1[string]
+            !$.field2[^table::create{one_column_only^#0Avalue1^#0Avalue2}]
+            $.field3[file]
+        ]
+        !$.body[string]
+        	|file
         !по-умолчанию, user-agent=parser3
         !по-умолчанию, получение http status != 200 >> создает http.status ошибку,
         !это можно отключить, передав
@@ -1068,5 +1083,12 @@ console
     
 !нужно выключить русский apache: CharsetDisable on
 
-!если в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
+Xесли в MAIN будет определён флаг $ORIGINS(1) то вместо обычного вывода страницы будет
     выдан список фрагментов результата с указанием их происхождения
+
+!если описание метода содержит локальную переменную result в явном виде
+    (есть и неявная переменная)
+    то код вывода строковых литералов не попадает в конечный байт-код,
+    а непробельные символы считаются синтаксической ошибкой
+    для вывода чего бы то ни было надо пользоваться этой переменной
+