Класс QRegExpValidator

Класс QRegExpValidator используется для проверки строки по регулярному выражению. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• regExp : QRegExp

• 1 свойство унаследовано от QObject

Открытые функции

Переопределённые открытые функции

• 4 открытых функции унаследованы от QValidator
• 32 открытых функции унаследованы от QObject

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 1 сигнал унаследован от QValidator
• 2 сигнала унаследованы от QObject
• 11 статических открытых членов унаследованы от QObject
• 9 защищённых функций унаследованы от QObject

Подробное описание

Класс QRegExpValidator используется для проверки строки по регулярному выражению.

QRegExpValidator использует регулярное выражение (regexp) для определения того, является ли входная строка Приемлемой, Промежуточной или Недействительной. Регулярное выражение может быть задано при создании объекта QRegExpValidator или позже.

При определении QRegExpValidator является ли строка Приемлемой или нет, регулярное выражение обрабатывается так, как будто оно начинается с утверждения начала строки (^) и заканчивается утверждением конца строки ($); сопоставление выполняется со всей входной строкой или с заданной позиции, если задана начальная позиция, отличная от нуля.

Если строка является префиксом Приемлемой строки, она считается Промежуточной. Например, "" и "A" являются Промежуточными для регулярного выражения [A-Z][0-9] (в то время как "_" будет Недействительным).

Краткое введение в движок регулярных выражений Qt см. в QRegExp.

Пример использования:

// regexp: optional '-' followed by between 1 and 3 digits
QRegExp rx("-?\\d{1,3}");
QValidator *validator = new QRegExpValidator(rx, this);

QLineEdit *edit = new QLineEdit(this);
edit->setValidator(validator);

Ниже приведены примеры валидаторов. На практике они обычно ассоциируются с виджетом, как в примере выше.

// integers 1 to 9999
QRegExp rx("[1-9]\\d{0,3}");
// the validator treats the regexp as "^[1-9]\\d{0,3}$"
QRegExpValidator v(rx, 0);
QString s;
int pos = 0;

s = "0";     v.validate(s, pos);    // returns Invalid
s = "12345"; v.validate(s, pos);    // returns Invalid
s = "1";     v.validate(s, pos);    // returns Acceptable

rx.setPattern("\\S+");            // one or more non-whitespace characters
v.setRegExp(rx);
s = "myfile.txt";  v.validate(s, pos); // Returns Acceptable
s = "my file.txt"; v.validate(s, pos); // Returns Invalid

// A, B or C followed by exactly five digits followed by W, X, Y or Z
rx.setPattern("[A-C]\\d{5}[W-Z]");
v.setRegExp(rx);
s = "a12345Z"; v.validate(s, pos);        // Returns Invalid
s = "A12345Z"; v.validate(s, pos);        // Returns Acceptable
s = "B12";     v.validate(s, pos);        // Returns Intermediate

// match most 'readme' files
rx.setPattern("read\\S?me(\.(txt|asc|1st))?");
rx.setCaseSensitive(false);
v.setRegExp(rx);
s = "readme";      v.validate(s, pos); // Returns Acceptable
s = "README.1ST";  v.validate(s, pos); // Returns Acceptable
s = "read me.txt"; v.validate(s, pos); // Returns Invalid
s = "readm";       v.validate(s, pos); // Returns Intermediate

См. также QRegExp, QIntValidator, QDoubleValidator и Пример редактора настроек.

Документация по членам-функциям

QRegExpValidator::QRegExpValidator(QObject *parent = Q_NULLPTR)

Конструктор валидатора с объектом parent, который принимает любую строку (включая пустую) как корректную.

QRegExpValidator::QRegExpValidator(const QRegExp &rx, QObject *parent = Q_NULLPTR)

Конструктор валидатора с объектом parent, который принимает все строки, соответствующие регулярному выражению rx.

Сопоставление выполняется со всей строкой; например, если regexp — [A-Fa-f0-9]+, он будет обрабатываться как ^[A-Fa-f0-9]+$.

QRegExpValidator::~QRegExpValidator()

Деструктор валидатора.

[virtual] QValidator::State QRegExpValidator::validate(QString &input, int &pos) const

Переопределена из QValidator::validate().

Возвращает Приемлемо, если input соответствует регулярному выражению для этого валидатора, Промежуточно, если оно частично соответствует (т. е. может соответствовать, если добавить дополнительные символы), и Недействительно, если input не соответствует.

Кроме того, если input не соответствует, параметр pos устанавливается в длину параметра input.

Например, если регулярное выражение — \w\d\d (символ слова, цифра, цифра), то "A57" — Приемлемо, "E5" — Промежуточно, а "+9" — Недействительно.

См. также QRegExp::exactMatch().