К статье
Практический материал

Другое · 7 мин

Как получить длину строки в 1С: пошаговый разбор

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

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

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

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

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

Когда длина строки нужна в 1С

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

Другой типичный случай — динамическое формирование строк, где длина исходного значения влияет на отступы, обрезку или добавление разделителей. В таких ситуациях длина используется как вспомогательное число, а не как самоцель.

Как работает функция определения длины

Функция принимает один аргумент — строку — и возвращает число. Если строка пустая, результат равен нулю. Пробелы и непечатаемые символы учитываются, если они входят в значение, поэтому предварительная обрезка может изменить результат.

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

Порядок действий
  1. 1
    Убедитесь, что значение имеет строковый тип или приведите его к строке осознанно.
  2. 2
    Вызовите функцию определения длины и сохраните результат в переменную числового типа.
  3. 3
    Сравните результат с ожидаемым ограничением или условием.
  4. 4
    При необходимости очистите строку от пробелов перед повторной проверкой.

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

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

Подготовка данных и преобразование типов

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

Используйте средства проверки типа значения, доступные в языке 1С, чтобы избежать ошибок при выполнении. Если тип неизвестен, лучше сначала выполнить проверку, а затем передать в функцию только подтверждённое строковое значение.

1c
Результат = СтрДлина(ИсходнаяСтрока);

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

Проверка результата и границы безопасной самостоятельной работы

Безопасно самостоятельно использовать функцию длины в обычных модулях форм, отчётах и обработках, если значения подконтрольны и не содержат ссылочных типов. Риск растёт при работе с данными из внешних источников, неструктурированными текстами и большими объёмами.

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

Типичные ошибки
01
Передача числа, даты или ссылки без явного преобразования и проверки типа.
02
Считание длины строки с пробелами признаком заполненности поля.
03
Использование длины строки вместо количества строк таблицы или элементов массива.
04
Пропуск проверки результата перед обрезкой или записью в реквизит с ограничением длины.

Альтернативы и связанные операции

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

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

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

Итог

Что важно запомнить

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

Нужно ли преобразовывать число к строке перед вызовом функции длины?

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

Что вернёт функция для пустой строки?

Обычно результат равен нулю. Это не ошибка, но такое значение может пройти проверку «больше нуля» и не пройти проверку обязательного заполнения, если пустая строка недопустима.

Учитываются ли пробелы при определении длины?

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

Можно ли использовать длину строки вместо количества строк табличной части?

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

Когда стоит обратиться к специалисту по 1С?

Если длина строки используется для критической валидации, расчёта или обмена данными, особенно с внешними системами. Также стоит обратиться за помощью при неочевидных ошибках выполнения с неопределёнными или ссылочными значениями.