Параметры:

Str       -    строка для поиска в

Oldstr   -    строка для поиска

Newstr  -    строка для замены

K          -    (опционально). Несколько вариантов oldstr для замены:

            =   0: заменить все случаи oldstr (то же самое, если k опущен)

            >   0: заменить первый k (местонахождение) в oldstr

            <   0: заменить последний k (местонахождение) в oldstr

Описание:

Эта функция заменяет k появления Oldstr в str с новой str, и возвращает str. Если oldstr не был сочтен функциональными возвратами str как строка результата. Отметьте, что GPPL действительно различает строчные и прописные буквы.

Правильно:

s = replace("abacad", "a", "x", 0)         ==> s = "xbxcxd" (один к одному)

s = replace("abacad", "a", "xy", 0)       ==> s = "xybxycxyd" (один на многое)

s = replace("abacad", "a", "", 0)           ==> s = "bcd" (один на ноль)

s = replace("abacad", "ac", "X", 0)       ==> s = "abXad" (многое на один/многое)

s = replace("abacad", "x", "y", 0)         ==> s = "abacad" (только для указанных целей)

s = replace("abacad", "a", "xa", 0)       ==> s = "xabxacxad" (без рекурсии)

s = replace("", "a", "x", 0)                    ==> s = "" (только для указанных целей)

s = replace("abacad", "", "x", 0)           ==> s = "abacad" (только для указанных целей, нет ошибки)

s = replace("abacad", "A", "x", 0)         ==> s = "abacad" (с учетом регистра)

s = replace("ab"+"acad", "a", "x", 0)    ==> s = "xbxcxd" (выражения допущенные)

s = replace("abacad", "a", "x", 2)         ==> s = "xbxcad" (только сначала 2 случая)

s = replace("abacad", "a", "x", -2)        ==> s = "abXcXd" (только последние два случая)

s = replace("abacad", "a", "x", 8)         ==> s = "xbXcXd" (также, как k=0, нет ошибки)

Не правильно:

s = replace(123, "a", "b", 0)                 ==> первый аргумент должен быть строкой

rev (string)

Параметры:

string - какое-либо выражение строки.

Описание:

Эта функция возвращает такую же строку с инвертированным порядком её символов.

Примеры:

rev('abcd') ==> 'dcba'

rev('123') ==> '321'

right (str, num)

Параметры:

str - какое-либо выражение строки.

num - какое-либо положительное цифровое выражение.

Описание:

Эта функция возвращает подстроку, которая состоит из символов справа num str. Если str слишком короткая, вся str возвращается (смотрите функцию 'left').

Примеры:

right('abcdef', 4) ==> 'cdef'

right('abcdef',-2) ==> ошибка, (бессмысленный запрос)

right('xyz', 6) ==> 'xyz' (нет 6 символов справа).

space (len)

Параметры:

len - какое-либо неотрицательное цифровое выражение.

Описание:

Эта функция возвращает строку пробелов (интервалов) длиной len. Если len - нуль, то возвращается пустая строка. Эта функция равноценна 'dup(' ', длина)'.

Примеры:

space(5) ==> ' '

space(0) ==> '' (пустая строка)

space(-3) ==> ошибка

strlen (string)

Параметры:

string - какое-либо выражение строки.

Описание:

Функция возвращает длину строки, т.е. число символов в строке.

Примеры:

strlen('abcd') ==> 4

strlen('abcd ') ==> 5 (ставит пробел в конце строки)

strlen('') ==> 0 (длина пустой строки - это нуль)

 substr (string, from, len)

Параметры:

string - какое-либо выражение строки.

from - положение от начала строки, где начинается подстрока. 'from' должен находиться в диапазоне [1, strlen(string)].

len - длина подстроки для извлечения

Описание:

Эта функция возвращает под-строку длины len, начинающейся в строке от положения 'from' и длиной len. Если 'from + len' больше, чем strlen(string), возвращенная под-строка будет длиной менее, чем len.

Примеры:

substr('abcdefg',5,2) ==> 'ef'

substr('abcdefg',5,4) ==> 'efg' (нет больше символов)

substr('abcdefg',9,2) ==> ошибка (9 не является действительным положением)

time

Параметры:

нет.

Описание:

Эта функция возвращает значение строки текущего времени в формате 'HH:MM:SS', где HH - текущий час, ММ - текущие минуты и SS - текущие секунды.

Примеры:

time ==> 10:17:30 (10 часов, 17 минут, 30 сек.)

time ==> 22:17:30 (10 часов ПОПОЛУДНИ, 17 минут, 30 сек.

tonum (string)

Параметры:

string - какое-либо выражение строки, которое удерживает действительное цифровое значение (смотрите описание ниже).

Описание:

Эта функция превращает число, представленное в строке из формата строки в цифровой формат. Действительное число в строке должно иметь следующий формат:

[spaces] [sign] [digits] [.digits] [E [sign] digits]

[пробелы] [знак] [цифры] [.цифры] [E [знак] цифры] – (рус. перевод)

spaces - пробелы (' ').

sign - none ('+' предполагается), '+' или '-'.

digits - какая-либо последовательность десятичных разрядов (0-9).

.digits - десятичная точка, завершающая какую-либо последовательность цифр.

E – начало экспоненциальной части.

sign - none '+' или '-'; знак экспоненты.

digits - значение экспоненты.

Обратное действие 'tonum' - это функция 'tostr'. Смотрите его описание ниже.

Примеры:

tonum(' 12') ==> 12

tonum('-12.34') ==> -12.34

tonum('12.3e2') ==> 1230

tonum('-12E-1') ==> -1.2

tostr (number [:format])

Параметры:

number - какое-либо цифровое выражение.

format - определение формата (необязательно).

Описание:

Эта функция превращает число в изображение строки знаками согласно спецификации формата 'format'. Если 'format' пренебрегается, строка превращается в соответствии с форматом по умолчанию. Смотрите главу детального описания опций 'format'.

Примеры:

tostr(12.345) ==> '12.345'

tostr(12.3456) ==> '12.346' (формат по умолчанию - '5.3').

tostr(12.3456:'4.0') ==> '12.'

trim (string)

Параметры:

string – какое-либо строковое выражение.

Описание:

Эта функция возвращает такую же строку, но исключает все фиксированные пробелы.

Примеры:

trim('abcd') ==> 'abcd' (ничего не отсечено)

trim('abcd ') ==> 'abcd'

upper (string)

Параметры:

string - какое-либо выражение строки.

Описание:

Эта функция возвращает такую же строку, где все написанное на нижнем регистре(a-z) заменяется их эквивалентом верхнего регистра (CAPITAL) (А-Z). Заметьте, что оригинальная строка остается неизмененной. Если вы хотите изменить определенную строку на верхний регистр, вы должны использовать оператор присвоения (смотрите примеры ниже).

Примеры:

upper('TITLE') ==> 'TITLE'

upper('Title no. 1') ==> 'TITLE NO. 1'

line = upper(line) ==> изменяет строку переменных на верхний регистр.

Логические функции. (Logical Functions ).

active (variable)

Параметры:

variable - какая-либо переменная local/global/system.

Описание:

Эта функция возвращает значение TRUE/FALSE (1/0) согласно текущего статуса активного атрибута переменной. Активный атрибут устанавливается в TRUE (ИСТИНА) в следующих случаях:

- Если переменная может использоваться в текущей процедуре.

- Когда переменной присвоено значение.

- Когда пользователь явно использует атрибут оператора присвоения 'active'.

Эта функция наиболее полезна при проверке на условное выполнение ('if' statement - 'если' утверждение) или при генерации модальных элементов (смотрите описание модальности). Смотрите также описание функции 'change'.

Примеры:

active(xpos) - TRUE/FALSE как активный флажок xpos

active(123) - ошибка, выражение не имеет активного атрибута.

active(xpos) = active(xnext) - Устанавливает активный атрибут смены xpos, который является таким же как активный атрибут смены xnext.

 

change (variable)

Параметры:

variable - какая-либо переменная local/global/system.

Описание:

Эта функция возвращает значение TRUE/FALSE (1/0) в соответствии с текущим статусом атрибута смены переменной. Атрибут смены устанавливается в TRUE (ИСТИНА) в следующих случаях:

- Когда переменной присвоено новое значение.

- Когда пользователь явно использует оператор присвоения атрибута 'change'.

Эта функция наиболее полезна при проверке на условное выполнение ('if' statement - 'если' утверждение) или при генерации модальных элементов. Смотрите также описание функции 'active'.

Примеры:

change(xpos) - TRUE/FALSE как флажок смены xpos.

change(123) - ошибка, выражение не имеет атрибута смены.

change(xpos)=change(xnext) - устанавливает атрибут смены изменения xpos, который является таким же, как и атрибут смены переменной.

even (number)

Параметры:

number - какое-либо цифровое выражение.

 

Описание:

Эта функция есть TRUE (ИСТИНА), если число четное.

Примеры:

even(8) ==> TRUE

even(13) ==> FALSE

even(4.2) ==> FALSE

odd (number)

Параметры:

number - какое-либо цифровое выражение.

Описание:

Эта функция есть TRUE, если нечетное число.

Примеры:

odd(7) ==> TRUE

odd14) ==> FALSE

odd(3.2) ==> FALSE