ДлинаСтроки
Подстрока
СокрЛ
СокрП
СокрЛП
Лев
Прав
СтрНайти
ВРег
НРег
СтрЗаменить
НСтр

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

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

Синтаксис:

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

Параметр:

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

Пример:

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

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

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

Синтаксис:

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

Параметры:

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

Пример:

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

СокрЛ (TrimL)

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

Синтаксис:

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

Параметры:

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

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

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

СокрП (TrimR)

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

Синтаксис:

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

Параметры:

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

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

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

СокрЛП (TrimAll)

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

Синтаксис:

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

Параметры:

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

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

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

Лев (Left)

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

Синтаксис:

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

Параметры:

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

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

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

Прав (Right)

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

Синтаксис:

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

Параметры:

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

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

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

СтрНайти (StrFind)

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

Синтаксис:

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

Параметры:

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

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

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

ВРег (Upper)

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

Синтаксис:

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

Параметры:

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

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

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

НРег (Lower)

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

Синтаксис:

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

Параметры:

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

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

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

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

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

Синтаксис:

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

Параметры:

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

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

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

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

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

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

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

НСтр (NStr)

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

Синтаксис:

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

Параметры:

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

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

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

см. также:
                       Язык выражений системы компоновки данных
Двуязычное представление ключевых слов системы компоновки данных