|  | Home · Overviews · Examples |

# QIntValidator Class Reference
[com.trolltech.qt.gui module]

The `QIntValidator` class provides a validator that ensures a string contains a valid integer within a specified range. More...

Inherits `QValidator`.

## Detailed Description

The `QIntValidator` class provides a validator that ensures a string contains a valid integer within a specified range.

Example of use:

        QValidator *validator = new QIntValidator(100, 999, this);
        QLineEdit *edit = new QLineEdit(this);

        // the edit lineedit will only accept integers between 100 and 999
        edit->setValidator(validator);

Below we present some examples of validators. In practice they would normally be associated with a widget as in the example above.

        QString str;
        int pos = 0;
        QIntValidator v(100, 999, this);

        str = "1";
        v.validate(str, pos);     // returns Intermediate
        str = "12";
        v.validate(str, pos);     // returns Intermediate

        str = "123";
        v.validate(str, pos);     // returns Acceptable
        str = "678";
        v.validate(str, pos);     // returns Acceptable

        str = "1234";
        v.validate(str, pos);     // returns Invalid
        str = "-123";
        v.validate(str, pos);     // returns Invalid
        str = "abc";
        v.validate(str, pos);     // returns Invalid
        str = "12cm";
        v.validate(str, pos);     // returns Invalid

The minimum and maximum values are set in one call with `setRange`, or individually with `setBottom` and `setTop`.

`QIntValidator` uses its `locale` to interpret the number. For example, in Arabic locales, `QIntValidator` will accept Arabic digits. In addition, `QIntValidator` is always guaranteed to accept a number formatted according to the "C" locale.

See also `QDoubleValidator`, `QRegExpValidator`, and Line Edits Example.