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

Другое · 7 мин

Как в 1С проверить, что в строке только цифры

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

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

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

Что считается допустимой строкой

Перед проверкой определите, какие значения допустимы. Обычно подходит набор символов от «0» до «9», без пробелов, без знака плюс или минус, без запятой и точки. Если строка пустая, решите заранее: считать её ошибкой или допустить как отсутствие ввода.

Символы других алфавитов, например арабские или индийские цифры, не входят в диапазон «0»–«9» при обычном сравнении кодов. Если конфигурация работает с такими данными, нужно уточнить требование отдельно, а не полагаться только на стандартный диапазон.

Проверка перебором символов

Надёжный способ без дополнительных объектов — пройти по строке циклом и сравнить код каждого символа с кодами «0» и «9». Если хотя бы один символ выходит за пределы, вернуть ложь. Это подходит для модулей объектов, форм и общих модулей.

Функция СтрокаСодержитТолькоЦифры(Знач Строка)
Для Каждого Символ Из Строка Цикл
Если КодСимвола(Символ) < КодСимвола("0") Или КодСимвола(Символ) > КодСимвола("9") Тогда
Возврат Ложь;
КонецЕсли;
КонецЦикла;

Возврат Строка <> "";
КонецФункции

В примере пустая строка считается неприемлемой. Если пустое значение допустимо, уберите условие Возврат Строка <> "" или проверяйте заполненность отдельно перед вызовом функции. Пробелы по краям также приведут к отрицательному результату, потому что код пробела не входит в цифровой диапазон.

Порядок действий
  1. 1
    Определите, пустая строка допустима или нет
  2. 2
    Выберите место проверки: форма, модуль объекта или общий модуль
  3. 3
    Напишите функцию перебора символов или подходящий альтернативный способ
  4. 4
    Протестируйте на цифрах, буквах, пробелах, знаках и пустой строке
  5. 5
    Добавьте сообщение пользователю при отказе ввода

Проверка через замену и регулярные выражения

Альтернативный подход — удалить из строки все цифры и проверить, осталось ли что-то. Если после удаления строки она пуста, исходная состоит только из цифр. Этот метод проще в записи, но требует отдельной проверки на пустую строку и может вести себя иначе при наличии непечатаемых символов.

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

Проверка на форме при вводе

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

Проверка в модуле объекта и запросе

В модуле объекта проверяйте перед Записью или в обработчике проверки заполнения. В запросе прямо проверить «только цифры» встроенными средствами сложнее; обычно отбирают данные в запросе, а окончательную валидацию делают на языке встроенного программирования после выборки.

Типичные ошибки
01
Пустая строка прошла проверку, хотя должна быть ошибкой
02
Пробелы по краям не отсеяны и привели к отказу ввода
03
Знак минус или запятая приняты за часть числа

Где и как проводить проверку: форма, модуль, запрос

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

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

Сравнение вариантов

Перебор символов

Надёжный и понятный способ для большинства конфигураций, требует отдельной проверки пустой строки

Удаление цифр

Короткая запись, но менее очевидна при поддержке и требует проверки на пустоту

Регулярные выражения

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

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

Ограничения, риски и контроль результата

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

Контрольные точки

Как проверить результат

Строка из цифр
Норма

Принимается и записывается

Тревожный признак

Отклоняется с сообщением

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

Обрабатывается по правилу: разрешена или ошибка

Тревожный признак

Непредсказуемое поведение без правила

Строка с пробелами или знаками
Норма

Отклоняется

Тревожный признак

Принимается из-за пропуска проверки

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

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

Итог

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

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

Частые вопросы

Нужно ли удалять пробелы перед проверкой?

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

Работает ли проверка для отрицательных чисел?

Нет, если использовать только диапазон «0»–«9». Знак минус не входит в этот диапазон и приведёт к отказу. Для отрицательных чисел нужно отдельно разрешить знак в начале или использовать другой тип данных.

Можно ли проверить только цифры в запросе 1С?

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

Что делать, если строка содержит цифры и буквы?

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

Нужна ли отдельная проверка на пустую строку?

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