From OpenSCADAWiki
Jump to: navigation, search

Загальносистемні користувацькі об'єкти

JavaLikeCalc надає підтримку типу даних об'єкт "Object". Об'єкт представляє собою асоціативний контейнер властивостей та функцій. Властивості можуть містити як дані чотирьох базових типів, так і інші об'єкти. Доступ до властивостей об'єкту може здійснюватися за посередництвом запису імен властивостей до об'єкту obj.prop, через крапку, а також за посередництвом включення імені властивості у квадратні дужки obj["prop"]. Очевидно, що перший механізм статичний, а другий дозволяє вказувати ім'я властивості через змінну. Ім'я властивості через крапку не має починатися на цифру та містити символи операцій, інакше, для першої цифри, має використовуватися префікс об'єкту — SYS.BD.SQLite.db_1s, або здійснюватися запис у квадратних дужках — SYS.BD.SQLite["1+s"], для символів операцій у назві. Видалити властивість об'єкту можна директивою "delete". Читання невизначеної властивості поверне null-EVAL. Створення об'єкту здійснюється за посередництвом ключового слова new: varO = new Object(). Базове визначення об'єкту не містить функцій. Операції копіювання об'єкту, насправді, роблять посилання на початковий об'єкт. При видаленні об'єкту здійснюється зменшення лічильника посилань, а за досягненням лічильника нуля, об'єкт видаляється фізично.

Різні компоненти OpenSCADA можуть довизначати базовий об'єкт особливими властивостями та функціями. Стандартним розширенням об'єкту є масив "Array", який створюється командою varO = new Array(prm1,prm2,prm3,...,prmN). Перелічені через кому параметри поміщаються до масиву у вихідній послідовності. Якщо параметр тільки один тоді масив ініціюється вказаною кількістю порожніх елементів. Особливістю масиву є те, що він працює із властивостями, як з індексами та основним механізмом звернення є включення індексу у квадратні дужки arr[1]. Масив зберігає властивості у власному контейнері одномірного масиву. Цифрові властивості масиву використовуються для доступу безпосередньо до масиву, а символьні працюють як властивості об'єкту. Детальніше про властивості та функції масиву можна прочитати за посиланням.

Об'єкт регулярного виразу "RegExp" створюється командою varO = new RegExp(pat, flg), де pat — шаблон регулярного виразу, а flg — ознаки пошуку. Об'єкт роботи із регулярними виразами оснований на бібліотеці "PCRE". При глобальному пошуку встановлюється атрибут об'єкту "lastIndex", що дозволяє продовжити пошук у наступному виклику функції. У випадку невдалого пошуку атрибут "lastIndex" скидається у нуль. Детальніше про властивості та функції об'єкту регулярного виразу можна прочитати за посиланням.

Для довільного доступу до аргументів функції передбачено об'єкт аргументів, звернутися до якого можна за посередництвом символу "arguments". Цей об'єкт містить властивість "length" з кількістю аргументів у функції та дозволяє звернутися до значень аргументу за посередництвом його номеру або ідентифікатору. Розглянемо перебір аргументів по циклу: 

args = new Array();
for(var i = 0; i < arguments.length; i++)
  args[i] = arguments[i];

Часткові властивості об'єкту мають і базові типи. Властивості та функції базових типів приведено нижче:

  • Нульовий тип, функції:
    • bool isEVal(); — повертає "true".
  • Логічний тип, функції:
    • bool isEVal(); bool isNaN( ); — перевіряє значення на null-EVAL.
    • string toString(); — надає значення у вигляді рядка "true" або "false".
  • real toReal(); — читає логічне значення як реальне число.
  • int toInt(); — читає логічне значення як ціле число.
  • Ціле та реальне число:
Властивості:
  • MAX_VALUE — максимальне значення;
  • MIN_VALUE — мінімальне значення;
  • NaN — недостовірне значення.
Функції:
  • bool isEVal(); bool isNaN( ); — перевіряє значення на null-EVAL, та не число для Реального.
  • string toExponential( int numbs = -1 ); — повертає рядок відформатованого числа, у експоненціальній нотації та кількістю значущих цифр numbs. Якщо numbs відсутній то цифр буде стільки скільки потрібно.
  • string toFixed( int numbs = 0, int len = 0, bool sign = false ); — повертає рядок відформатованого числа в нотації з фіксованою точкою та кількістю цифр після десяткової точки numbs, з мінімальною довжиною len та обов'язковим знаком sign. Якщо numbs відсутній то кількість цифр після десяткової точки дорівнює нулю.
  • string toPrecision( int prec = -1 ); — повертає рядок відформатованого числа з кількістю значущих цифр prec.
  • string toString( int base = 10, int len = -1, bool sign = false ); — повертає рядок відформатованого числа цілого типу з базою представлення base (2-36), з мінімальною довжиною len та обов'язковим знаком sign.
  • real toReal(); — читає ціле-реальне значення як реальне число.
  • int toInt(); — читає ціле-реальне значення як ціле число.
  • Рядок:
Властивості:
  • int length — довжина рядка.
Функції:
  • bool isEVal(); — перевіряє значення на null-EVAL.
  • bool isNaN( bool whole = true ); — перевіряє рядок на не число, та загалом whole.
  • string charAt( int symb, string type = "" ); — дістає із рядка символ за номером symb типу type. Наступні типи символу підтримуються: ""-ASCII та простий одно байтовий, UTF-8, UTF-16, UTF-32. У випадку із UTF-8, позиція символу symb змінюється у позицію наступного символу оскільки довжина символів цього типу змінна.
  • int charCodeAt( int symb, string type = "" ); — дістає із рядка код символу symb типу type. Наступні типи символу підтримуються: ""-ASCII та простий одно байтовий, UTF-8, UTF-16, UTF-16LE, UTF-16BE, UTF-32, UTF-32LE, UTF-32BE. У випадку із UTF-8, позиція символу symb змінюється у позицію наступного символу оскільки довжина символів цього типу змінна.
  • string concat( string val1, string val2, ... ); — повертає новий рядок, сформований шляхом приєднання значень val1 та інші до початкового.
  • int indexOf( string substr, int start = 0 ); — повертає позицію пошукового рядка substr у вихідному рядку, починаючи з позиції start. Якщо вихідна позиція не вказана то пошук починається з початку. Якщо шуканого рядка не знайдено то повертається "-1".
  • int lastIndexOf( string substr, int start = {end} ); — повертає позицію шуканого рядка substr у вихідному рядку починаючи з позиції start, при пошуку з кінця. Якщо вихідна позиція не вказана то пошук починається з кінця. Якщо шуканого рядку не знайдено то повертається "-1".
  • int search( string pat, string flg = "" ); — шукає у рядку за шаблоном pat та ознаками шаблону flg. Повертає положення знайденого рядку інакше "-1".
var rez = "Java123Script".search("script","i");  // rez = 7
  • int search( RegExp pat ); — шукає у рядку за шаблоном "RegExp" pat. Повертає положення найденого підрядку інакше "-1".
var rez = "Java123Script".search(new RegExp("script","i"));  // rez = 7
  • Array match( string pat, string flg = "" ); — шукає у рядку за шаблоном pat та ознаками шаблону flg. Повертає масив із знайденим підрядком (0) та підвиразами (>1). Атрибут "index" масиву встановлюється у позицію знайденого підрядка. Атрибут "input" встановлюється у початковий рядок. Атрибут "err" встановлюється у код помилки операції.
var rez = "1 плюс 2 плюс 3".match("\\d+","g");  // rez = [1], [2], [3]
  • Array match( TRegExp pat ); — шукає у рядку за шаблоном "RegExp" pat. Повертає масив зі знайденим підрядком (0) та підвиразами (>1). Атрибут "index" масиву встановлюється у позицію знайденого підрядка. Атрибут "input" встановлюється у початковий рядок. Атрибут "err" встановлюється у код помилки операції.
var rez = "1 плюс 2 плюс 3".match(new RegExp("\\d+","g"));  // rez = [1], [2], [3]
  • string slice( int beg, int end ); string substring( int beg, int end ); — повертає підрядок вилучений з початкового, починаючи з позиції beg та до end (не включаючи), нумерація з нуля. Якщо значення початку або кінця негативне, то відлік ведеться з кінця рядку. Якщо кінець не вказано, то кінцем є кінець рядку. Наприклад, конструкція substring(-2) поверне останні два символи рядку.
  • Array split( string sep, int limit = 0 ); — повертає масив елементів рядку поділених sep та з обмеженням кількості елементів limit (0 без обмеження).
  • Array split( RegExp pat, int limit = 0 ); — повертає масив елементів рядку поділених шаблоном "RegExp" pat та з обмеженням кількості елементів limit (0 без обмеження).
rez = "1,2, 3 , 4 ,5".split(new RegExp("\\s*,\\s*"));  // rez = [1], [2], [3], [4], [5]
  • string insert( int pos, string substr ); — вставляє підрядок substr у позицію pos поточного рядку.
  • string replace( int pos, int n, string str ); — замінює підрядок з позиції pos та довжиною n у поточному рядку, на рядок str.
rez = "Javascript".replace(4,3,"67");  // rez = "Java67ipt"
  • string replace( string substr, string str ); — замінює всі підрядки substr на рядок str. 
rez = "123 321".replace("3","55");  // rez = "1255 5521"
  • string replace( RegExp pat, string str ); — замінює підрядок за шаблоном pat на рядок str.
rez = "value = \"123\"".replace(new RegExp("\"([^\"]*)\"","g"),"``$1''"));  // rez = "value = ``123''"
  • real toReal(); — перетворює поточной рядок у реальне число.
  • int toInt( int base = 10 ); — перетворює поточний рядок у ціле число, відповідно до основи base (від 2 до 36). Якщо основа дорівнює 0 тоді буде враховуватися префіксний запис для визначення основи (123-десяткове; 0123-вісімкове; 0x123-шістнадцяткове).
  • string {parse,parseEnd}( int pos, string sep = ".", int off = {0,{length}}, bool mergeSepSymb = false ); — виокремлює із вихідного рядку елемент pos для роздільника елементів sep та від зміщення off (зупинка на початку наступного токену, або кінці для parseEnd). mergeSepSymb визначає дозвіл поєднання групи однакових символів у один роздільник. Результуюче зміщення поміщається назад до off. parseEnd() робить те саме, але з кінця.
  • string parseLine( int pos, int off = 0 ); — виокремлює рядок з номером pos від зміщення off (зупинка на початку наступного токену). Результуюче зміщення поміщається назад до off.
  • string parsePath( int pos, int offCmptbl = 0, int off = 0 ); — виділяє з початкового шляху елемент pos від зміщення off (зупинка на початку наступного токену) або offCmtbl (зупинка на наступному символі кінця поточного токену — для сумісності). Результуюче зміщення поміщається назад до off або offCmtbl.
  • string parsePathEnd( int pos, int off = {length} ); — виділяє з кінця рядка початкового шляху елемент pos від зміщення off (зупинка на кінці наступного токену). Результуюче зміщення поміщається назад до off.
  • string path2sep( string sep = "." ); — перетворює шлях у поточному рядку у рядок з розділювачем sep.
  • string trim( string cfg = " \n\t\r" ); — обрізає рядок з початку та кінцю, для символів cfg.
Retrieved from "http://oscada.org/wiki/index.php?title=Translations:Documents/User_API/6/uk&oldid=89206"