---
name: "qintvalidator"
section: "3qt"
platform: "linux"
package: "qt3-doc"
version: "3:3.3.8b-7"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/qintvalidator"
---

# qintvalidator(3qt)

Validator which ensures that a string contains a valid integer within a specified range

## NAME

QIntValidator - Validator which ensures that a string contains a valid integer within a specified range

## SYNOPSIS

`#include <qvalidator.h>`

Inherits QValidator.

### Public Members

**QIntValidator ( QObject \* parent, const char \* name = 0 )**\
 **QIntValidator ( int minimum, int maximum, QObject \* parent, const char \* name = 0 )**\
 **~QIntValidator ()**\
 **virtual QValidator::State validate ( QString & input, int & ) const**\
 **void setBottom ( int )**\
 **void setTop ( int )**\
 **virtual void setRange ( int bottom, int top )**\
 **int bottom () const**\
 **int top () const**\

### Properties

**int bottom - the validator's lowest acceptable value**\
 **int top - the validator's highest acceptable value**\

## DESCRIPTION

The QIntValidator class provides a validator which ensures that 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().

See also QDoubleValidator, QRegExpValidator, and Miscellaneous Classes.

## MEMBER FUNCTION DOCUMENTATION

## QIntValidator::QIntValidator ( QObject \* parent, const char \* name = 0 )

Constructs a validator called *name* with parent *parent*, that accepts all integers.

## QIntValidator::QIntValidator ( int minimum, int maximum, QObject \* parent, const char \* name = 0 )

Constructs a validator called *name* with parent *parent*, that accepts integers from *minimum* to *maximum* inclusive.

## QIntValidator::~QIntValidator ()

Destroys the validator, freeing any resources allocated.

## int QIntValidator::bottom () const

Returns the validator's lowest acceptable value. See the "bottom" property for details.

## void QIntValidator::setBottom ( int )

Sets the validator's lowest acceptable value. See the "bottom" property for details.

## void QIntValidator::setRange ( int bottom, int top )` [virtual]`

Sets the range of the validator to only accept integers between *bottom* and *top* inclusive.

## void QIntValidator::setTop ( int )

Sets the validator's highest acceptable value. See the "top" property for details.

## int QIntValidator::top () const

Returns the validator's highest acceptable value. See the "top" property for details.

## QValidator::State QIntValidator::validate ( QString & input, int & ) const` [virtual]`

Returns Acceptable if the *input* is an integer within the valid range, Intermediate if the *input* is an integer outside the valid range and Invalid if the *input* is not an integer.

Note: If the valid range consists of just positive integers (e.g. 32 - 100) and *input* is a negative integer then Invalid is returned.

```
    int pos = 0;
    s = "abc";
    v.validate( s, pos ); // returns Invalid
    s = "5";
    v.validate( s, pos ); // returns Intermediate
    s = "50";
    v.validate( s, pos ); // returns Valid
```

Reimplemented from QValidator.

### Property Documentation

## int bottom

This property holds the validator's lowest acceptable value.

Set this property's value with setBottom() and get this property's value with bottom().

See also setRange().

## int top

This property holds the validator's highest acceptable value.

Set this property's value with setTop() and get this property's value with top().

See also setRange().

## SEE ALSO

**http://doc.trolltech.com/qintvalidator.html** **http://www.trolltech.com/faq/tech.html**

## COPYRIGHT

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com.  See the license file included in the distribution for a complete license statement.

## AUTHOR

Generated automatically from the source code.

## BUGS

If you find a bug in Qt, please report it as described in **http://doc.trolltech.com/bughowto.html**. Good bug reports help us to help you. Thank you.

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech.

If you find errors in this manual page, please report them to **qt-bugs@trolltech.com**. Please include the name of the manual page (qintvalidator.3qt) and the Qt version (3.3.8).