Admin: 1 revision imported

2021-02-07T06:54:36Z

1 revision imported

Admin: Created page with "{{infobox function |name=TearStr |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в с..."

2019-04-21T08:18:58Z

Created page with "{{infobox function |name=TearStr |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в с..."

New page

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

{{TearStr vs GetSubStr}}

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

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

//Будет выведено "Производится", аСтр содержит фразу "разбор этой строки"
Message(TearStr(аСтр," "));

//Будет выведено "разбор", аСтр содержит фразу "этой строки"
Message(TearStr(аСтр," "));

//Будет выведено "этой", аСтр содержит слово "строки"
Message(TearStr(аСтр," "));

//Будет выведено "строки", аСтр содержит пустую строку ""
Message(TearStr(аСтр," "));
</pre>

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

TearStr - Revision history

Admin: 1 revision imported

Admin: Created page with "{{infobox function |name=TearStr |caption=Функции работы со строками |type=1 |status=2 |db=0 |exception=Невозможно превратить в с..."