Строки (ЮТСтроки)
Методы модуля
ДобавитьСтроку
Объединяет две строки с помощью указанного разделителя.
Ограничения:
- Метод не изменяет исходную и дополнительную строки, а создает новую строку на их основе.
Параметры метода
ИсходнаяСтрока
Строка
- Строка, к которой будет добавлена дополнительная строка.
ДополнительнаяСтрока
Строка
- Строка, которую нужно добавить к исходной строке.
Разделитель
Строка
- Символ или набор символов, используемых для разделения исходной и дополнительной строк. По умолчанию используется точка с запятой (";").
Возвращает
Строка
- Новая строка, образованная объединением исходной и дополнительной строк с помощью указанного разделителя.
Если дополнительная строка пустая, то возвращается исходная строка.
Если исходная строка пустая, а дополнительная нет, то возвращается дополнительная строка.
Примеры:
ИсходнаяСтрока = "Привет";
ДополнительнаяСтрока = "Мир";
Разделитель = " ";
Результат = ДобавитьСтроку(ИсходнаяСтрока, ДополнительнаяСтрока, Разделитель); // Результат будет равен "Привет Мир".
РазделитьСтроку
Разделяет строку на подстроки с помощью указанного разделителя.
Ограничения:
- Метод не изменяет исходную строку, а создает новый массив строк на ее основе.
- В отличие от СтрРазделить, в качестве разделителя используется вся переданная строка, а не любой из символов, входящих в нее.
- Отсекает незначащие символы, стоящие слева от первого значащего символа в строке, и пробелы, стоящие справа от последнего значащего символа в строке.
Параметры метода
Значение
Строка
- Строка, которую нужно разделить на подстроки.
Разделитель
Строка
- Символ или набор символов, используемых для разделения строки на подстроки. По умолчанию используется точка с запятой (";").
Возвращает
Массив из Строка
- Массив строк, содержащий подстроки, полученные в результате разделения исходной строки.
Если исходная строка пустая, то возвращается пустой массив.
Примеры:
Значение = "Привет; Мир; Как дела?";
Разделитель = "; ";
Результат = РазделитьСтроку(Значение, Разделитель); // Результат будет равен ["Привет", "Мир", "Как дела?"].
СтрокаСимволов
Создает строку, состоящую из указанного количества одинаковых символов.
Параметры метода
Символ
Строка
- Символ, из которого будет создана строка.
Количество
Число
- Количество символов в создаваемой строке.
Возвращает
Строка
- Новая строка, состоящая из указанного количества одинаковых символов.
Примеры:
Символ = "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"
СоответствуетШаблону
Проверяет что строк соответствует "простому" шаблону - тексту со звездочками.
Параметры метода
Строка
Строка
- Проверямая строка
Шаблон
Строка
- Шаблон
Возвращает
Булево
- Соответствует шаблону
Примеры:
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "Тест*"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "*Строка"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "Тест*ка"); // Результат будет Истина
Результат = ЮТСтроки.СоответствуетШаблону("ТестСтрока", "НеТест*"); // Результат будет Ложь