Строковые функции клиент сервер УХ

ДобавитьУдалитьПрефиксТекста

Описание, пример вызова

// Добавляет или удаляет префикс в начале строки текста.
// При добавлении учитывается, что такой префикс уже может быть, и он не добавляется.
// Параметры:
//  Текст - Строка - текст для изменения.
//  Префикс - Строка - текст для добавления или удаления.
//  Добавить - Булево
//    - Истина - добавить текст в начало заголовка (если его нет).
//    - Ложь - удалить (если есть) текст из начала заголовка формы.
//
Функция ДобавитьУдалитьПрефиксТекста(Текст, Префикс, Добавить) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ДобавитьУдалитьПрефиксТекста(Текст, Префикс, Добавить)

ЭтоКорректноеИмяПеременной

Описание, пример вызова

// Функция проверяет, является ли переданная строка корректным именем переменной 1С.
// Параметры:
// СтрокаПроверки (Строка) - Проверяемая строка
// Возвращаемое значение:
// Булево. Истина - переданная строка является идентификатором.
Функция ЭтоКорректноеИмяПеременной(СтрокаПроверки) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ЭтоКорректноеИмяПеременной(СтрокаПроверки)

ТолькоБуквыВСтроке

Описание, пример вызова

Функция ТолькоБуквыВСтроке(Знач СтрокаПроверки, Знач УчитыватьРазделителиСлов = Истина, ДопустимыеСимволы = "") Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ТолькоБуквыВСтроке(СтрокаПроверки, УчитыватьРазделителиСлов, ДопустимыеСимволы);

РазложитьСтрокуВМассивПодстрок

Описание, пример вызова

// Функция "расщепляет" строку на подстроки, используя заданный
//      разделитель. Разделитель может иметь любую длину.
//      Если в качестве разделителя задан пробел, рядом стоящие пробелы
//      считаются одним разделителем, а ведущие и хвостовые пробелы параметра Стр
//      игнорируются.
//      Например,
//      РазложитьСтрокуВМассивПодстрок(",один,,,два", ",") возвратит массив значений из пяти элементов,
//      три из которых - пустые строки, а
//      РазложитьСтрокуВМассивПодстрок(" один   два", " ") возвратит массив значений из двух элементов
//
//  Параметры:
//      Стр -           строка, которую необходимо разложить на подстроки.
//                      Параметр передается по значению.
//      Разделитель -   строка-разделитель, по умолчанию - запятая.
//
//  Возвращаемое значение:
//      массив значений, элементы которого - подстроки
//
Функция РазложитьСтрокуВМассивПодстрок(Знач Стр, Разделитель = ",") Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.РазложитьСтрокуВМассивПодстрок(Стр, Разделитель, ")

ПолучитьСтрокуИзМассиваПодстрок

Описание, пример вызова

// Устарела. Следует использовать СтрСоединить.
// Возвращает строку, полученную из массива элементов, разделенных символом разделителя
//
// Параметры:
//  Массив - Массив - массив элементов из которых необходимо получить строку
//  Разделитель - Строка - любой набор символов, который будет использован как разделитель между элементами в строке
//
// Возвращаемое значение:
//  Результат - Строка - строка, полученная из массива элементов, разделенных символом разделителя
//
Функция ПолучитьСтрокуИзМассиваПодстрок(Массив, Разделитель = ",") Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ПолучитьСтрокуИзМассиваПодстрок(Массив, Разделитель, ")

СравнитьВерсии

Описание, пример вызова

// Сравнить две строки версий.
//
// Параметры
//  СтрокаВерсии1  – Строка – номер версии в формате РР.{П|ПП}.ЗЗ.СС
//  СтрокаВерсии2  – Строка – второй сравниваемый номер версии
//
// Возвращаемое значение:
//   Число   – больше 0, если СтрокаВерсии1 > СтрокаВерсии2; 0, если версии равны.
//
Функция СравнитьВерсии(Знач СтрокаВерсии1, Знач СтрокаВерсии2) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.СравнитьВерсии(СтрокаВерсии1, СтрокаВерсии2)

ПодставитьПараметрыВСтроку

Описание, пример вызова

// Подставляет параметры в строку. Максимально возможное число параметров - 9.
// Параметры в строке задаются как %<номер параметра>. Нумерация параметров
// начинается с единицы.
//
// Параметры
//  СтрокаПодстановки  – Строка – шаблон строки с параметрами (вхождениями вида "%ИмяПараметра").
// Параметр<n>         - Строка - параметр
// Возвращаемое значение:
//   Строка   – текстовая строка с подставленными параметрами
//
// Пример:
// Строка = ПодставитьПараметрыВСтроку(НСтр("ru='%1 пошел в %2'"), "Вася", "Зоопарк");
//
Функция ПодставитьПараметрыВСтроку( Знач СтрокаПодстановки, Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ПодставитьПараметрыВСтроку(СтрокаПодстановки, );

ПодставитьПараметрыВСтрокуИзМассива

Описание, пример вызова

// Подставляет параметры в строку. Неограниченное число параметров в строке.
// Параметры в строке задаются как %<номер параметра>. Нумерация параметров
// начинается с единицы.
//
// Параметры
//  СтрокаПодстановки  – Строка – шаблон строки с параметрами (вхождениями вида "%1").
//  МассивПараметров   - Массив - массив строк, которые соответствуют параметрам в строке подстановки
//
// Возвращаемое значение:
//   Строка   – текстовая строка с подставленными параметрами
//
// Пример:
// МассивПараметров = Новый Массив;
// МассивПараметров = МассивПараметров.Добавить("Вася");
// МассивПараметров = МассивПараметров.Добавить("Зоопарк");
//
// Строка = ПодставитьПараметрыВСтроку(НСтр("ru='%1 пошел в %2'"), МассивПараметров);
//
Функция ПодставитьПараметрыВСтрокуИзМассива(Знач СтрокаПодстановки, знач МассивПараметров) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ПодставитьПараметрыВСтрокуИзМассива(СтрокаПодстановки, знач МассивПараметров)

ТолькоЦифрыВСтроке

Описание, пример вызова

// Проверяет содержит ли строка только цифры.
//
// Параметры:
//  СтрокаПроверки - строка для проверки.
//  УчитыватьЛидирующиеНули - Булево - нужно ли учитывать лидирующие нули.
//  УчитыватьПробелы - Булево - нужно ли учитывать пробелы.
//
// Возвращаемое значение:
//  Истина       - строка содержит только цифры;
//  Ложь         - строка содержит не только цифры.
//
Функция ТолькоЦифрыВСтроке(Знач СтрокаПроверки, Знач УчитыватьЛидирующиеНули = Истина, Знач УчитыватьПробелы = Истина) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ТолькоЦифрыВСтроке(СтрокаПроверки, УчитыватьЛидирующиеНули, УчитыватьПробелы);

СократитьДвойныеКавычки

Описание, пример вызова

// Удаляет двойные кавычки с начала и конца строки, если они есть.
//
// Параметры:
//  Строка       - входная строка;
//
// Возвращаемое значение:
//  Строка - строка без двойных кавычек.
//
Функция СократитьДвойныеКавычки(Знач Строка) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.СократитьДвойныеКавычки(Строка)

УдалитьПоследнийСимволВСтроке

Описание, пример вызова

// Процедура удаляет из строки указанное количество символов справа
//
Процедура УдалитьПоследнийСимволВСтроке(Текст, ЧислоСимволов) Экспорт

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

СтроковыеФункцииКлиентСерверУХ.УдалитьПоследнийСимволВСтроке(Текст, ЧислоСимволов)

НайтиСимволСКонца

Описание, пример вызова

// Устарела. Следует использовать СтрНайти.
// Находит символ в строке с конца
//
Функция НайтиСимволСКонца(Знач СтрокаВся, Знач ОдинСимвол) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.НайтиСимволСКонца(СтрокаВся, ОдинСимвол)

ЭтоУникальныйИдентификатор

Описание, пример вызова

// Функция проверяет, является ли переданная в неё строка уникальным идентификатором
//
Функция ЭтоУникальныйИдентификатор(ИдентификаторСтрока) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ЭтоУникальныйИдентификатор(ИдентификаторСтрока)

СформироватьСтрокуСимволов

Описание, пример вызова

// Формирует строку повторяющихся символов заданной длины
//
Функция СформироватьСтрокуСимволов(Символ, КоличествоСимволов) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.СформироватьСтрокуСимволов(Символ, КоличествоСимволов)

ДополнитьСтроку

Описание, пример вызова

// Дополняет переданную в качестве первого параметра строку символами слева\справа до заданной длины и возвращает ее
// Незначащие символы слева и справа удаляются
// По умолчанию функция добавляет строку нулями слева
//
// Параметры:
//  Строка      - Строка - исходная строка, которую необходимо дополнить символами до заданной длины
//  ДлинаСтроки - Число - требуемая конечная длина строки
//  Символ      - Строка - (необязательный) значение символа, которым необходимо дополнить строку
//  Режим       - Строка - (необязательный) [Слева|Справа] режим добавления символов к исходной строке: слева или справа
//
// Пример 1:
// Строка = "1234"; ДлинаСтроки = 10; Символ = "0"; Режим = "Слева"
// Возврат: "0000001234"
//
// Пример 2:
// Строка = " 1234  "; ДлинаСтроки = 10; Символ = "#"; Режим = "Справа"
// Возврат: "1234######"
//
// Возвращаемое значение:
//  Строка - строка, дополненная символами слева или справа
//
Функция ДополнитьСтроку(Знач Строка, Знач ДлинаСтроки, Знач Символ = "0", Знач Режим = "Слева") Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ДополнитьСтроку(Строка, ДлинаСтроки, Символ, Режим);

УдалитьПовторяющиесяСимволы

Описание, пример вызова

// Удаляет повторяющиеся символы слева/справа в переданной строке
//
// Параметры:
//  Строка      - Строка - исходная строка, из которой необходимо удалить повторяющиеся символы
//  Символ      - Строка - значение символа, который необходимо удалить
//  Режим       - Строка - (необязательный) [Слева|Справа] режим добавления символов к исходной строке: слева или справа
//
Функция УдалитьПовторяющиесяСимволы(Знач Строка, Знач Символ, Знач Режим = "Слева") Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.УдалитьПовторяющиесяСимволы(Строка, Символ, Режим);

ВерсияКонфигурацииБезНомераСборки

Описание, пример вызова

// Получает номер версии конфигурации без номера сборки
//
// Параметры:
//  Версия - Строка - версия конфигурации в формате РР.ПП.ЗЗ.СС,
//                    где СС – номер сборки, который будет удален
//
//  Возвращаемое значение:
//  Строка - номер версии конфигурации без номера сборки в формате РР.ПП.ЗЗ
//
Функция ВерсияКонфигурацииБезНомераСборки(Знач Версия) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ВерсияКонфигурацииБезНомераСборки(Версия)

СтрокаВЧисло

Описание, пример вызова

// Преобразует исходную строку в число.
//   Превращает строку в число без вызова исключений. Стандартная функция преобразования.
//   Число() строго контролирует отсутствие каких-либо символов кроме числовых.
//
// Параметры:
//   ИсходнаяСтрока - Строка - Строка, которую необходимо привести к числу.
//
// Возвращаемое значение:
//   Число - Полученное число.
//   Неопределено - Если строка не является числом.
//
Функция СтрокаВЧисло(Знач ИсходнаяСтрока) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.СтрокаВЧисло(ИсходнаяСтрока)

ФорматированнаяСтрока

Описание, пример вызова

// Форматирует строку в соответствии с заданным шаблоном.
// Возможные значения тегов выделения:
//  <b> Строка </b> - выделяет строку жирным шрифтом.
//  <a href = "Ссылка"> Строка </a>
//
// Пример:
//  Минимальная версия программы <b>1.1</b>. <a href = "Обновление">Обновите</a> программу.
//
// Возвращаемое значение:
//  ФорматированнаяСтрока
Функция ФорматированнаяСтрока(Знач Строка) Экспорт

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

Результат = СтроковыеФункцииКлиентСерверУХ.ФорматированнаяСтрока(Строка)