Разбивает строку на несколько строк по указанному разделителю. Разделитель может иметь любую длину. В случаях, когда разделителем является строка из одного символа, и не используется параметр СокращатьНепечатаемыеСимволы, рекомендуется использовать функцию платформы СтрРазделить.

Синтаксис

Функция РазложитьСтрокуВМассивПодстрок(Знач Значение, Знач Разделитель = ",", Знач ПропускатьПустыеСтроки = Неопределено, 
СокращатьНепечатаемыеСимволы = Ложь) Экспорт

Параметры

• Значение — Строка - текст с разделителями.
• Разделитель — Строка - разделитель строк текста, минимум 1 символ.
• ПропускатьПустыеСтроки — Булево - признак необходимости включения в результат пустых строк. Если параметр не задан, то функция работает в режиме совместимости со своей предыдущей версией:

  для разделителя-пробела пустые строки не включаются в результат, для остальных разделителей пустые строки включаются в результат; если параметр Строка не содержит значащих символов или не содержит ни одного символа (пустая строка), то в случае разделителя-пробела результатом функции будет массив, содержащий одно значение "" (пустая строка), а при других разделителях результатом функции будет пустой массив.

• СокращатьНепечатаемыеСимволы — Булево - сокращать непечатаемые символы по краям каждой из найденных подстрок.

Возвращаемое значение

Массив из Строка

Пример вызова

СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(",один,,два,", ",")
- возвратит массив из 5 элементов, три из которых  - пустые: "", "один", "", "два", "";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(",один,,два,", ",", Истина)
- возвратит массив из двух элементов: "один", "два";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(" один   два  ", " ")
- возвратит массив из двух элементов: "один", "два";
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("")
- возвратит пустой массив;
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("",,Ложь)
- возвратит массив с одним элементом: ""(пустая строка);
СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок("", " ")
- возвратит массив с одним элементом: "" (пустая строка).

Доступность

Сервер, Тонкий клиент, Толстый клиент, Внешнее соединение