From OpenSCADAWiki
Jump to: navigation, search

Enter a message name below to show all available translations.

Message

Found 3 translations.

NameCurrent message text
 h English (en)== {{Anch|SYS|Program-system (SYS)}} ==
Object functions:
<ul>
<li>''{string|int} system( string cmd, bool noPipe = false );'' — calls the console commands ''cmd'' of the OS returning the result by the channel. If ''noPipe'' is set then the callback code is returned and program can be started in the background ("sleep 5 &"). The function provides OpenSCADA with a wide range of capabilities by calling any system programs, utilities, and scripts, as well as by providing them with access to a huge amount of system data. For example the command "ls-l" returns the detailed content of the working directory.</li>
<li>''int fileSize( string file );'' — returns the ''file'' size.</li>
<li>''string fileRead( string file, int off = 0, int sz = -1 );'' — returns a string of part of the ''file'' for the offset ''off'' and the block size ''sz''.</li>
<li>''int fileWrite( string file, string str, bool append = false );'' — writes the string ''str'' to the ''file'', removes presented one, at ''append''. Returns the wrote bytes count.</li>
<li>''int fileRemove( string file );'' — removes the ''file''. Returns the removing result.</li>
<li>''int message( string cat, int level, string mess );'' — forms of the system message ''mess'' with the category ''cat'', level ''level'' (-7...7). The negative value of the level forms the alarms.</li>
<li>''int messDebug( string cat, string mess ); int messInfo( string cat, string mess ); int messNote( string cat, string mess ); int messWarning( string cat, string mess ); int messErr( string cat, string mess ); int messCrit( string cat, string mess ); int messAlert( string cat, string mess ); int messEmerg( string cat, string mess );'' — forms of the system message ''mess'' with the category ''cat'' and the appropriate level by the name.</li>
<li>''XMLNodeObj XMLNode( string name = "" );'' — creates of the XML node object with the ''name''.</li>
<li>''string cntrReq( XMLNodeObj req, string stat = "" );'' — sends a request ''req'' in XML view to the [[Special:MyLanguage/Documents/API#CntrNode|Control Interface]] of the program. Returns a string with error in the format "'''{errCod}:{errText}'''", which is "0" for successful. A request is generally written in the form '''<get path="/OPath/%2felem" />''' and with additional attributes specific to the particular request. If the station ''stat'' is specified into the request then the request will be sent to this external station. The address for the attribute "path" you can obtain into the OpenSCADA configurator, that is into the status line where the address appear at the mouse cursor point to a field of configuration or information. Some examples of common requests, more examples in [[Special:MyLanguage/Documents/API#CntrNode|description the Control Interface]] and [[Special:MyLanguage/Libs/Service_procedures#releaseTests|releaseTests()]]:
<ul>
 <li>Reading a value of the element (the user name "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("get").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR");
SYS.cntrReq(req);
idSt = req.text(); </syntaxhighlight></li>
 <li>Writing a value to the element (the user name "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("set").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR").setText("New test user name");
SYS.cntrReq(req); </syntaxhighlight></li>
 <li>Adding a new node (the user "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("add").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
 <li>Deleting a node (the user "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("del").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
 <li>Saving the node changes to DB (the user "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("save").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
 <li>Loading the node from DB (the user "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("load").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
</ul></li>
<li>''string lang(string full);'' — returns the system language in two symbols and the full language in ''full''.</li>
<li>''int sleep( real tm, int ntm = 0 );'' — puts the execution thread to sleep on the ''tm'' seconds (precised up to nanoseconds) and ''ntm'' nanoseconds. The sleeping time you can set up to STD_INTERF_TM (5 seconds).</li>
<li>''int time( int usec );'' — returns the absolute time in seconds from the epoch of 1/1/1970 and the microseconds part into ''usec'' if specified.</li>
<li>''int utime( ); int mtime( );'' — returns the absolute time in microseconds and milliseconds from the epoch of 1/1/1970.</li>
<li>''int {localtime|gmtime}( int fullsec, int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst );'' — returns the full date in seconds (sec), minutes (min), hours (hour), days of the month (mday), months (month), years (year), days in the week (wday), days in the year (yday) and sign of the summer time (isdst), based on the absolute time in seconds ''fullsec'' from the epoch 1/1/1970. ''gmtime'' returns time in GMT(UTC).</li>
<li>''int {mktime|timegm}( int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst );'' — forms the time since Epoch 1/1/1970 from separated seconds, minutes, hours, days, month etc. The values for separated time items can be set out from this typical range, which allows you to use this function during checking, and as a result, units of time will be fixed and rotated in the normal range. ''timegm'' runs in time at GMT(UTC).</li>
<li>''string {strftime|strftimegm}( int sec, string form = "%Y-%m-%d %H:%M:%S" );'' — converts an absolute time ''sec'' to the string of the desired format ''form''. Record of the format corresponds to the POSIX-function ''strftime''. ''strftimegm'' returns time into GMT(UTC).</li>
<li>''int {strptime|strptimegm}( string str, string form = "%Y-%m-%d %H:%M:%S" );'' — returns the time in seconds from the epoch of 1/1/1970, based on the string record of time ''str'', in accordance with the specified template ''form''. For example the template "%Y-%m-%d %H:%M:%S" corresponds with the time "2006-08-08 11:21:55". Description of the template format can be obtained from the documentation on POSIX-function ''strptime''. ''strptimegm'' works into GMT(UTC) time.</li>
<li>''{{Anch|CRON|<nowiki>int cron( string cronreq, int base = 0 );</nowiki>}}'' — returns the time, planned in the format of the standard CRON, ''cronreq'', beginning from the basic time ''base'' or current, if the basic is not specified. CRON is the standard form "* * * * *".
; Where items by the order:
* minutes (0-59);
* hours (0-23);
* days (1-31);
* month (1-12);
* week day (0[Sunday]-6).
; Where the item variants:
* "*" — any value;
* "1,2,3" — list of the allowed values;
* "1-5" — raw range of the allowed values;
* "*/2" — divider to the all allowed values range.
; Examples:
* "* * * * *" — each minute;
* "10 23 * * *" — only at 23 hour and 10 minute for any day and month;
* "*/2 * * * *" — for minutes: 0,2,4,...,56,58;
* "* 2-4 * * *" — for any minutes in hours from 2 to 4(include).
</li>
<li>''string strFromCharCode( int char1, int char2, int char3, ... );'' — creates a string from symbol codes ''char1'', ''char2'' ... ''charN''.</li>
<li>''string strFromCharUTF([string type = "UTF-8",] int char1, int char2, int char3, ...);'' — creates a string from UTF symbols ''char1'', ''char2'' ... ''charN''. These types of the symbol are supported: UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE.</li>
<li>''string strCodeConv( string src, string fromCP, string toCP );'' — transcodes the text ''src'' from the encoding ''fromCP'' to ''toCP''. If the encoding is omitted (empty string), it is used the internal one.</li>
<li>''string strEncode( string src, string tp = "Bin", string opt = "" );'' — encodes the string ''src'' by the rule ''tp'' and the option ''opt''. Allowed rules:
:"PathEl" — symbols '''[/%]''' to "%2f" and "%25", respectively;
:"HttpURL" — symbols '''[ \t%]''' and "> 0x80" to "%20", "%09", "%25" and etc.;
:"HTML" — symbols of the HTML-entities '''[><"&']''' to "&amp;gt;", "&amp;lt;", "&amp;quot;" and etc.;
:"JavaScript" — symbol '\n' shielding to "\\n";
:"SQL" — shielding of the symbols '''['"`\]''' by appending '\' or doubling of the listed symbols into ''opt'';
:"Custom" — symbols into ''opt'' to the view "%NN";
:"Base64" — same Base 64 binary encoding, into ''opt'' sets a line termination symbol(s) after 57 symbols;
:"FormatPrint" — symbol '%' to "%%";
:"OscdID" — almost all symbols like '''[ /\&(]''' to '_';
:"Bin" — ASCII bytes list ("XX XX XX XX ...") to the binary represent;
:"Reverse" — reversion the sequence;
:"ToLower" — symbols to the lower register;
:"Limit" — limiting the string to the length into ''opt'', counting UTF-8 variable length;
:"ShieldSymb" — shielding symbols from ''opt'' (by default ['"`]) with the slash symbol "\" like to '\n', '\r', ..., '\0NNN';
:"ShieldBin" — shielding all binary symbols [\x0-\x8\xB-\xC\x0E-\x1F] with the slash symbol "\".
</li>
<li>''string strDecode( string src, string tp = "Bin", string opt = "" );'' — decodes the string ''src'' by the rule ''tp'' and the option ''opt''. Allowed rules:
:"PathEl", "HttpURL", "Custom" — symbols like "%NN" to the binary represent;
:"Base64" — same from Base 64;
:"Bin" — the binary string to ASCII bytes ("XX XX XX XX ..  A.b.c.."), ''opt'' points to the separator or "<text>" for enable the offset to the left and the text part to the right;
:"ShieldSymb" — shielded symbols like to '\n', '\r', ..., '\0NNN', '\xNN' to the binary represent.
</li></ul>
 h Russian (ru)== {{Anch|SYS|Программа-система (SYS)}} ==
Функции объекта:
<ul>
<li>''{string|int} system( string cmd, bool noPipe = false);'' — вызывает консольные команды ''cmd'' ОС с возвратом результата по каналу. Если ''noPipe'' установлен то возвращается код возврата вызова и возможен запуск программ в фоне ("sleep 5 &"). Функция предоставляет пользователю OpenSCADA широкие возможности через вызов любых системных программ, утилит и скриптов, а также получения посредством них доступа к огромному объёму системных данных. Например команда "ls -l" вернёт детализированное содержимое рабочей директории.</li>
<li>''int fileSize( string file );'' — возвращает размер файла ''file''.</li>
<li>''string fileRead( string file, int off = 0, int sz = -1 );'' — возвращает строку части файла ''file'' по смещению ''off'' и размером блока ''sz''.</li>
<li>''int fileWrite( string file, string str, bool append = false );'' — записывает строку ''str'' в файл ''file'', удаляя присутствующий файл или добавляя в него, ''append''. Возвращает количество записанных байт.</li>
<li>''int fileRemove( string file );'' — удаляет файл ''file''. Возвращает результат удаления.</li>
<li>''int message( string cat, int level, string mess );'' — формирует системное сообщение ''mess'' с категорией ''cat'', уровнем ''level'' (-7...7). Отрицательное значение уровня формирует нарушения — "Alarm.</li>
<li>''int messDebug( string cat, string mess ); int messInfo( string cat, string mess ); int messNote( string cat, string mess ); int messWarning( string cat, string mess ); int messErr( string cat, string mess ); int messCrit( string cat, string mess ); int messAlert( string cat, string mess ); int messEmerg( string cat, string mess );'' — формирует системное сообщения ''mess'' с категорией ''cat'' и соответствующим к имени уровнем.</li>
<li>''XMLNodeObj XMLNode( string name = "" );'' — создаёт объект узла XML c именем ''name''.</li>
<li>''string cntrReq( XMLNodeObj req, string stat = "" );'' — отправляет запрос [[Special:MyLanguage/Documents/API#CntrNode|интерфейса управления]] к программе-системе посредством XML. Обычный запрос записывается в виде '''<get path="/OPath/%2felem"/>'''. При указании станции в ''stat'' осуществляется запрос к указанной внешней станции. Адрес, атрибут "path", можно узнать в конфигураторе OpenSCADA, а именно в строке статуса, где этот адрес появляется при наведении курсора мыши на конфигурационное или информационное поле. Некоторые примеры распространённых запросов, больше примеров в [[Special:MyLanguage/Libs/Service_procedures#releaseTests|releaseTests()]]:<ul>
 <li>Чтение значения элемента (имя пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("get").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR");
SYS.cntrReq(req);
idSt = req.text(); </syntaxhighlight></li>
 <li>Запись значения элемента (имя пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("set").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR").setText("New test user name");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Добавление нового узла (пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("add").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Удаление узла (пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("del").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Сохранение изменений узла в БД (пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("save").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Загрузка узла из БД (пользователя "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("load").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
</ul></li>
<li>''string lang(string full);'' — возврашает системный язык двумя символами и полный язык в ''full''.</li>
<li>''int sleep(real tm, int ntm = 0);'' — усыпляет поток исполнения на ''tm'' секунд (c точностью до наносекунд) и ''ntm'' наносекунд. Время сна можно установить не более STD_INTERF_TM (5 секунд).</li>
<li>''int time( int usec );'' — возвращает абсолютное время в секундах от эпохи 1.1.1970 и микросекунды в ''usec'', если указан.</li>
<li>''int utime( ); int mtime( );'' — возвращает абсолютное время в микросекундах и миллисекундах от эпохи 1.1.1970.</li>
<li>''int {localtime|gmtime}( int fullsec, int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst );'' — возвращает полную дату и время в секундах (sec), минутах (min), часах (hour), днях месяца (mday), месяце (month), годе (year), днях недели (wday), днях в году (yday) и признак летнего времени (isdst), исходя из абсолютного времени в секундах ''fullsec'' от эпохи 1.1.1970. ''gmtime'' возвращает время в GMT(UTC).</li>
<li>''int {mktime|timegm}(int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst);'' — формирует время с эпохи 1.1.1970 из отдельно указанных секунд, минут, часов, дней, месяцев и т.д. Значения отдельных единиц времени могут указываться за границей их обычного диапазона, что позволяет использовать эту функцию при переборе, в последствии чего единицы времени будут откорректированы и возвращены в обычном диапазоне. ''timegm'' работает с временем в GMT(UTC). </li>
<li>''string {strftime|strftimegm}( int sec, string form = "%Y-%m-%d %H:%M:%S" );'' — преобразует абсолютное время ''sec'' в строку нужного формата ''form''. Запись формата соответствует POSIX-функции ''strftime''. ''strftimegm'' возвращает время в GMT(UTC).</li>
<li>''int {strptime|strptimegm}( string str, string form = "%Y-%m-%d %H:%M:%S" );'' — возвращает время в секундах от эпохи 1.1.1970, исходя из строковой записи времени ''str'', в соответствии с указанным шаблоном ''form''. Например, шаблону "%Y-%m-%d %H:%M:%S" соответствует время "2006-08-08 11:21:55". Описание формата шаблона можно получить из документации на POSIX-функцию ''strptime''. ''strptimegm'' работает с временем в GMT(UTC).</li>
<li>''int cron( string cronreq, int base = 0 );'' — возвращает время, спланированное в формате стандарта Cron, ''cronreq'', начиная от базового времени ''base'' или от текущего, если базовое не указано.</li>
<li>''string strFromCharCode( int char1, int char2, int char3, ... );'' — создаёт строку из кодов символов ''char1'', ''char2'' ... ''charN''.</li>
<li>''string strFromCharUTF([string type = "UTF-8",] int char1, int char2, int char3, ...);'' — создаёт строку из UTF-8 символов ''char1'', ''char2'' ... ''charN''. Следующие типы символа поддерживаются: UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE.</li>
<li>''string strCodeConv( string src, string fromCP, string toCP );'' — перекодирует текст ''src'' из кодировки ''fromCP'' в ''toCP''. Если кодировка опущена (пустая строка), то используется внутренняя.</li>
<li>''string strEncode( string src, string tp = "Bin", string opt1 = "" );'' — кодирует строку ''src'' по правилу ''tp'' и опции ''opt1''. Доступные правила:
:"PathEl" — символы '''[/%]''' в "%2f" и "%25", соответственно;
:"HttpURL" — символы '''[ \t%]''' и "> 0x80" в "%20", "%09", "%25" и т.д.;
:"HTML" — символы HTML-сущностей '''[><"&']''' в "&amp;gt;", "&amp;lt;", "&amp;quot;" и т.д.;
:"JavaScript" — символ '\n' экранированием "\\n";
:"SQL" — экранирование-защита символов '''['"`\]''', добавлением символа '\' или дублирование перечисленных в ''opt1'' символов;
:"Custom" — символов указанных в ''opt1'' в вид "%NN";
:"Base64" — бинарное кодирование в Base 64, где в ''opt1'' устанавливается символ(ы) прерывания строки после 57 символов;
:"FormatPrint" — символ '%' в "%%";
:"OscdID" — почти все символы вроде '''[ /\&(]''' в '_';
:"Bin" — перечень ASCII байт ("XX XX XX XX ...") в бинарное представление;
:"Reverse" — инверсия последовательности;
:"ShieldSimb" — защищённые символы вида '\a', '\b', ..., '\0NNN', '\xNN' в бинарное представление;
:"ToLower" — символы к нижнему регистру;
:"Limit" — ограничение строки длиной в ''opt1'', учитывая переменную длину UTF-8;
:"ShieldBin" — защита бинарных символов [\x0-\x8\xB-\xC\x0E-\x1F].
</li>
<li>''string strDecode( string src, string tp = "Bin", string opt1 = "" );'' — декодирует строку ''src'' по правилу ''tp'' и опции ''opt1''. Доступные правила:
:"PathEl", "HttpURL", "Custom" — символы вида "%NN" в бинарное представление;
:"Base64" — соответственно из Base 64;
:"Bin" — бинарную строку в ASCII байты ("XX XX XX XX ..  A.b.c.."), ''opt1'' указывает на разделитель или "<text>", для включения смещения слева и текстовой части справа.
</li></ul>
 h Ukrainian (uk)== {{Anch|SYS|Програма-система (SYS)}} ==
Функції об'єкту:
<ul>
<li>''{string|int} system( string cmd, bool noPipe = false);'' — викликає консольні команди ''cmd'' ОС з поверненням результату по каналу. Якщо встановлено ''noPipe'' то повертається код повернення виклику та можливий запуск програм у фоні ("sleep 5 &"). Функція надає користувачу OpenSCADA широкі можливості через виклик будь яких системних програм, утиліт та скриптів, а також отримання за посередництвом них доступу до величезного об'єму системних даних. Наприклад, команда "ls -l" поверне деталізований вміст робочої теки.</li>
<li>''int fileSize( string file );'' — повертає розмір файлу ''file''.</li>
<li>''string fileRead( string file, int off = 0, int sz = -1 );'' — повертає рядок частини файлу ''file'' за зміщенням ''off'' та розміром ''sz''.</li>
<li>''int fileWrite( string file, string str, bool append = false );'' — записує рядок ''str'' до файлу ''file'', видаляючи присутній файл або додаючи до нього, ''append''. Повертає кількість записаних байт.</li>
<li>''int fileRemove( string file );'' — видаляє файл ''file''. Повертає результат видалення.</li>
<li>''int message( string cat, int level, string mess );'' — формує системне повідомлення ''mess'' з категорією ''cat'', рівнем ''level'' (-7...7). Негативне значення рівня формує порушення — "Alarm".</li>
<li>''int messDebug( string cat, string mess ); int messInfo( string cat, string mess ); int messNote( string cat, string mess ); int messWarning( string cat, string mess ); int messErr( string cat, string mess ); int messCrit( string cat, string mess ); int messAlert( string cat, string mess ); int messEmerg( string cat, string mess );'' — формує системне повідомлення ''mess'' з категорією ''cat'' та відповідним до назви рівнем.</li>
<li>''XMLNodeObj XMLNode( string name = "" );'' — створює об'єкт вузла XML з ім'ям ''name''.</li>
<li>''string cntrReq( XMLNodeObj req, string stat = "" );'' — надсилає запит ''req'' у вигляді XML до [[Special:MyLanguage/Documents/API#CntrNode|Інтерфейсу Управління]] програми. Повертає рядок із помилкою у форматі "'''{errCod}:{errText}'''", який "0" для успіху. Запит загалом записується у вигляді '''<get path="/OPath/%2felem" />''' та із додатковими атрибутами, специфічними до конкретного запиту. При визначені станції ''stat'' здійснюється запит до вказаної зовнішньої станції. Адресу до атрибуту "path" можна дізнатися у конфігураторі OpenSCADA, а саме у рядку статусу, де ця адреса виникає при наведені курсору миші на конфігураційне або інформаційне поле. Деякі приклади розповсюджених запитів, більше прикладів у [[Special:MyLanguage/Documents/API#CntrNode|описі Інтерфейсу Управління]] та [[Special:MyLanguage/Libs/Service_procedures#releaseTests|releaseTests()]]:<ul>
 <li>Читання значення елементу (ім'я користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("get").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR");
SYS.cntrReq(req);
idSt = req.text(); </syntaxhighlight></li>
 <li>Запис значення елемента (ім'я користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("set").setAttr("path","/sub_Security/usr_test/%2fprm%2fDESCR").setText("New test user name");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Додання нового вузла (користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("add").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Видалення вузла (користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("del").setAttr("path","/sub_Security/%2fbr%2fusr_").setText("test");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Збереження змін вузла у БД (користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("save").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
<li>Завантаження вузла з БД (користувача "test"):
<syntaxhighlight lang="JavaScript">
req = SYS.XMLNode("load").setAttr("path","/sub_Security/usr_test/%2fobj");
SYS.cntrReq(req); </syntaxhighlight></li>
</ul></li>
<li>''string lang(string full);'' — повертає системну мову двома символами та повну мову у ''full''.</li>
<li>''int sleep(real tm, int ntm = 0);'' — засипає потік виконання на ''tm'' секунд (з точністю до наносекунд) та ''ntm'' наносекунд. Час сну можна встановити не більш STD_INTERF_TM (5 секунд).</li>
<li>''int time( int usec );'' — повертає абсолютний час у секундах від епохи 1.1.1970 та мікросекунди у ''usec'', якщо вказано.</li>
<li>''int utime( ); int mtime( );'' — повертає абсолютний час у мікросекундах та мілісекундах від епохи 1.1.1970.</li>
<li>''int {localtime|gmtime}( int fullsec, int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst );'' — повертає повну дату та час у секундах (sec), хвилинах (min), годинах (hour), днях місяця (mday), місяцях (month), роках (year), днях тижня (wday), днях у році (yday) та ознаку літнього часу (isdst), виходячи з абсолютного часу у секундах ''fullsec'' від епохи 1.1.1970. ''gmtime'' повертає час у GMT(UTC).</li>
<li>''int {mktime|timegm}(int sec, int min, int hour, int mday, int month, int year, int wday, int yday, int isdst);'' — формує час з епохи 1.1.1970 з окремо вказаних секунд, хвилин, годин, днів, місяців та інше. Значення окремих одиниць часу можуть вказуватися за межами їх звичного діапазону, що дозволяє використовувати цю функцію при переборі та у результаті чого одиниці часу буде виправлено та повернуто у звичайному діапазоні. ''timegm'' працює з часом у GMT(UTC). </li>
<li>''string {strftime|strftimegm}( int sec, string form = "%Y-%m-%d %H:%M:%S" );'' — перетворює абсолютний час ''sec'' у рядок потрібного формату ''form''. Запис формату відповідає POSIX-функції ''strftime''. ''strftimegm'' повертає час у GMT(UTC).</li>
<li>''int {strptime|strptimegm}( string str, string form = "%Y-%m-%d %H:%M:%S" );'' — повертає час у секундах від епохи 1.1.1970, виходячи з строкового запису часу ''str'', відповідно до вказаного шаблону ''form''. Наприклад, шаблону "%Y-%m-%d %H:%M:%S" відповідає час "2006-08-08 11:21:55". Опис формату шаблону можна отримати з документації на POSIX-функцію ''strptime''. ''strptimegm'' працює з часом у GMT(UTC).</li>
<li>''{{Anch|CRON|<nowiki>int cron( string cronreq, int base = 0 );</nowiki>}}'' — повертає час, спланований у форматі стандарту CRON, ''cronreq'', починаючи від базового часу ''base'' або від поточного, якщо базовий не вказано. Форма стандарту CRON це "* * * * *".
; Де елементи по черзі:
* хвилини (0-59);
* години (0-23);
* дні (1-31);
* місяці (1-12);
* дні тижня (0[Неділя]-6).
; Де варіанти елементу:
* "*" — будь яке значення;
* "1,2,3" — дозволені значення;
* "1-5" — діапазон дозволених значень;
* "*/2" — дільник загального діапазону дозволених значень.
; Приклади:
* "* * * * *" — кожна хвилина;
* "10 23 * * *" — лише 23я година та 10а хвилина будь якого дня та місяця;
* "*/2 * * * *" — для хвилин: 0,2,4,...,56,58;
* "* 2-4 * * *" — для будь якої хвилини у годинах від 2 до 4(включно).
</li>
<li>''string strFromCharCode( int char1, int char2, int char3, ... );'' — створює рядок з кодів символів ''char1'', ''char2'' ... ''charN''.</li>
<li>''string strFromCharUTF([string type = "UTF-8",] int char1, int char2, int char3, ...);'' — створює рядок з UTF символів ''char1'', ''char2'' ... ''charN''. Наступні типи символу підтримуються: UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE.</li>
<li>''string strCodeConv( string src, string fromCP, string toCP );'' — перекодовує текст ''src'' з кодування ''fromCP'' у ''toCP''. Якщо кодування опущено (порожній рядок), то використовується внутрішнє.</li>
<li>''string strEncode( string src, string tp = "Bin", string opt = "" );'' — кодує рядок ''src'' за правилом ''tp'' та опції ''opt''. Доступні правила:
:"PathEl" — символи '''[/%]''' у "%2f" та "%25", відповідно;
:"HttpURL" — символи '''[ \t%]''' та "> 0x80" у "%20", "%09", "%25" та інше;
:"HTML" — символи HTML-сутностей '''[><"&']''' у "&amp;gt;", "&amp;lt;", "&amp;quot;" та інше;
:"JavaScript" — символ '\n' екрануванням "\\n";
:"SQL" — екранування-захист символів '''['"`\]''', доданням символу '\' або дублювання перелічених у ''opt'' символів;
:"Custom" — символів вказаних у ''opt'' у вигляд "%NN";
:"Base64" — бінарне кодування у Base 64, де у ''opt'' встановлюються символ(и) переривання рядку після 57 символів;
:"FormatPrint" — символ '%' в "%%";
:"OscdID" — майже всі символи на кшталт '''[ /\&(]''' у '_';
:"Bin" — перелік ASCII байтів ("XX XX XX XX ...") у бінарне представлення;
:"Reverse" — інверсія послідовності;
:"ToLower" — символи до нижнього регістру;
:"Limit" — обмеження рядку довжиною у ''opt'', враховуючи змінну довжину UTF-8;
:"ShieldSymb" — захист символів із ''opt'' (типово ['"`]) символом слешу "\" на кшталт '\n', '\r', ..., '\0NNN';
:"ShieldBin" — захист усіх бінарних символів [\x0-\x8\xB-\xC\x0E-\x1F] символом слешу "\".
</li>
<li>''string strDecode( string src, string tp = "Bin", string opt = "" );'' — декодує рядок ''src'' за правилом ''tp'' та опції ''opt''. Доступні правила:
:"PathEl", "HttpURL", "Custom" — символи вигляду "%NN" у бінарне представлення;
:"Base64" — відповідно з Base 64;
:"Bin" — бінарний рядок у ASCII байти ("XX XX XX XX ..  A.b.c.."), ''opt'' вказує на роздільник або "<text>", для включення зміщення ліворуч та текстової частини праворуч;
:"ShieldSymb" — захищені символи на кшталт '\n', '\r', ..., '\0NNN', '\xNN' у бінарне представлення.
</li></ul>
Retrieved from "http://oscada.org/wiki/Special:Translations"