Admin: 1 revision imported

2021-02-07T06:51:15Z

1 revision imported

Admin at 09:49, 21 April 2019

2019-04-21T09:49:03Z

New page

{{infobox function
|name=GetSubStr
|caption=Функции работы со строками
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]]}}
Функция получает подстроку исходной строки, начиная с индекса символа, указанного во втором аргументе до следуюшего вхождения строки-разделителя в исходную строку. Индекс обновляется до позиции, непосредственно за найденной строкой-разделителем, если второй аргумент был переменной. Функция может использоваться для разбора строк в различных ситуациях, от форматированного XML или JSON, до прохода по тексту, разделенному знаками переноса строк. Для практического понимания, функция является последовательностью из функций Pos и Mid, работающих на системном уровне.

{{TearStr vs GetSubStr}}

== Синтаксис ==
<code>
'''GetSubStr'''(''<Строка>'',{{ByRef|''<Индекс (INT)>''}}{{Optional|,''<Подстрока-разделитель>''{{Default|{{Eq}}"@"}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Строка>''</code> - Значение, над строковым представлением которого необходимо провести операцию.
* <code>''<Индекс (INT)>''</code> - {{ByRef}} Индекс, с которого начинается поиск подстроки в исходной строке. Начальное значение индекса 1, но принимается и нулевое значение, котрое также будет означать начало текста. После того, как вся строка разобрана, индекс имеет значение длины строки увеличенной на единицу.
* <code>''<Подстрока-разделитель>''</code> - {{Optional}} Значение, строковое представление которого используется, как разделитель. Разделитель и его части не будут отдаваться в результате. По умолчанию используется знак ''at'' ('''@''').
==== Возвращаемое значение ====
Возвращает подстроку, начиная с индекса до найденного разделителя, либо до конца строки, если разделитель не найден. Результат может быть как ANSI строкой, так и UTF-16 строкой в зависимости от типа строки первого аргумента.

== Примеры ==
<pre>
аСтр:="Производится разбор этой строки";
i:=1;

//Будет выведено "Производится", i имеет значение 14
Message(GetSubStr(аСтр,i," "));

//Будет выведено "разбор", i имеет значение 21
Message(GetSubStr(аСтр,i," "));

//Будет выведено "этой", i имеет значение 26
Message(GetSubStr(аСтр,i," "));

//Будет выведено "строки", i имеет значение 32 (длина строки 31)
Message(GetSubStr(аСтр,i," "));
</pre>

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)

GetSubStr - Revision history

Admin: 1 revision imported

Admin at 09:49, 21 April 2019