1C-Code → Основы 1С → Строки: склеить, разрезать, найти, проверить

Строки: склеить, разрезать, найти, проверить

Всё, что приходит от человека и из файла, приходит строкой. Здесь — как это разбирать и не обжечься.

Глава 6 из 36 · чтение примерно 26 минут

Строка — это текст: наименование, адрес, комментарий, номер договора. Но главное не это. Главное — что строкой приходит всё, что вводит человек и всё, что лежит в файле. Прежде чем стать числом или датой, данные побывают строкой, и разбирать их придётся вам.

Поэтому глава не столько про текст, сколько про разбор входных данных — работу, из которой состоит половина обмена с внешним миром.

Кавычки и кавычка внутри кавычек

Строка в коде записывается в двойных кавычках: "Гвозди 100мм". Одинарные кавычки в 1С для строк не используются вообще.

Если кавычка нужна внутри текста, её удваивают:

Кавычка внутри строки

Название = "ООО ""Ромашка""";
Сообщить(Название);   // ООО "Ромашка"

Длина и регистр

СтрДлина(Текст) — сколько символов. Пробелы считаются тоже, они такие же символы, как буквы.

Три команды меняют регистр: ВРег — всё заглавными, НРег — всё строчными, ТРег — каждое слово с заглавной.

Регистр

Лишние пробелы: СокрЛП

СокрЛП(Текст) убирает пробелы слева и справа. Есть ещё СокрЛ (только слева) и СокрП (только справа), но на практике почти всегда нужен именно СокрЛП.

Правило простое: всё, что пришло извне, сначала СокрЛП. Из файла, из поля ввода, из письма. Пробел в конце строки не видно на экране — и он ломает сравнение молча, без всякой ошибки.

Склейка и СтрШаблон

Плюс склеивает строки. Правило из первой главы действует здесь в полную силу: операцию задаёт то, что слева. "Итого: " + 1000 работает, 1000 + "Итого: " — ошибка.

Когда кусков больше трёх, склейка становится нечитаемой. Тогда берут СтрШаблон: в тексте расставляют %1, %2, а значения перечисляют следом.

Текст = "Заказ № " + Строка(Номер)
  + " от " + Формат(Дата, "ДФ=dd.MM.yyyy")
  + " на сумму " + Строка(Сумма);

Текст = СтрШаблон("Заказ № %1 от %2 на сумму %3",
  Номер, Формат(Дата, "ДФ=dd.MM.yyyy"), Сумма);

Отрезать кусок: Лев, Прав, Сред

Лев(Текст, N) — первые N символов. Прав(Текст, N) — последние N. Сред(Текст, Начало, Сколько) — кусок из середины.

И сразу важное: символы нумеруются с единицы. Первый символ имеет номер 1, а не 0. Если вы знаете другой язык — это как раз тот случай, где 1С отличается.

Три способа отрезать

Текст = "Привет";
Лев(Текст, 3);       // "При"
Прав(Текст, 3);      // "вет"
Сред(Текст, 2, 3);   // "рив" — с 2-го символа, длиной 3
Сред(Текст, 3);      // "ивет" — с 3-го и до конца

Поиск: СтрНайти

СтрНайти(Где, Что) возвращает номер позиции, с которой начинается найденный кусок. СтрНайти("Привет", "вет") даёт 4.

А если не нашлось — возвращается 0. Не −1, не Неопределено, а именно ноль. И поскольку позиций с номером 0 не бывает, проверка звучит так: Если СтрНайти(Где, Что) > 0 Тогда.

Заменить и посчитать

СтрЗаменить(Где, Что, НаЧто) заменяет все вхождения сразу, а не первое. Если заменять на пустую строку — получится удаление.

СтрЧислоВхождений(Где, Что) считает, сколько раз кусок встречается.

Ещё две команды читаются как обычная фраза: СтрНачинаетсяС(Текст, Начало) и СтрЗаканчиваетсяНа(Текст, Конец). Они возвращают Истину или Ложь и заменяют возню с Лев и Прав.

Разобрать строку на части

СтрРазделить(Текст, Разделитель) режет строку по разделителю и возвращает массив кусков. Обратная команда — СтрСоединить(Массив, Разделитель).

Это основной способ разобрать строку из файла: одна строка CSV — одно обращение к СтрРазделить.

Разбор строки из файла

Строка = "Иванов;ООО Ромашка;12000";
Части = СтрРазделить(Строка, ";");
Части[0];   // "Иванов"
Части[1];   // "ООО Ромашка"
Части[2];   // "12000" — это ещё строка, не число

Строка в число: только с проверкой

Число("250") даёт 250. А Число("двести") прекращает работу программы — это ошибка, а не ноль.

Разница принципиальна. Если файл прислали с опечаткой, обработка не «пропустит строку», а упадёт целиком, посреди загрузки, оставив половину данных.

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

Пустая строка

ПустаяСтрока(Текст) — Истина, если строка пустая или состоит из одних пробелов. Это не то же самое, что Текст = "": строка из трёх пробелов пустой не равна, а ПустаяСтрока про неё скажет Истина.

Для проверки заполненности полей нужна именно ПустаяСтрока — человек, нажавший пробел в поле ввода, не должен считаться заполнившим его.

Текст в несколько строк

Строку можно продолжить на следующей строке кода. Продолжение начинают с вертикальной черты — и без неё код не скомпилируется.

Выглядит это непривычно, но встречается постоянно: именно так пишут тексты запросов, а их в рабочем коде больше, чем чего бы то ни было ещё.

Как пишут текст запроса

Запрос.Текст =
"ВЫБРАТЬ
|	Ссылка,
|	Наименование
|ИЗ
|	Справочник.Номенклатура
|ГДЕ
|	Не ПометкаУдаления";

Служебные символы

Перевод строки и табуляцию в кавычках не напечатать — их берут из Символы.

Символы, которые нужны

Многострочный текст умеют разбирать две команды: СтрЧислоСтрок(Текст) — сколько в нём строк, и СтрПолучитьСтроку(Текст, Номер) — одна строка по номеру. Нумерация, как и у символов, с единицы.

Так читают файл, загруженный целиком, и так разбирают ответ внешней системы.

Формат: как показать число и дату человеку

Строка(1234567.891) даёт «1234567,891» — верно и нечитаемо. В документе, в отчёте, в письме нужно «1 234 567,89».

За это отвечает Формат(Значение, Строка). Вторая часть — набор указаний через точку с запятой. Их много, но в работе используются пять.

Что нужно помнить из Формат

Три команды, которых ждут на собеседовании

СтрНачинаетсяС(Текст, Начало) и СтрЗаканчиваетсяНа(Текст, Конец) — вместо Лев и Прав с подсчётом длины. Короче и не ошибётся на единицу.

СтрСравнить(А, Б) — сравнение без учёта регистра: 0 — строки равны, −1 и 1 — какая раньше. Это правильный ответ на вопрос «как сравнить строки, не обращая внимания на заглавные»: ВРег с обеих сторон работает, но СтрСравнить для этого и сделан.

СтрЗаменить, СтрНайти и СтрРазделить вы уже знаете — вместе с этими тремя они и есть весь набор, который нужен в обычной работе.

Шпаргалка по строкам

Что дальше

Строки разобраны. Следующая глава — даты: тип, в котором больше всего неочевидного. Начало дня, конец дня, «дата с временем» там, где ждали просто дату, — из-за этого отчёты теряют последний день периода, и это самая частая ошибка во всём учёте.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

← Числа: арифметика, округление и деньги
→ Даты: границы периода и потерянный последний день