Класс QRegExpValidator

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

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

Свойства

• regExp : QRegExp

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

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

Сигналы

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

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

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

Если строка является префиксом Приемлемой строки, то она считается Промежуточной. Например, "" и "A" являются Промежуточными для regexp [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(const QRegExp &rx, QObject *parent = nullptr)

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

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

QRegExpValidator::QRegExpValidator(QObject *parent = nullptr)

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

[virtual] QRegExpValidator::~QRegExpValidator()

Удаляет валидатор.

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

Реализует: QValidator::validate(QString &input, int &pos) const.

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

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

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

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