Справка 1С/Система компоновки данных/Работа со строками

Работа со строками

•

Работа со строками

ДлинаСтроки [#StringLength]
Подстрока [#substring]
СокрЛ [#triml]
СокрП [#trimr]
СокрЛП [#trimall]
Лев [#left]
Прав [#right]
СтрНайти [#strfind]
ВРег [#upper]
НРег [#lower]
СтрЗаменить [#strreplace]
НСтр [#nstr]

ДлинаСтроки (StringLength)

Функция предназначена для определения длины строки.

Синтаксис:

ДлинаСтроки(<Строка>)

Параметр:

  • Строка - тип Строка. Строка, длину которой определяют.

    • Пример:

    Строка(Контрагенты.Адрес)

    Подстрока (Substring)

    Данная функция предназначена для выделения подстроки из строки.

    Синтаксис:

    Подстрока(<Строка>, <Позиция>, <Длина>)

    Параметры:

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

  • Позиция - тип Число. Позиция символа, с которого начинается выделяемая из строки подстрока;

  • Длина - тип Число. Длина выделяемой подстроки.

Пример:

ПОДСТРОКА(Контрагенты.Адрес, 1, 4)

СокрЛ (TrimL)


Данная функция отсекает незначащие символы, стоящие слева от первого значащего символа в строке.

Синтаксис:

СокрЛ(<Строка>)

Параметры:

  • Строка - тип Строка. Исходная строка.

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

  • Тип Строка. Строка, полученная в результате отсечения пробелов.

    • СокрП (TrimR)

    Данная функция отсекает незначащие символы, стоящие справа от последнего значащего символа в строке.

    Синтаксис:

    СокрП(<Строка>)

    Параметры:

  • Строка - тип Строка. Исходная строка.

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

  • Тип Строка. Строка, полученная в результате отсечения пробелов.

    • СокрЛП (TrimAll)

    Данная функция отсекает незначащие символы, стоящие слева от первого значащего символа в строке, и пробелы, стоящие справа от последнего значащего символа в строке.

    Синтаксис:

    СокрЛП(<Строка>)

    Параметры:

  • Строка - тип Строка. Исходная строка.

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

  • Тип Строка. Строка, полученная в результате отсечения пробелов.

    • Лев (Left)

    Данная функция выбирает первые слева символы строки.

    Синтаксис:

    Лев(<Строка>, <ЧислоСимволов>)

    Параметры:

  • Строка - тип Строка. Исходная строка;

  • ЧислоСимволов - тип Число. Количество выбираемых символов. Отрицательные значения считаются нулем. Если в исходной строке меньше символов, чем в параметре, то возвращается исходная строка.

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

  • Тип Строка. Строка выбранных символов.

    • Прав (Right)

    Данная функция выбирает первые справа символы строки.

    Синтаксис:

    Прав(<Строка>, <ЧислоСимволов>)

    Параметры:

  • Строка - тип Строка. Исходная строка;

  • ЧислоСимволов - тип Число. Количество выбираемых символов. Отрицательные значения считаются нулем. Если в исходной строке меньше символов, чем в параметре, то возвращается исходная строка.

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

  • Тип Строка. Строка выбранных символов.

    • СтрНайти (StrFind)

    Данная функция находит первое вхождение искомой строки как подстроки в исходной строке. Поиск выполняется без учета регистра.

    Синтаксис:

    СтрНайти(<Строка>, <ПодстрокаПоиска>)

    Параметры:

  • Строка - тип Строка. Исходная строка;

  • ПодстрокаПоиска - тип Строка. Искомая подстрока.

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

  • Тип Число (длина - 12). Найденная позиция, начиная с 1. Если возвращает 0, то строка не найдена.

    • ВРег (Upper)

    Данная функция преобразует все символы строки в верхний регистр.

    Синтаксис:

    ВРег(<Строка>)

    Параметры:

  • Строка - тип Строка. Исходная строка.

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

  • Тип Строка. Строка, полученная в результате преобразования.

    • НРег (Lower)

    Данная функция преобразует все символы строки в нижний регистр.

    Синтаксис:

    НРег(<Строка>)

    Параметры:

  • Строка - тип Строка. Исходная строка.

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

  • Тип Строка. Строка, полученная в результате преобразования.

    • СтрЗаменить (StrReplace)

    Данная функция находит в исходной строке все вхождения подстроки поиска и заменяет ее на подстроку замены.

    Синтаксис:

    СтрЗаменить(<Строка>,<ПодстрокаПоиска>,<ПодстрокаЗамены>)

    Параметры:

  • Строка - тип Строка. Исходная строка;

  • ПодстрокаПоиска - тип Строка. Искомая подстрока;

  • ПодстрокаЗамены - тип Строка. Подстрока, на которую будет заменена подстрока поиска.

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

    •

    Тип Строка. Строка, полученная в результате замены.

    Если второй параметр – константа, то длина строки равна:

    <Строка> + (<Строка> / <ПодстрокаПоиска> с округлением в большую сторону) * (<ПодстрокаЗамены> - <ПодстрокаПоиска>), но не меньше чем длина <Строка>.

    Если второй параметр не константа, то длина строки равна длине <Строка> * <ПодстрокаЗамены>.

    Если полученная длина больше 1024, то получается строка неограниченной длины.

    НСтр (NStr)

    Получает строку на языке текущего пользователя или указанном языке из набора строк на разных языках конфигурации.

    Синтаксис:

    НСтр(<Строка>, <КодЯзыка>)

    Параметры:

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

  • КодЯзыка - тип Строка. Код языка, на котором нужно получить строку. Если значение не указано, то строка будет выдаваться на языке, определенного для текущего пользователя.

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

•

Тип Строка. Строка, соответствующая указанному языку или языку текущего пользователя.

см. также:
                       Язык выражений системы компоновки данных [v8help://dcsui/SKD_Lang]
                       Двуязычное представление ключевых слов системы компоновки данных [v8help://dcsui/PresentSKD]