QDoubleValidator Class

멤버 함수 설명서

[explicit] QDoubleValidator::QDoubleValidator(QObject *parent = nullptr)

parent 객체를 사용하여, 모든 double 값을 허용하는 유효성 검사기 객체를 생성합니다.

QDoubleValidator::QDoubleValidator(double bottom, double top, int decimals, QObject *parent = nullptr)

parent 객체를 사용하여 유효성 검사기 객체를 생성합니다. 이 유효성 검사기는 bottom 부터 top 까지(해당 값 포함)의 double 값을 허용하며, 소수점 뒤 자릿수는 최대 decimals 까지 허용합니다.

[virtual noexcept] QDoubleValidator::~QDoubleValidator()

밸리데이터를 삭제합니다.

[override virtual, since 6.3] void QDoubleValidator::fixup(QString &input) const

QValidator::fixup(QString &input) const를 재구현합니다.

input 문자열을 double 형식의 Acceptable 표현으로 변환하려고 시도합니다.

숫자의 형식은 notation(), decimals(), locale() 및 후자의 numberOptions()에 의해 결정됩니다.

notation()을 준수하기 위해, ScientificNotation 가 사용될 경우 고정값은 정규화된 형태로 표현되며, 이는 0이 아닌 모든 값이 소수점 앞에 0이 아닌 자릿수를 하나 갖게 됨을 의미합니다.

QString input = "0.98765e2";
QDoubleValidator val;
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::ScientificNotation);
val.fixup(input); // input == "9.8765e+01"

decimals()을 준수하기 위해, -1 인 경우 사용되는 자릿수는 QLocale::FloatingPointShortest 에 의해 결정됩니다. 그렇지 않은 경우, 숫자의 소수 부분이 decimals()을 초과하면 (적절한 경우 반올림과 함께) 잘립니다. notation()이 ScientificNotation 인 경우, 이는 숫자가 정규화된 형태로 변환된 후에 수행됩니다.

input = "-1234.6789";
val.setDecimals(2);
val.setLocale(QLocale::C);
val.setNotation(QDoubleValidator::StandardNotation);
val.fixup(input); // input == "-1234.68"

이 함수는 Qt 6.3에서 도입되었습니다.

void QDoubleValidator::setRange(double minimum, double maximum, int decimals)

유효성 검사기가 minimum 부터 maximum 까지(이 두 값 포함)의 double 값을 허용하도록 설정하며, 소수점 뒤 자릿수는 최대 decimals 개까지 허용합니다.

void QDoubleValidator::setRange(double minimum, double maximum)

소수점 이하 자릿수를 변경하지 않은 채로 minimum 부터 maximum 까지(해당 값 포함)의 double 값을 허용하도록 유효성 검사기를 설정합니다.

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

QValidator::validate(QString &input, int &pos) const를 재구현합니다.

문자열 input 이 올바른 형식이며 유효한 범위의 double 값을 포함하고 있는 경우 Acceptable 를 반환합니다.

input 가 잘못된 형식이거나 범위를 벗어난 double 값을 포함하는 경우 Intermediate 를 반환합니다.

input 이 double을 나타내지 않거나 소수점 뒤 자릿수가 너무 많으면 Invalid 을 반환합니다.

참고: 유효 범위가 양의 double만 포함하는 경우(예: 0.0~100.0)에 input 가 음의 double인 경우, Invalid 가 반환됩니다. notation()가 StandardNotation 로 설정되어 있고, 입력값의 소수점 앞 자릿수가 유효 범위의 double이 가질 수 있는 자릿수보다 많은 경우, Invalid 가 반환됩니다. notation()가 ScientificNotation 인 경우, 입력값이 유효한 범위에 속하지 않으면 Intermediate 가 반환됩니다. 지수를 변경하면 해당 값이 유효해질 수도 있습니다.

기본적으로 이 유효성 검사기는 ` pos ` 매개변수를 사용하지 않습니다.