1с статьи | Курс-репетитор программиста 1С

Символы строки

Алфавит = "Слово по буквам";

// считаем символы строки в массив
МассивСимволов = Новый Массив;

// нумерация символов в строке начинается с 1   
Для Индекс = 1 По СтрДлина(Алфавит) Цикл
   
   // получаем символ строки по индексу
   Символ = Сред(Алфавит, Индекс, 1);
   МассивСимволов.Добавить(Символ);
   
КонецЦикла;

// соединяем элементы массива
ТекстСообщения = СтрСоединить(МассивСимволов);
Сообщить(ТекстСообщения);   

// Что будет выведено?

Показать решение

Слова строки

Алфавит = "Слово по буквам, по цифрам";

// очистим строку от знаков препинания
СимволыДляУдаления = "; : . , / \";
МассивСимволыДляУдаления = СтрРазделить(СимволыДляУдаления, " ");

Для Каждого Элемент Из МассивСимволыДляУдаления Цикл
   Алфавит = СтрЗаменить(Алфавит, Элемент, "");      
КонецЦикла;

// считаем слова строки в массив
МассивСлов = СтрРазделить(Алфавит, " ");

// каждое слово будем начинать с большой буквы
Для Индекс = 0 По МассивСлов.ВГраница() Цикл
   ФорматированноеСлово = ТРег(МассивСлов[Индекс]);
   МассивСлов.Установить(Индекс, ФорматированноеСлово);
КонецЦикла;

// соединяем элементы массива
ТекстСообщения = СтрСоединить(МассивСлов, Символы.ПС);
Сообщить(ТекстСообщения);   

// Что будет выведено?

Показать решение

Строка как текст запроса

Запрос = Новый Запрос; // создали запрос

// подготовили шаблон текста запроса
ТекстЗапроса = "
|Выбрать Т.Ссылка 
|ИЗ ВТ КАК Т
|ГДЕ <ТекстУсловий>";

// каждое условие - структура
КлючСтруктурыУсловия = "ИмяПоля, Значение, ЭтоРавенство";
// массив всех условий
МассивУсловий = Новый Массив;
МассивУсловий.Добавить(Новый Структура(КлючСтруктурыУсловия, 
   "Поле1", 1, Истина));  // по полю 1 на равенство
МассивУсловий.Добавить(Новый Структура(КлючСтруктурыУсловия, 
   "Поле2", Истина, Ложь)); // по полю 2 на неравенство

ТекстУсловий = "Истина"; // начальный сегмент
Для Индекс = 0 По МассивУсловий.ВГраница() Цикл
   Условие = МассивУсловий[Индекс]; // получили условие
   ТекстУсловий = ТекстУсловий + " И Т." + Условие.ИмяПоля   +
       // если равенство, добавляем " = ", иначе " <> "
      ?(Условие.ЭтоРавенство," = ", " <> ") + 
      "&ЗначениеПараметра" + Индекс; // нумерация по индексу
      
   // устанавливаем параметр запроса   
   Запрос.УстановитьПараметр("ЗначениеПараметра" + Индекс,
      Условие.Значение);
      
КонецЦикла; 

// формируем текст запроса
ТекстЗапроса = СтрЗаменить(ТекстЗапроса, 
   "<ТекстУсловий>", ТекстУсловий); 

Запрос.Текст = ТекстЗапроса;

Сообщить(ТекстЗапроса);

Показать вывод

Нумерация тегов в строке

ИсходнаяСтрока = 
"<span class='c'>// 1
|<span class='c'>// 2
|<span class='c'>// 3
|Сообщить<span class='k'>(
|<span class='n'>5
|<span class='k'>)
|<span class='k'>;";

// добавим каждому элементу span атрибут id 
// с уникальным значеним

Счетчик = 1; // счетчик атрибута id
ПозицияПоиска = 1; // начальная позиция поиска
ПозицияПоиска = СтрНайти(ИсходнаяСтрока, // ищем в исходной строке
   "<span", // такой текст
   НаправлениеПоиска.СНачала, // по направлению с начала
   ПозицияПоиска // начиная с этой позиции
);                                         
// 0 - если ничего не нашли
Пока ПозицияПоиска<>0 Цикл
   
   // получим строку до найденной позиции               
   // для второй итерации: 
   //<span id='span1' class='c'>// 1¶
   НачалоСтроки = Лев(ИсходнаяСтрока, ПозицияПоиска-1); 
   // сформируем текст для вставки 
   // для второй итерации: 
   //<span id='span2' 
   ТекстВставки = "<span id='span" + Счетчик + "' ";   
   // получим часть исходной строки после найденного '<span'
   // для второй итерации: 
   //class='c'>// 2 и далее до конца строки
   ЗавершениеСтроки = Прав(ИсходнаяСтрока, 
      СтрДлина(ИсходнаяСтрока) - ПозицияПоиска - СтрДлина("<span"));
      
   // переформируем исходную строку   
   ИсходнаяСтрока = НачалоСтроки + ТекстВставки + ЗавершениеСтроки; 
   Счетчик = Счетчик + 1; // увеличим счетчик id
   // передвинем начальную позицию поиска
   ПозицияПоиска = ПозицияПоиска + СтрДлина(ТекстВставки); 
   // найдем следующий '<span'
   ПозицияПоиска = СтрНайти(ИсходнаяСтрока, "<span", 
	НаправлениеПоиска.СНачала, ПозицияПоиска); 
   
КонецЦикла;

Сообщить(ИсходнаяСтрока);

Показать вывод

Строка (String)

Значения данного типа содержат строку в формате Unicode произвольной длины.

Литералы строкового типа представляют собой набор символов заключенных в кавычки. Для задания в строке символа " (кавычка) необходимо записать две кавычки подряд. Кроме того, допускаются "многострочные" строковые константы. В исходном тексте многострочные константы могут задаваться двумя способами:

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

Каждая отдельная составляющая не замыкается кавычками, а на каждой последующей строке помещен символ переноса строки | (вертикальная черта). В этом варианте комментарии допускаются, если строка начинается с символа комментария //.

ВРег (Upper)

Синтаксис: ВРег(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

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

Описание: Преобразует все символы строки в верхний регистр.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

КодСимвола (CharCode)

Синтаксис: КодСимвола(<Строка>, <НомерСимвола>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<НомерСимвола> (необязательный) Тип: Число. Номер символа в строке, код которого необходимо получить. Нумерация символов в строке начинается с 1. Значение по умолчанию: 1.

Возвращаемое значение: Тип: Число. Код переданного символа. Код возвращается в соответствии с кодировкой Unicode.

Описание: Получает код символа, расположенного в переданной строке в позиции с указанным номером.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Лев (Left)

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

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<ЧислоСимволов> (обязательный) Тип: Число. Количество выбираемых символов.

Возвращаемое значение: Тип: Строка. Строка выбранных символов.

Описание: Выбирает первые слева символы строки.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

НРег (Lower)

Синтаксис: НРег(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

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

Описание: Преобразует все символы строки в нижний регистр.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

ПолучитьСклоненияСтроки (GetStringDeclensions)

Синтаксис: ПолучитьСклоненияСтроки(<СклоняемаяСтрока>, <ОписаниеСтроки>, <ФорматнаяСтрока>)

Параметры:

<СклоняемаяСтрока> (обязательный) Тип: Строка. Содержит строку, которую нужно просклонять.

<ОписаниеСтроки> (необязательный) Тип: Строка. Содержит информацию о строке, которую требуется просклонять.

Каждый параметр задается именем параметра, символом "=" (равно) и значением параметра. Параметры перечисляются через символ ";" (точка с запятой).

Допустимы следующие параметры:

Л (L) - Код локализации. По умолчанию используется код локализации информационной базы. Примеры кодов локализации: ru_RU - Русский (Россия); en_US - Английский (США). В настоящий момент поддерживается только русский язык. Если код локализации не указан, то используется текущая локализация информационной базы.

ПЛ (GN) - Пол. Параметр используется при склонении имен собственных. Если пол не указан, то платформа пытается распознать его на основании переданного словосочетания. Возможные варианты:

Мужской (Masculine),

Женский (Feminine).

Значение по умолчанию: Пустая строка.

<ФорматнаяСтрока> (необязательный) Тип: Строка. Содержит параметры форматирования.

Каждый параметр задается именем параметра, символом "=" (равно) и значением параметра. Параметры перечисляются через символ ";" (точка с запятой).

Допустимы следующие параметры:

ПД (CS) – Падеж. Если падеж не указан, то склонение не выполняется (выдается исходная строка). Поддерживаются следующие падежи:

Именительный (Nominative),

Родительный (Genitive),

Дательный (Dative),

Винительный (Accusative),

Творительный (Instrumental),

Предложный (Prepositional).

Значение по умолчанию: Пустая строка.

Возвращаемое значение: Тип: Массив. Массив, содержащий возможные варианты склонения строки. Если требуется только один вариант, можно использовать первый. Также в конфигурации может быть предусмотрен выбор пользователем варианта склонения из нескольких вариантов.

Описание: Склоняет указанную строку.

Доступность: Сервер, толстый клиент, внешнее соединение.

ПолучитьСклоненияСтрокиПоЧислу (GetStringDeclensionsByNumber)

Синтаксис: ПолучитьСклоненияСтрокиПоЧислу(<СклоняемаяСтрока>, <Число>, <СклоняемыеЕдиницыИзмерения>, <ОписаниеСтроки>, <ФорматнаяСтрока>, <ФорматнаяСтрокаЧисла>)

Параметры:

<СклоняемаяСтрока> (обязательный) Тип: Строка. Содержит строку, которую требуется согласовать и просклонять.

<Число> (обязательный) Тип: Число. Содержит число, относительно которого будет выполнено согласование и склонение строки.

<СклоняемыеЕдиницыИзмерения> (необязательный) Тип: Строка. Содержит строку с единицей измерения, которую необходимо согласовать и просклонять. Также поддерживается передача нескольких единиц измерения в следующем виде (перечисляются через запятую):

Единица измерения для целой части (Например, "килограмм").

Единица измерения для дробной части (Например, "грамм").

Количество разрядов дробной части (Может отсутствовать, по умолчанию - 2).

В результате, общая строка параметра будет выглядеть так: "килограмм, грамм, 2".

<ОписаниеСтроки> (необязательный) Тип: Строка. Содержит информацию о строке, которую нужно обработать.

Каждый параметр задается именем параметра, символом "=" (равно) и значением параметра. Параметры перечисляются через символ ";" (точка с запятой).

Допустимые параметры:

Л (L) - Код локализации. По умолчанию используется код локализации информационной базы. Примеры кодов локализации: ru_RU - Русский (Россия), en_US - Английский (США). В настоящий момент поддерживается только русский язык. Если код локализации не указан, то используется текущая локализация информационной базы.

ЧС (NM) – тип числительного. Возможные варианты:

Количественное (Cardinal) - Используется для целых и дробных значений.

Порядковое (Ordinal) - Используется только для целых значений.

Если тип числительного не указан, то в качестве параметра будет использовано количественное числительное. Если переданное число является дробью и указано, что оно является порядковым числительным, то будет сгенерировано исключение.

<ФорматнаяСтрока> (необязательный) Тип: Строка. Содержит параметры форматирования.

Каждый параметр задается именем параметра, символом "=" (равно) и значением параметра. Параметры перечисляются через символ ";" (точка с запятой).

Допустимы следующие параметры:

ПД (CS) – Падеж. Если не указан, то выполняется только согласование и возвращается форма именительного падежа. Возможные значения:

Именительный (Nominative),

Родительный (Genitive),

Дательный (Dative),

Винительный (Accusative),

Творительный (Instrumental),

Предложный (Prepositional).

ПЧ (NP) – представление числа. Если не указано, то используется "Авто". Возможные варианты:

Число (Number) - числительное будет записано цифрами.

ЧислоПрописью (NumberInWords) - числительное будет записано прописью (Например, "120" - "сто двадцать").

ЧислоСОкончанием (NumberWithEnding) - числительное будет записано с окончанием:

Для порядкового числительного (ЧС=Порядковое - если предпоследняя буква в окончании является согласной, то формируется двухбуквенное наращение окончания (Например, "двенадцатого автомобиля" - "12-го автомобиля").

Для порядкового числительного (ЧС=Порядковое) - если предпоследняя буква в окончании является гласной, то формируется однобуквенное наращение окончания (Например, "двенадцатый автомобиль" – "12-й автомобиль").

Для количественного числительного (ЧС=Количественное): генерируется исключение о невозможности использования параметров <ЧС=Количественное> и <ПЧ=ЧислоСОкончанием> вместе.

Авто (Auto) - для порядковых числительных используется "ЧислоСОкончанием", для количественных - "Число".

<ФорматнаяСтрокаЧисла> (необязательный) Тип: Строка. В качестве параметра передается строка, содержащая параметры форматирования для преобразования исходного числа в строку в указанном формате с помощью метода Формат.

Возвращаемое значение: Тип: Массив. Если указано только число, то возвращает представление этого числа в виде прописи в форме единственного числа мужского рода. Если указано только словосочетание без единицы измерения, метод заменит единицу измерения на словосочетание и выполнить склонение по соответствующим правилам.

Описание: Склоняет переданное сочетание числа и строки в указанном падеже.

Доступность: Сервер, толстый клиент, внешнее соединение, интеграция.

Прав (Right)

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

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<ЧислоСимволов> (обязательный) Тип: Число. Количество выбираемых символов.

Возвращаемое значение: Тип: Строка. Строка выбранных символов.

Описание: Выбирает последние справа символы строки.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

ПустаяСтрока (IsBlankString)

Синтаксис: ПустаяСтрока(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

Возвращаемое значение: Тип: Булево. Истина - строка не содержит значащих символов или не содержит ни одного символа (пустая); Ложь - в противном случае.

Описание: Проверяет строку на наличие значащих символов.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание: К незначащим символам относятся символы "пробел", "неразрывный пробел" (НПП), "табуляция" (горизонтальная Таб и вертикальная ВТаб), "возврат каретки" (ВК), "перевод строки" (ПС), "перевод формы (страницы)" (ПФ).

Символ (Char)

Синтаксис: Символ(<КодСимвола>)

Параметры:

<КодСимвола> (обязательный) Тип: Число. Код получаемого символа. Код задается в соответствии с кодировкой Unicode.

Возвращаемое значение: Тип: Строка. Результирующий символ.

Описание: Преобразует код символа в строку, содержащую символ.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СокрЛ (TrimL)

Синтаксис: СокрЛ(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

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

Описание: Отсекает незначащие символы, стоящие слева от первого значащего символа в строке.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание: К незначащим символам относятся символы "пробел", "неразрывный пробел" (НПП), "табуляция" (горизонтальная Таб и вертикальная ВТаб), "возврат каретки" (ВК), "перевод строки" (ПС), "перевод формы (страницы)" (ПФ).

СокрЛП (TrimAll)

Синтаксис: СокрЛП(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

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

Описание: Отсекает незначащие символы, стоящие слева от первого значащего символа в строке, и пробелы, стоящие справа от последнего значащего символа в строке.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание: К незначащим символам относятся символы "пробел", "неразрывный пробел" (НПП), "табуляция" (горизонтальная Таб и вертикальная ВТаб), "возврат каретки" (ВК), "перевод строки" (ПС), "перевод формы (страницы)" (ПФ).

СокрП (TrimR)

Синтаксис: СокрП(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

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

Описание: Отсекает незначащие символы, стоящие справа от последнего значащего символа в строке.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Примечание: К незначащим символам относятся символы "пробел", "неразрывный пробел" (НПП), "табуляция" (горизонтальная Таб и вертикальная ВТаб), "возврат каретки" (ВК), "перевод строки" (ПС), "перевод формы (страницы)" (ПФ).

Сред (Mid)

Синтаксис: Сред(<Строка>, <НачальныйНомер>, <ЧислоСимволов>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<НачальныйНомер> (обязательный) Тип: Число. Начальный номер символа, с которого начинается выборка. Нумерация символов в строке начинается с 1. Если указано значение, меньшее или равное нулю, то параметр принимает значение 1.

<ЧислоСимволов> (необязательный) Тип: Число. Количество выбираемых символов. Если параметр не указан, то выбираются символы до конца строки.

Возвращаемое значение: Тип: Строка. Строка выбранных символов.

Описание: Выбирает строку символов, начиная с символа <НачальныйНомер>, общим количеством <ЧислоСимволов>.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрДлина (StrLen)

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

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

Возвращаемое значение: Тип: Число. Длина строки.

Описание: Получает количество символов в строке.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрЗаканчиваетсяНа (StrEndsWith)

Синтаксис: СтрЗаканчиваетсяНа(<Строка>, <СтрокаПоиска>)

Параметры:

<Строка> (обязательный) Тип: Строка. Строка, окончание которой проверяется на совпадение с подстрокой поиска.

<СтрокаПоиска> (обязательный) Тип: Строка. Строка, содержащая предполагаемое окончание строки. В случае если переданное значение является пустой строкой генерируется исключительная ситуация.

Возвращаемое значение: Тип: Булево. Истина - строка заканчивается указанной подстрокой; Ложь - в противном случае

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

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

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

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

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<ПодстрокаПоиска> (обязательный) Тип: Строка. Искомая подстрока.

<ПодстрокаЗамены> (обязательный) Тип: Строка. Подстрока, на которую будет заменена подстрока поиска.

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

Описание: Находит в исходной строке все вхождения подстроки поиска и заменяет ее на подстроку замены.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрЗаменитьПоРегулярномуВыражению (StrReplaceByRegularExpression)

Синтаксис: СтрЗаменитьПоРегулярномуВыражению(<Строка>, <РегулярноеВыражение>, <ПодстрокаЗамены>, <ИгнорироватьРегистр>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<РегулярноеВыражение> (обязательный) Тип: Строка. Регулярное выражение.

<ПодстрокаЗамены> (обязательный) Тип: Строка. Строка, на которую выполняется замена. Может содержать ссылки на группы, описанные в параметре <РегулярноеВыражение>. Для ссылок на группы используется формат $0,$1...$n, где n - количество групп в регулярном выражении.

<ИгнорироватьРегистр> (необязательный) Тип: Булево. Истина - без учета регистра, Ложь - с учетом регистра. Значение по умолчанию: Ложь.

<МногострочныйПоиск> (необязательный) Тип: Булево. Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки. Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста. Значение по умолчанию: Ложь.

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

Описание: Находит в исходной строке все вхождения регулярного выражения и заменяет их на подстроку замены.

Доступность: Сервер, толстый клиент, внешнее соединение.

СтрНайти (StrFind)

Синтаксис: СтрНайти(<Строка>, <ПодстрокаПоиска>, <НаправлениеПоиска>, <НачальнаяПозиция>, <НомерВхождения>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<ПодстрокаПоиска> (обязательный) Тип: Строка. Искомая подстрока.

<НаправлениеПоиска> (необязательный) Тип: НаправлениеПоиска. Указывает направление поиска подстроки в строке. Значение по умолчанию: СНачала.

<НачальнаяПозиция> (необязательный) Тип: Число. Указывает позицию в строке, с которой начинается поиск.

Если параметр не задан и в параметре НаправлениеПоиска указано значение СНачала, то значение по умолчанию равно 1.

Если параметр не задан и в параметре НаправлениеПоиска указано значение СКонца, то значение по умолчанию равно длине строки.

Допускаются значения от 1 до количества символов в строке, в которой выполняется поиск. Если указано значение, не входящее в диапазон, генерируется ошибка "Неверное значение параметра".

<НомерВхождения> (необязательный) Тип: Число. Указывает номер вхождения искомой подстроки в исходной строке. Значение по умолчанию: 1.

Возвращаемое значение: Тип: Число. Позиция первого знака найденной подстроки. Нумерация символов в строке начинается с 1. Если строка не содержит указанной подстроки, то возвращается 0.

Описание: Находит первое вхождение искомой строки как подстроки в исходной строке. Сравнение выполняется с учетом регистра.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.

Примечание: Если параметр <ПодстрокаПоиска> пустая строка, то возвращает 1. Если оба параметра пустые строки, то возвращает 1.

СтрНайтиВсеПоРегулярномуВыражению (StrFindAllByRegularExpression)

Синтаксис: СтрНайтиВсеПоРегулярномуВыражению(<Строка>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<МногострочныйПоиск> (необязательный) Тип: Булево.

Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки.

Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста.

Значение по умолчанию: Ложь.

Возвращаемое значение: Тип: Массив. Массив элементов типа РезультатПоискаПоРегулярномуВыражению.

Описание: Находит все вхождения регулярного выражения в исходной строке.

Доступность: Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер).

СтрНайтиИВыделитьОформлением (StrFindAndHighlightByAppearance)

Синтаксис: СтрНайтиИВыделитьОформлением(<Строка>, <Подстрока>)

Параметры:

<Строка> (обязательный) Тип: Строка, ФорматированнаяСтрока. Исходная строка.

<Подстрока> (обязательный) Тип: Строка, Массив. Искомая строка или массив искомых строк.

Возвращаемое значение: Тип: ФорматированнаяСтрока, Неопределено. Если хотя бы одна искомая строка не найдена, возвращается Неопределено.

Описание: Выполняет поиск в строке. Поиск выполняется по началу слова.

Если найдены все искомые строки, то возвращается форматированная строка, в которой искомые строки подсвечены стандартным образом.

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

В слове, состоящем из цифр, лидирующие нули считаются и значащими, и незначащими. При наличии иерархии элемент считается найденным: если в нем есть все искомые слова, или в нем есть хотя бы одно искомое слово, а остальные слова содержатся в его родителях.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер, интеграция.

СтрНайтиПоРегулярномуВыражению (StrFindByRegularExpression)

Синтаксис: СтрНайтиПоРегулярномуВыражению(<Строка>, <РегулярноеВыражение>, <НаправлениеПоиска>, <НачальнаяПозиция>, <НомерВхождения>, <ИгнорироватьРегистр>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<РегулярноеВыражение> (обязательный) Тип: Строка. Регулярное выражение, по которому выполняется поиск.

<НаправлениеПоиска> (необязательный) Тип: НаправлениеПоиска. Указывает направление поиска регулярного выражения в строке. Значение по умолчанию: СНачала.

<НачальнаяПозиция> (необязательный) Тип: Число. Указывает позицию в строке, с которой начинается поиск.

Если параметр не задан и в параметре НаправлениеПоиска указано значение СНачала, то значение по умолчанию равно 1.

Если параметр не задан и в параметре НаправлениеПоиска указано значение СКонца, то значение по умолчанию равно длине строки.

Допускаются значения от 1 до количества символов в строке, в которой выполняется поиск. Если указано значение, не входящее в диапазон, генерируется ошибка "Неверное значение параметра".

Значение по умолчанию: 1.

<НомерВхождения> (необязательный)Тип: Число. Указывает номер вхождения искомой подстроки в исходной строке. Значение по умолчанию: 1.

<ИгнорироватьРегистр> (необязательный) Тип: Булево. Истина - без учета регистра, Ложь - с учетом регистра. Значение по умолчанию: Ложь.

<МногострочныйПоиск> (необязательный) Тип: Булево. Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки.

Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста.

Значение по умолчанию: Ложь.

Возвращаемое значение: Тип: РезультатПоискаПоРегулярномуВыражению.

Описание: Находит первое вхождение регулярного выражения в исходной строке.

Доступность: Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер).

СтрНачинаетсяС (StrStartsWith)

Синтаксис: СтрНачинаетсяС(<Строка>, <СтрокаПоиска>)

Параметры:

<Строка> (обязательный) Тип: Строка. Строка, начало которой проверяется на совпадение с подстрокой поиска.

<СтрокаПоиска> (обязательный) Тип: Строка. Строка, содержащая предполагаемое начало строки. В случае если переданное значение является пустой строкой генерируется исключительная ситуация.

Возвращаемое значение: Тип: Булево. Истина - строка начинается с указанной подстроки, Ложь - в противном случае.

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

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрПодобнаПоРегулярномуВыражению (StrLikeByRegularExpression)

Синтаксис: СтрПодобнаПоРегулярномуВыражению(<Строка>, <РегулярноеВыражение>, <ИгнорироватьРегистр>, <МногострочныйПоиск>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<РегулярноеВыражение> (обязательный) Тип: Строка. Регулярное выражение, на соответствие которому проверяется исходная строка.

<ИгнорироватьРегистр> (необязательный) Тип: Булево. Истина - без учета регистра, Ложь - с учетом регистра. Значение по умолчанию: Ложь.

<МногострочныйПоиск> (необязательный) Тип: Булево. Истина - выполняется многострочный поиск: символу "^" в шаблоне регулярного выражения соответствует начало каждой строки значения параметра <Строка>, символу "$" - конец каждой строки.

Ложь - символу "^" в шаблоне регулярного выражения соответствует начало значения в параметре <Строка>, символу "$" - конец текста.

Значение по умолчанию: Ложь.

Возвращаемое значение: Тип: Булево. Истина - строка соответствует регулярному выражению; Ложь - в противном случае.

Описание: Проверяет, соответствует ли передаваемая строка передаваемому шаблону исходного выражения.

Доступность: Сервер, толстый клиент, внешнее соединение.

СтрПолучитьСтроку (StrGetLine)

Синтаксис: СтрПолучитьСтроку(<Строка>, <НомерСтроки>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<НомерСтроки> (обязательный) Тип: Число. Номер получаемой строки. Нумерация строк в многострочной строке начинается с 1.

Возвращаемое значение: Тип: Строка. Полученная строка.

Описание: Получает строку многострочной строки по номеру.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрРазделить (StrSplit)

Синтаксис: СтрРазделить(<Строка>, <Разделитель>, <ВключатьПустые>)

Параметры:

<Строка> (обязательный) Тип: Строка. Разделяемая строка.

<Разделитель> (обязательный) Тип: Строка. Строка символов, каждый из которых является индивидуальным разделителем.

<ВключатьПустые> (необязательный) Тип: Булево. Указывает необходимость включать в результат пустые строки, которые могут образоваться в результате разделения исходной строки.

Значение по умолчанию: Истина.

Возвращаемое значение: Тип: Массив. Массив со строками, которые получились в результате разделения исходной строки.

Описание: Разделяет строку на части по указанным символам-разделителям.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрРазделить (StrSplit)

Синтаксис: СтрРазделить(<Строка>, <Разделитель>, <ВключатьПустые>)

Параметры:

<Строка> (обязательный) Тип: Строка. Разделяемая строка.

<Разделитель> (обязательный) Тип: Строка. Строка символов, каждый из которых является индивидуальным разделителем.

<ВключатьПустые> (необязательный) Тип: Булево. Указывает необходимость включать в результат пустые строки, которые могут образоваться в результате разделения исходной строки.

Значение по умолчанию: Истина.

Возвращаемое значение: Тип: Массив. Массив со строками, которые получились в результате разделения исходной строки.

Описание: Разделяет строку на части по указанным символам-разделителям.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрСоединить (StrConcat)

Синтаксис: СтрСоединить(<Строки>, <Разделитель>)

Параметры:

<Строки> (обязательный) Тип: ФиксированныйМассив, Массив. Массив, содержащий объединяемые строки.

<Разделитель> (необязательный) Тип: Строка. Строка, которая будет вставлена между объединяемыми строками. Если параметр не задан, строки будут объединены слитно друг с другом.

Значение по умолчанию: Неопределено.

Возвращаемое значение: Тип: Строка. Строка, содержащая соединенные исходные строки с разделителем между ними.

Описание: Соединяет массив переданных строк в одну строку с указанным разделителем.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрСравнить (StrCompare)

Синтаксис: СтрСравнить(<Строка1>, <Строка2>)

Параметры:

<Строка1> (обязательный) Тип: Строка. Строка для сравнения

<Строка2> (обязательный) Тип: Строка. Строка для сравнения.

Возвращаемое значение: Тип: Число. Возвращает:

-1 - первая строка меньше второй.

1 - первая строка больше второй.

0 - первая строка равна второй.

Описание: Выполняет сравнение строк без учета регистра, аналогичное сравнению строк с помощью объекта СравнениеЗначений.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрЧислоВхождений (StrOccurrenceCount)

Синтаксис: СтрЧислоВхождений(<Строка>, <ПодстрокаПоиска>)

Параметры:

<Строка> (обязательный) Тип: Строка. Исходная строка.

<ПодстрокаПоиска> (обязательный) Тип: Строка. Искомая подстрока.

Возвращаемое значение: Тип: Число. Число вхождений.

Описание: Вычисляет число вхождений подстроки поиска в исходной строке.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

СтрЧислоСтрок (StrLineCount)

Синтаксис: СтрЧислоСтрок(<Строка>)

Параметры:

<Строка> (обязательный)Тип: Строка. Исходная строка.

Возвращаемое значение: Тип: Число. Число строк.

Описание: Позволяет посчитать число строк в многострочной строке. Строки в многострочной строке разделены символами перевода строк (Символы.ПС). При этом если после последнего символа перевода строк нет символов, то он игнорируется.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

ТРег (Title)

Синтаксис: ТРег(<Строка>)

Параметры:

<Строка> (обязательный) Тип: Строка. Преобразуемая строка.

Возвращаемое значение: Тип: Строка.

Описание: Преобразует строку следующим образом: у каждого слова строки первый символ преобразуется к верхнему регистру. Все остальные символы преобразуются к нижнему регистру. Предназначен для работы с языками, для которых определено понятие титульного регистра (каждая начальная буква слова в строке - прописная), например, английский.

В веб-клиенте метод преобразует только символы латинского алфавита.

Доступность: Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент), мобильное приложение (сервер), мобильный автономный сервер.

Слишком маленькое разрешение экрана.