Перейти к основному содержимому

Строки (ЮТСтроки)

Методы модуля


ДобавитьСтроку

Объединяет две строки с помощью указанного разделителя.

Ограничения:

  • Метод не изменяет исходную и дополнительную строки, а создает новую строку на их основе.

Параметры метода

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

Возвращает

Строка - Новая строка, образованная объединением исходной и дополнительной строк с помощью указанного разделителя. Если дополнительная строка пустая, то возвращается исходная строка. Если исходная строка пустая, а дополнительная нет, то возвращается дополнительная строка.

Примеры:

ИсходнаяСтрока = "Привет";
ДополнительнаяСтрока = "Мир";
Разделитель = " ";
Результат = ДобавитьСтроку(ИсходнаяСтрока, ДополнительнаяСтрока, Разделитель); // Результат будет равен "Привет Мир".

РазделитьСтроку

Разделяет строку на подстроки с помощью указанного разделителя.

Ограничения:

  • Метод не изменяет исходную строку, а создает новый массив строк на ее основе.
  • В отличие от СтрРазделить, в качестве разделителя используется вся переданная строка, а не любой из символов, входящих в нее.
  • Отсекает незначащие символы, стоящие слева от первого значащего символа в строке, и пробелы, стоящие справа от последнего значащего символа в строке.

Параметры метода

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

Возвращает

Массив из Строка - Массив строк, содержащий подстроки, полученные в результате разделения исходной строки. Если исходная строка пустая, то возвращается пустой массив.

Примеры:

Значение = "Привет; Мир; Как дела?";
Разделитель = "; ";
Результат = РазделитьСтроку(Значение, Разделитель); // Результат будет равен ["Привет", "Мир", "Как дела?"].

СтрокаСимволов

Создает строку, состоящую из указанного количества одинаковых символов.

Параметры метода

  • Символ
    • Строка - Символ, из которого будет создана строка.
  • Количество
    • Число - Количество символов в создаваемой строке.

Возвращает

Строка - Новая строка, состоящая из указанного количества одинаковых символов.

Примеры:

Символ = "a";
Количество = 5;
Результат = СтрокаСимволов(Символ, Количество); // Результат будет равен "aaaaa".

РусскиеБуквы

Возвращает строку, содержащую все русские буквы в указанном регистре.

Параметры метода

  • НижнийРегистр
    • Булево - Если значение равно Истина, то в создаваемой строке будут использованы буквы в нижнем регистре. По умолчанию равно Истина.
  • ВерхнийРегистр
    • Булево - Если значение равно Истина, то в создаваемой строке будут использованы буквы в верхнем регистре. По умолчанию равно Ложь.

Возвращает

Строка - Новая строка, содержащая все русские буквы в указанном регистре. Если оба параметра НижнийРегистр и ВерхнийРегистр равны ``Истина`, то в создаваемой строке будут использованы буквы в обоих регистрах.

Примеры:

Результат = РусскиеБуквы(Истина, Ложь); // Результат будет равен "абвгдеёжзийклмнопрстуфхцчшщъыьэюя".
Результат = РусскиеБуквы(Ложь, Истина); // Результат будет равен "АБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ".
Результат = РусскиеБуквы(Истина, Истина); // Результат будет равен "абвгдеёжзийклмнопрстуфхцчшщъыьэюяАБВГДЕЁЖЗИЙКЛМНОПРСТУФХЦЧШЩЪЫЬЭЮЯ".

АнглийскиеБуквы

Возвращает строку, содержащую все английские буквы в указанном регистре.

Параметры метода

  • НижнийРегистр
    • Булево - Если значение равно Истина, то в создаваемой строке будут использованы буквы в нижнем регистре. По умолчанию равно Истина.
  • ВерхнийРегистр
    • Булево - Если значение равно Истина, то в создаваемой строке будут использованы буквы в верхнем регистре. По умолчанию равно Ложь.

Возвращает

Строка - Новая строка, содержащая все английские буквы в указанном регистре. Если оба параметра НижнийРегистр и ВерхнийРегистр равны Истина, то в создаваемой строке будут использованы буквы в обоих регистрах.

Примеры:

Результат = АнглийскиеБуквы(Истина, Ложь); // Результат будет равен "abcdefghijklmnopqrstuvwxyz".
Результат = АнглийскиеБуквы(Ложь, Истина); // Результат будет равен "ABCDEFGHIJKLMNOPQRSTUVWXYZ".
Результат = АнглийскиеБуквы(Истина, Истина); // Результат будет равен "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ".

Цифры

Возвращает строку, содержащую все цифры.

Возвращает

Строка - Новая строка, содержащая все цифры "1234567890".

Примеры:

Результат = Цифры(); // Результат будет равен "1234567890".

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

Сравнивает две версии программного обеспечения.

Ограничения:

  • Версии должны быть представлены в формате "X.X.X.X", где X - целое число.

Параметры метода

  • Версия1
    • Строка - Первая версия для сравнения.
  • Версия2
    • Строка - Вторая версия для сравнения.

Возвращает

Число - Результат сравнения версий. 1 - если Версия1 больше Версия2. 0 - если Версия1 равна Версия2; -1 - если Версия1 меньше Версия2;

Примеры:

Результат = СравнитьВерсии("1.0.0", "1.1.0"); // Результат будет равен -1.
Результат = СравнитьВерсии("1.1.0", "1.0.0"); // Результат будет равен 1.
Результат = СравнитьВерсии("1.0.0", "1.0.0"); // Результат будет равен 0.
Результат = СравнитьВерсии("1.2.3.4", "1.2.3"); // Результат будет равен 1.
Результат = СравнитьВерсии("1.2.3", "1.2.3.4"); // Результат будет равен -1.

ВерсияБольше

Выполняет сравнение версий

Ограничения:

  • Версии должны быть представлены в формате "X.X.X.X", где X - целое число.

Параметры метода

  • ПроверяемаяВерсия
    • Строка - Проверяемая версия
  • БазоваяВерсия
    • Строка - Базовая версия, с которой происходит сравнение

Возвращает

Булево - Проверяемая версия больше базовой

Примеры:

Результат = ВерсияБольше("1.1.0", "1.0.0"); // Результат будет равен Истина
Результат = ВерсияБольше("1.0.0", "1.1.0"); // Результат будет равен Ложь
Результат = ВерсияБольше("1.0.0", "1.0.0"); // Результат будет равен Ложь

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

Проверяет, что переданное значение является строковым представлением уникального идентификатора

Ограничения:

  • Проверяется только формат строки, но не её содержимое
  • Строка должна быть в формате "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", где X - шестнадцатеричная цифра

Параметры метода

  • Значение
    • Строка - Проверяемая строка

Возвращает

Булево - Истина, если строка соответствует формату UUID

Примеры:

Результат = ЭтоУникальныйИдентификаторСтрокой("123e4567-e89b-12d3-a456-426614174000"); // Результат будет равен Истина
Результат = ЭтоУникальныйИдентификаторСтрокой("123e4567-e89b-12d3-a456"); // Результат будет равен Ложь
Результат = ЭтоУникальныйИдентификаторСтрокой(""); // Результат будет равен Ложь

УникальныеСтроки

Из набора строк формирует набор уникальных строк. Сравнение происходит без учета регистра.

Параметры метода

  • НеУникальныеСтроки
    • Массив Из Строка -

Возвращает

Массив Из Строка - Уникальные строки

Примеры:

НеУникальныеСтроки = Новый Массив;
НеУникальныеСтроки.Добавить("Строка1");
НеУникальныеСтроки.Добавить("Строка2");
НеУникальныеСтроки.Добавить("Строка1");
Результат = ЮТСтроки.УникальныеСтроки(НеУникальныеСтроки); // Результат будет равен ["Строка1", "Строка2"]

ЭтоВалидноеИмяПеременной

Проверяет переданную строку, является ли она подходщим именем переменной - должна соответствовать требованиям к именам переменных

Параметры метода

  • ИмяПеременной
    • Строка -

Возвращает

Булево - Это валидное имя переменной

Примеры:

Результат = ЮТСтроки.ЭтоВалидноеИмяПеременной("МояПеременная1"); // Результат будет равен Истина
Результат = ЮТСтроки.ЭтоВалидноеИмяПеременной("1МояПеременная"); // Результат будет равен Ложь
Результат = ЮТСтроки.ЭтоВалидноеИмяПеременной("Моя Переменная"); // Результат будет равен Ложь

ЛокализованноеСообщениеПлатформы

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

Параметры метода

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

Возвращает

Строка - Локализованное сообщение платформы

Примеры:

СтрокаНаРазныхЯзыках = "ru = ""Привет""" + ";" + "en = ""Hello""" ;
ЮТОкружение.УстановитьЛокальПлатформы("ru");
Результат = ЮТСтроки.ЛокализованноеСообщениеПлатформы(СтрокаНаРазныхЯзыках); // Результат будет "Привет"
ЮТОкружение.УстановитьЛокальПлатформы("en");
Результат = ЮТСтроки.ЛокализованноеСообщениеПлатформы(СтрокаНаРазныхЯзыках); // Результат будет "Hello"

СоответствуетШаблону

Проверяет что строк соответствует "простому" шаблону - тексту со звездочками.

Параметры метода

  • Строка
    • Строка - Проверямая строка
  • Шаблон
    • Строка - Шаблон

Возвращает

Булево - Соответствует шаблону

Примеры:

Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "Тест*"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "*Строка"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "Тест*ка"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "НеТест*"); // Результат будет Ложь