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)=== XML node-tag object (XMLNodeObj) ===
Functions:
* ''string name( )'' — the name of the node, XML-tag.
* ''string text( bool full = false )'' — the text of the node, contents of the XML-tag. Set ''full'' for get the combined text of all included nodes.
* ''string attr( string id )'' — the value of the node attribute ''id''.
* ''XMLNodeObj setName( string vl )'' — sets of the node name to ''vl''. Returns the current node.
* ''XMLNodeObj setText( string vl )'' — sets of the node text to ''vl''. Returns the current node.
* ''XMLNodeObj setAttr( string id, string vl )'' — sets the attribute ''id'' to the value ''vl''. Returns the current node.
* ''XMLNodeObj clear( bool full = false )'' — clears the node for the childs, removes the text and attributes for ''full''.
* ''int childSize( )'' — quantity of the included nodes.
* ''XMLNodeObj childAdd( ElTp no = XMLNodeObj ); XMLNodeObj childAdd( string no )'' — addition of the object ''no'' as the included one. ''no'' may be the direct object-result of the function "SYS.XMLNode()", and the string with the name of a new tag. Returns the included node.
* ''XMLNodeObj childIns( int id, ElTp no = XMLNodeObj ); XMLNodeObj childIns( int id, string no )'' — insert of the object ''no'' as the included one to the position ''id''. ''no'' may be the direct object-result of the function "SYS.XMLNode()", and the string with the name of a new tag. Returns the embedded node.
* ''XMLNodeObj childDel( int id )'' — deletes the included node from the position ''id''. Returns current node.
* ''XMLNodeObj childGet( int id )'' — gets the included node in the position ''id''. Returns '''0''' at missing one.
* ''XMLNodeObj childGet( string name, int num = 0 )'' — gets the included node with the tag ''name'' and the position number ''num''. Returns '''0''' at missing one.
* ''XMLNodeObj parent( )'' — gets the parent node. Returns '''false''' at missing one.
* ''string load( string str, bool file = false, int flg = 0, string cp = "UTF-8" )'' — loads the XML from the string ''str'' or from the file with the path in ''str'' if the ''file'' equal "true", with the source encoding ''cp''. Returns a string with error in the format "'''{errCod}:{errText}'''", which is "0" for successful loading. Where ''flg'' — loading flags:
::0x01 — full loading, with texts and comments blocks into special nodes;
::0x02 — does not remove spaces from the begin and end of the tag text.
* ''string save( int flg = 0, string path = "", string cp = "UTF-8" )'' — saves the XML tree to the string or to the file ''path'' with the formatting flags ''flg'' and target encoding ''cp''. Returns the XML text or the error code. The following formatting options ''flg'' are provided:
::0x01 — end line before the opening tag;
::0x02 — end line after the opening tag;
::0x04 — end line after the closing tag;
::0x08 — end line after the text;
::0x10 — end line after the instruction;
::0x1E — end line after all ones;
::0x20 — inserts the standard XML-header;
::0x40 — inserts the standard XHTML-header;
::0x80 — cleans the service tags: <nowiki><??>, <!-- --></nowiki>;
::0x100 — does not encode the tag name;
::0x200 — does not encode the attribute;
::0x400 — shield the binary symbols [\x0-\x8\xB-\xC\x0E-\x1F] and wrong UTF-8.
* ''XMLNodeObj getElementBy( string val, string attr = "id" )'' — gets an element from the tree by the attribute ''attr'' in value ''val''.
* ''TArrayObj<XMLNodeObj> getElementsBy( string tag, string attrVal = "", string attr = "id", int limit = 0, int from = 0 )'' — gets an elements array from the tree by the ''tag'' (empty for all) and attribute ''attr'' in value ''attrVal'' (empty for pass), also starting the tag number ''from'' and limiting them number in ''limit'' (zero for no limit).
 h Russian (ru)=== Объект узла-тега XML (XMLNodeObj) ===
Функции:
* ''string name( )'' — имя узла, XML-тега.
* ''string text( bool full = false )'' — текст узла, содержимое XML-тега. Установить ''full'' для получения комбинированного текста со всех включенных узлов.
* ''string attr( string id )'' — значение атрибута узла ''id''.
* ''XMLNodeObj setName( string vl )'' — устанавливает имя узла в ''vl''. Возвращает текущий узел.
* ''XMLNodeObj setText( string vl )'' — устанавливает текст узла в ''vl''. Возвращает текущий узел.
* ''XMLNodeObj setAttr( string id, string vl )'' — устанавливает атрибут ''id'' в значение ''vl''. Возвращает текущий узел.
* ''XMLNodeObj clear( bool full = false )'' — очищает узел, удалением дочерних узлов, очищает текст и атрибуты, для ''full''.
* ''int childSize( )'' — количество вложенных узлов.
* ''XMLNodeObj childAdd( ElTp no = XMLNodeObj ); XMLNodeObj childAdd(string no)'' — добавляет объект ''no'' как вложенный. ''no'' может быть как непосредственно объектом-результатом функции "SYS.XMLNode()", так и строкой с именем нового тега. Возвращается вложенный узел.
* ''XMLNodeObj childIns( int id, ElTp no = XMLNodeObj ); XMLNodeObj childIns(int id, string no)'' — вставляет объект ''no'' как вложенный, в позицию ''id''. ''no'' может быть как непосредственно объектом-результатом функции "SYS.XMLNode()", так и строкой с именем нового тега. Возвращается вложенный узел.
* ''XMLNodeObj childDel( int id )'' — удаляет вложенный узел в позиции ''id''. Возвращает текущий узел.
* ''XMLNodeObj childGet( int id )'' — получает вложенный узел в позиции ''id''.
* ''XMLNodeObj childGet( string name, int num = 0 )'' — получает вложенный узел с именем тега ''name'' и порядковым номером ''num''.
* ''XMLNodeObj parent()'' — получает родительский узел.
* ''string load( string str, bool file = false, int flg = 0, string cp = "UTF-8" )'' — загружает XML из строки ''str'' или из файла с путём в ''str'' если ''file'' равно "true", с кодировкой ''cp''. Где ''flg'' — флаги загрузки:
::0x01 — полная загрузка, с блоками текста и комментариями в специальных узлах;
::0x02 — не удалять пробелы в начале и конце текста тега.
* ''string save( int flg = 0, string path = "", string cp = "UTF-8" )'' — сохраняет дерево XML в строку или в файл ''path'' с параметрами форматирования ''flg'' и кодировкой ''cp''. Возвращает текст XML или код ошибки. Предусмотрены следующие флаги форматирования ''flg'':
::0x01 — прерывать строку перед открывающим тегом;
::0x02 — прерывать строку после открывающего тега;
::0x04 — прерывать строку после закрывающего тега;
::0x08 — прерывать строку после текста;
::0x10 — прерывать строку после инструкции;
::0x1E — прерывать строку после всех;
::0x20 — вставлять стандартный XML-заголовок;
::0x40 — вставлять стандартный XHTML-заголовок;
::0x80 — очищать сервисные теги: <nowiki><??>, <!-- --></nowiki>;
::0x100 — не кодировать наименований тегов;
::0x200 — не кодировать наименований атрибутов;
::0x400 — защита бинарных символов [\x0-\x8\xB-\xC\x0E-\x1F] и ошибочных UTF-8.
* ''XMLNodeObj getElementBy( string val, string attr = "id" )'' — получает элемент из дерева по атрибуту ''attr'' со значением ''val''.
* ''TArrayObj<XMLNodeObj> getElementsBy( string tag, string attrVal = "", string attr = "id" )'' — получает массив элементов из дерева по тегу ''tag'' (пустой для всех) и атрибуту ''attr'' со значением ''attrVal'' (пустые для пропуска).
 h Ukrainian (uk)=== Об'єкт вузла-тегу XML (XMLNodeObj) ===
Функції:
* ''string name( )'' — ім'я вузла, XML-тегу.
* ''string text( bool full = false )'' — текст вузла, вміст XML-тегу. Встановити ''full'' для отримання комбінованого тексту зі всіма включеними вузлами.
* ''string attr( string id )'' — значення атрибуту вузла ''id''.
* ''XMLNodeObj setName( string vl )'' — встановлює ім'я вузла у ''vl''. Повертає поточний вузол.
* ''XMLNodeObj setText( string vl )'' — встановлює текст вузла у ''vl''. Повертає поточний вузол.
* ''XMLNodeObj setAttr( string id, string vl )'' — встановлює атрибут ''id'' у значення ''vl''. Повертає поточний вузол.
* ''XMLNodeObj clear( bool full = false )'' — очищує вузол видаленням дочірніх вузлів, очищує текст та атрибути для ''full''.
* ''int childSize( )'' — кількість вкладених вузлів.
* ''XMLNodeObj childAdd( ElTp no = XMLNodeObj ); XMLNodeObj childAdd(string no)'' — додає об'єкт ''no'' як вкладений. ''no'' може бути як безпосередньо об'єктом-результатом функції "SYS.XMLNode()", так і рядком з ім'ям нового тегу. Повертається вкладений вузол.
* ''XMLNodeObj childIns( int id, ElTp no = XMLNodeObj ); XMLNodeObj childIns(int id, string no)'' — вставляє об'єкт ''no'' як вкладений, у позицію ''id''. ''no'' може бути як безпосередньо об'єктом-результатом функції "SYS.XMLNode()", так і рядком з ім'ям нового тегу. Повертається вкладений вузол.
* ''XMLNodeObj childDel( int id )'' — видаляє вкладений вузол у позиції ''id''. Повертає поточний вузол.
* ''XMLNodeObj childGet( int id )'' — отримує вкладений вузол у позиції ''id''. Повертає '''0''' за відсутності.
* ''XMLNodeObj childGet( string name, int num = 0 )'' — отримує вкладений вузол з ім'ям тегу ''name'' та порядковим номером ''num''. Повертає '''0''' за відсутності.
* ''XMLNodeObj parent()'' — отримує батьківський вузол. Повертає '''false''' за відсутності.
* ''string load( string str, bool file = false, int flg = 0, string cp = "UTF-8" )'' — завантажує XML з рядка ''str'' або з файлу з шляхом у ''str'' якщо ''file'' дорівнює "true", з кодуванням ''cp''. Повертає рядок із помилкою у форматі "'''{errCod}:{errText}'''", який "0" для успішного завантаження. Де ''flg'' — прапорці завантаження:
::0x01 — повне завантаження, з блоками тексту та коментарями у спеціальних вузлах;
::0x02 — не видаляти пробіли на початку та кінці тексту тегу.
* ''string save( int flg = 0, string path = "", string cp = "UTF-8" )'' — зберігає дерево XML у рядок або у файлі ''path'', з параметрами форматування ''flg'' та кодуванням ''cp''. Повертає текст XML або код помилки. Передбачено наступні прапорці форматування ''flg'':
::0x01 — переривати рядок перед відкривальним тегом;
::0x02 — переривати рядок після відкривального тегу;
::0x04 — переривати рядок після закривального тегу;
::0x08 — переривати рядок після тексту;
::0x10 — переривати рядок після інструкції;
::0x1E — переривати рядок після всіх;
::0x20 — вставляти стандартний XML-заголовок;
::0x40 — вставляти стандартний XHTML-заголовок;
::0x80 — очищати сервісні теги: <nowiki><??>, <!-- --></nowiki>;
::0x100 — не кодувати назви тегів;
::0x200 — не кодувати назви атрибутів;
::0x400 — захист бінарних символів [\x0-\x8\xB-\xC\x0E-\x1F] та помилкових UTF-8.
* ''XMLNodeObj getElementBy( string val, string attr = "id" )'' — отримує елемент з дерева за атрибутом ''attr'' зі значенням ''val''.
* ''TArrayObj<XMLNodeObj> getElementsBy( string tag, string attrVal = "", string attr = "id", int limit = 0, int from = 0 )'' — отримує масив елементів з дерева за тегом ''tag'' (порожній для всіх) та атрибутом ''attr'' зі значенням ''attrVal'' (порожній для пропуску), також починаючи із тегу з номером ''from'' і обмежуючи їх кількість у ''limit'' (нуль без обмеження).