QLocale Class

成员函数文档

QLocale::QLocale()

构建一个使用默认区域设置初始化的 QLocale 对象。

如果未通过setDefault() 设置默认区域设置，则该区域设置将与system() 返回的区域设置相同。

另请参阅 setDefault() 和system()。

[explicit, since 6.3] QLocale::QLocale(QStringView name)

根据指定的name 创建一个QLocale对象。

名称的格式为“language[_script][_territory][.codeset][@modifier]”或“C”，其中：

• language 是小写、由两个字母组成的 ISO 639 语言代码（某些由三个字母组成的代码也被识别），
• script 是全大写、四字母的 ISO 15924 文字代码，
• territory 是大写、由两个字母组成的 ISO 3166 地区代码（某些数字代码也被识别），
• codeset 和 modifier 将被忽略。

分隔符可以是下划线'_' （U+005F，“下划线”）或连字符'-' （U+002D，“连字符-减号”）。 如果 QLocale 没有指定语言、脚本和地区的组合数据，则会使用它能找到的最合适的匹配项。如果字符串违反了区域设置格式，或者无法为指定的键找到合适的数据，则改用“C”区域设置。

此构造函数的速度远低于 QLocale(Language, Script, Territory) 或 QLocale(Language, Territory)。

该函数在 Qt 6.3 中引入。

另请参阅 bcp47Name() 和Matching combinations of language, script and territory 。

QLocale::QLocale(QLocale::Language language, QLocale::Territory territory)

根据指定的language 和territory 构建一个QLocale对象。

如果该组合中使用了多个脚本，则会选择一个可能的脚本。如果 QLocale 没有指定language 的数据，则使用默认区域设置。如果 QLocale 没有指定language 和territory 的组合数据，则可能会使用其他地区代替。

另请参阅 setDefault() 和Matching combinations of language, script and territory 。

QLocale::QLocale(QLocale::Language language, QLocale::Script script = AnyScript, QLocale::Territory territory = AnyTerritory)

根据指定的language 、script 和territory 构建一个QLocale对象。

如果 QLocale 没有给定组合的数据，它将尽可能寻找最匹配的数据。如果

• language AnyLanguage ，且无法从 推断出语言，同时script territory
• 且 QLocale 既没有通过language 给定的语言数据，也没有通过上述方式推断出的语言数据。

另请参阅 setDefault() 和Matching combinations of language, script and territory 。

[explicit] QLocale::QLocale(const QString &name)

[noexcept] QLocale::QLocale(const QLocale &other)

创建一个 QLocale 对象，作为other 的副本。

[noexcept] QLocale::~QLocale()

析构函数

QString QLocale::amText() const

返回采用12小时制约定指定时间时，“AM”后缀的本地化名称。

另请参阅 pmText()。

QString QLocale::bcp47Name(QLocale::TagSeparator separator = TagSeparator::Dash) const

返回用连字符连接的 BCP47 字段名称。

该字符串会将该语言环境所需的“语言”、“文字”和“地区”（以及可能的其他 BCP47 字段）进行组合，以唯一地指定该语言环境。请注意，如果根据 Unicode 联盟的Likely Subtag Rules 规范，在给定保留的字段时，省略的字段会被隐含，则可以省略某些字段。 如果需要其他格式，请参阅name() 以了解如何从各个字段构建字符串。

与uiLanguages() 不同，bcp47Name() 返回的值代表QLocale 数据的区域设置名称；这未必是用户界面应采用的语言。

该函数试图使区域设置名称符合由 RFC 5646 定义的 IETF 最佳通用实践 47（BCP 47）。自 Qt 6.7 起，它支持一个可选的separator 参数，可用于覆盖 BCP 47 规定的使用连字符分隔标签的规则。 但在IETF定义的协议中使用时，应保留默认设置QLocale::TagSeparator::Dash 。

另请参阅 name()、language()、territory()、script() 以及uiLanguages()。

[static noexcept] QLocale QLocale::c()

返回一个初始化为“C”语言环境的QLocale 对象。

该区域设置基于 en_US，但具有一些独特的特性，例如简化的数字格式和特有的日期格式。它实现了描述“C”编程语言标准库函数行为的 POSIX 标准。

这意味着，其排序规则基于字母的 ASCII 值，因此（在区分大小写的排序中）所有大写字母都会排在小写字母之前（而不是每个字母的大写和小写形式紧邻排列，然后才是下一个字母的两种形式）。

另请参阅 system()。

[static noexcept, since 6.3] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

返回与符合 ISO 639 标准定义的两个或三个字母的languageCode 相对应的QLocale::Language 枚举值。

如果指定了codeTypes ，则该枚举将用于选择转换时要考虑的代码集。默认情况下，Qt XML所知的所有代码都会被考虑。代码按以下顺序进行匹配：ISO639Part1 、ISO639Part2B 、ISO639Part2T 、ISO639Part3 、LegacyLanguageCode 。

如果代码无效或未知，则返回QLocale::AnyLanguage 。

该函数自 Qt 6.3 起引入。

另请参阅 languageToCode()、codeToTerritory() 和codeToScript()。

[static noexcept, since 6.1] QLocale::Script QLocale::codeToScript(QStringView scriptCode)

返回与四字母脚本scriptCode 对应的 `QLocale::Script ` 枚举值，该定义见 ISO 15924 标准。

如果代码无效或未知，则返回QLocale::AnyScript 。

该函数在 Qt 6.1 中引入。

另请参阅 scriptToCode()、codeToLanguage() 和codeToTerritory()。

[static noexcept, since 6.2] QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode)

返回与两字母或三位数字的territoryCode （如ISO 3166标准所定义）相对应的QLocale::Territory 枚举值。

如果代码无效或未知，则返回QLocale::AnyTerritory 。

该函数在 Qt 6.2 中引入。

另请参阅 territoryToCode()、codeToLanguage() 和codeToScript()。

QLocale QLocale::collation() const

返回用于排序的区域设置。

结果通常是该区域设置；但是，系统区域设置（通常是默认区域设置）将返回系统排序规则区域设置。该结果适合传递给QCollator 的构造函数。

另请参阅 QCollator 。

QString QLocale::createSeparatedList(const QStringList &list) const

返回一个字符串，该字符串表示将给定的字符串list 与由区域设置定义的分隔符进行连接后的结果。

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

根据《货币符号标准》（format ）返回相应的货币符号。

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

返回当前区域设置所使用的日期格式。

如果 `format ` 的值为 `LongFormat`，则格式为详细格式；否则为简短格式。例如，对于区域设置 `en_US `，`LongFormat ` 的结果为 `dddd, MMMM d, yyyy`，而 `ShortFormat ` 的结果为 `M/d/yy`。

另请参阅 QDate::toString() 和QDate::fromString()。

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

返回当前区域设置所使用的日期时间格式。

如果 `format ` 为 `LongFormat`，则格式为详细格式；否则为简短格式。例如，对于 `en_US ` 区域设置，`LongFormat ` 的结果为 `dddd, MMMM d, yyyy h:mm:ss AP t`，`ShortFormat ` 的结果为 `M/d/yy h:mm AP`。

另请参阅 QDateTime::toString() 和QDateTime::fromString()。

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

返回day 的本地化名称（其中1代表星期一，2代表星期二，依此类推），格式由type 指定。

例如，如果语言环境为“星期一”（en_US ），且day 的值为1，则LongFormat 将返回Monday ，ShortFormat 将返回Mon ，NarrowFormat 将返回M 。

另请参阅 monthName() 和standaloneDayName()。

QString QLocale::decimalPoint() const

返回此区域设置的小数部分分隔符。

这是在包含小数部分的数字表示中，用于将整数部分与小数部分分隔开的标记。它通常被称为“小数点字符”——尽管在许多区域设置中，它并不是一个“点”（或类似的圆点）。 （自 Qt 6.0 起）该值以字符串形式返回，以防某些区域设置需要多个 UTF-16 码点来表示其分隔符。

另请参阅 groupSeparator() 和toString()。

QString QLocale::exponential() const

返回此区域设置的指数分隔符。

这是一个用于在某些浮点数表示法中将尾数与指数分隔开的标记。自 Qt 6.0 起，该值以字符串形式返回，因为在某些区域设置中，它并非单个字符——例如，它可能由乘号和“10 的幂”运算符的表示形式组成。

另请参阅 toString(double, char, int)。

Qt::DayOfWeek QLocale::firstDayOfWeek() const

根据当前区域设置返回一周中的第一天。

QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

将以字节为单位的数值转换为易于理解的本地化字符串，该字符串由一个数字和一个带量词组成。量词的选择应确保该数字不小于1，且尽可能小。 例如，若bytes 为16384，precision 为2，且format 为DataSizeIecFormat （默认值），则该函数返回“16.00 KiB”；对于1330409069609字节，它返回“1.21 GiB”；以此类推。 如果format 设置为DataSizeIecFormat 或DataSizeTraditionalFormat ，则给定的字节数将除以 1024 的幂，且结果小于 1024；对于DataSizeSIFormat ，则除以 1000 的幂，且结果小于 1000。DataSizeIecFormat 使用新的IEC标准量词Ki、Mi等，而DataSizeSIFormat 则使用较旧的SI量词k、M等，DataSizeTraditionalFormat 则滥用了这些量词。

QString QLocale::groupSeparator() const

返回此区域设置的数字分组分隔符。

这是一个用于将数字表示中的长数字序列拆分为若干组以方便阅读的标记。在某些区域设置中，该标记可能为空，表示不应以这种方式将数字拆分为组。 在其他区域设置中，它可能是空格字符。自 Qt 6.0 起，该参数以字符串形式返回，以应对某些区域设置需要多个 UTF-16 码点来表示其分隔符的情况。

另请参阅 decimalPoint() 和toString()。

QLocale::Language QLocale::language() const

返回此区域设置的语言。

另请参阅 script()、territory()、languageToString() 以及bcp47Name()。

[static, since 6.3] QString QLocale::languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

返回language 的两个或三个字母的语言代码，该代码符合ISO 639标准。

如果指定了codeTypes ，则该参数将决定采用哪一组代码。函数将返回该组中为language 定义的首个代码。否则，将考虑所有ISO-639代码。代码的处理顺序如下：ISO639Part1 、ISO639Part2B 、ISO639Part2T 、ISO639Part3 。本函数将忽略LegacyLanguageCode 。

该函数在 Qt 6.3 中引入。

另请参阅 codeToLanguage()、language()、name()、bcp47Name()、territoryToCode() 以及scriptToCode()。

[static] QString QLocale::languageToString(QLocale::Language language)

返回一个QString ，其中包含language 的名称。

另请参阅 territoryToString()、scriptToString() 和bcp47Name()。

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)

返回一个包含符合给定language 、script 和territory 的有效区域设置对象的列表。

获取所有区域设置的列表：QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage,QLocale::AnyScript,QLocale::AnyTerritory);

获取适用于俄罗斯的语言环境列表：QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage,QLocale::AnyScript,QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

返回该区域设置的度量单位系统。

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

返回month 的本地化名称，格式由type 指定。

例如，如果区域设置为en_US ，且month 为 1，则LongFormat 将返回January 。ShortFormat 将返回Jan ，而NarrowFormat 将返回J 。

另请参阅 dayName() 和standaloneMonthName()。

QString QLocale::name(QLocale::TagSeparator separator = TagSeparator::Underscore) const

此区域设置的短名称。

返回该区域设置的语言和地区，格式为“language_territory”的字符串，其中 language 是小写、由两个字母组成的 ISO 639 语言代码，territory 是大写、由两个或三个字母组成的 ISO 3166 地区代码。 如果该区域设置未指定领土，则仅返回语言名称。从 Qt 6.7 开始，可以提供可选的separator 参数来覆盖默认用于分隔这两个标签的下划线字符。

即使QLocale 对象是在显式指定脚本的情况下构造的，出于兼容性考虑，name() 也不会包含该脚本。若需要完整的区域设置名称，请改用bcp47Name()；或者通过将language()返回的结果传递给languageToCode()（对于脚本和地区，操作方式类似）来构建用于标识区域设置的字符串。

另请参阅 QLocale()、language()、script()、territory()、bcp47Name() 以及uiLanguages() 函数。

QString QLocale::nativeLanguageName() const

返回该区域设置所属语言的本地名称。例如，对于瑞士德语区域设置，返回“Schweizer Hochdeutsch”。

另请参阅 nativeTerritoryName() 和languageToString()。

[since 6.2] QString QLocale::nativeTerritoryName() const

返回该区域设置对应的地区本地名称。例如，对于西班牙语/西班牙区域设置，返回“España”。

该函数于 Qt 6.2 中引入。

另请参见 nativeLanguageName() 和territoryToString()。

QString QLocale::negativeSign() const

返回该区域设置的负号指示符。

这是一个被假定为用作数字前缀以表示该数字为负数的标记。自 Qt 6.0 起，该值以字符串形式返回，因为在某些区域设置中，它并非单个字符——例如，因为它包含文本方向控制字符。

另请参阅 positiveSign() 和toString()。

QLocale::NumberOptions QLocale::numberOptions() const

返回与该QLocale 实例相关的数字转换选项。

默认情况下，标准区域设置未设置任何选项，但“C”区域设置除外，其默认已设置为OmitGroupSeparator 。

另请参阅 setNumberOptions()、toString()、groupSeparator() 以及FloatingPointPrecisionOption 。

QString QLocale::percent() const

返回该区域设置的百分比标记。

这是一个被假定为附加在数字后以表示百分比的标记。自 Qt 6.0 起，它以字符串形式返回，因为在某些区域设置中，它并非单个字符——例如，因为它包含文本方向控制字符。

另请参阅 toString()。

QString QLocale::pmText() const

返回采用12小时制表示的时间所对应的“PM”后缀的本地化名称。

另请参阅 amText()。

QString QLocale::positiveSign() const

返回此区域设置的正号指示符。

这是一个被假定为用作数字前缀以表示该数字为正数的标记。自 Qt 6.0 起，该标记以字符串形式返回，因为在某些区域设置中，它并非单个字符——例如，因为它包含文本方向控制字符。

另请参阅 negativeSign() 和toString()。

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

返回根据当前区域设置，使用给定的引号格式style 对str 进行引号处理后的结果。

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

该函数在 Qt 6.0 中引入。

QLocale::Script QLocale::script() const

返回此语言环境的脚本。

另请参阅 language()、territory()、languageToString()、scriptToString() 以及bcp47Name()。

[static, since 6.1] QString QLocale::scriptToCode(QLocale::Script script)

返回script 的四字母脚本代码，该代码定义于ISO 15924标准中。

该函数于 Qt 6.1 中引入。

另请参阅 script()、name()、bcp47Name()、languageToCode() 以及territoryToCode()。

[static] QString QLocale::scriptToString(QLocale::Script script)

返回一个QString ，其中包含script 的名称。

另请参阅 languageToString()、territoryToString()、script() 以及bcp47Name()。

[static] void QLocale::setDefault(const QLocale &locale)

将全局默认区域设置为locale 。

当不带任何参数构造QLocale 对象时，将使用此区域设置。如果未调用此函数，则使用系统的区域设置。

警告：此函数不可重入。

另请参阅 system() 和c()。

void QLocale::setNumberOptions(QLocale::NumberOptions options)

设置与该QLocale 实例的数字转换相关的options 。

另请参阅 numberOptions() 和FloatingPointPrecisionOption 。

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

返回day 的本地化名称（其中1代表星期一，2代表星期二，依此类推），该名称将作为独立文本使用，格式由type 指定。

如果区域设置信息未指定独立的星期名称，则返回值与dayName() 中的返回值相同。

另请参阅 dayName() 和standaloneMonthName()。

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

返回month 的本地化名称，该名称用作独立文本，格式由type 指定。

如果区域设置信息未指定独立的月份名称，则返回值与monthName() 中的返回值相同。

另请参见 monthName() 和standaloneDayName()。

[noexcept] void QLocale::swap(QLocale &other)

将当前区域设置与other 互换。此操作非常快速，且绝不会失败。

[static] QLocale QLocale::system()

返回一个初始化为系统区域设置的QLocale 对象。

系统区域设置可能会使用系统特有的区域设置数据源（如有可用）；否则，将回退到QLocale 中针对系统报告的语言、字符集和地区所提供的内置数据库条目。

例如，在 Windows 和 Mac 上，该区域设置将使用系统配置面板中指定的十进制/分组分隔符以及日期/时间格式。

另请参阅 c()。

[since 6.2] QLocale::Territory QLocale::territory() const

返回该区域设置的地域。

该函数在 Qt 6.2 中引入。

另请参阅 language()、script()、territoryToString() 以及bcp47Name()。

[static, since 6.2] QString QLocale::territoryToCode(QLocale::Territory territory)

返回territory 的两位字母地区代码，该代码符合 ISO 3166 标准。

该函数自 Qt 6.2 起引入。

另请参阅 codeToTerritory()、territory()、name()、bcp47Name()、languageToCode() 以及scriptToCode()。

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory territory)

返回一个QString ，其中包含territory 的名称。

该函数在 Qt 6.2 中引入。

另请参阅 languageToString()、scriptToString()、territory() 以及bcp47Name()。

Qt::LayoutDirection QLocale::textDirection() const

返回该语言的文本方向。

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

返回当前区域设置所使用的时间格式。

如果 `format ` 为 `LongFormat`，则格式为详细格式；否则为简短格式。例如，对于 `en_US ` 区域设置，`LongFormat ` 的结果为 `h:mm:ss AP t`，`ShortFormat ` 的结果为 `h:mm AP`。

另请参阅 QTime::toString() 和QTime::fromString()。

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

返回value 作为货币的本地化字符串表示形式。如果提供了symbol ，则使用该符号代替默认的货币符号。

另请参阅 currencySymbol()。

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

返回value 作为货币的本地化字符串表示形式。如果提供了symbol ，则使用该符号代替默认的货币符号。如果提供了precision ，则使用该参数来设置货币值的小数位数。

另请参阅 currencySymbol()。

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

将string 解析为符合特定区域设置的format 格式的日期。

解析string 并返回其所表示的日期。日期字符串的格式根据format 参数确定（参见dateFormat()）。

某些区域设置（特别是针对ShortFormat ）仅使用年份的最后两位数字。在这种情况下，将首先考虑以baseYear 为起点的100个年份。 在 6.7 版本之前，不存在baseYear 参数，系统始终使用 1900 年。这是baseYear 的默认行为，即从该年到 1999 年之间选择一年。在某些情况下，其他字段可能会导致选择下一个或上一个世纪，以确保结果与所有给定字段保持一致。详情请参阅QDate::fromString()。

如果无法解析日期，则返回一个无效日期。

另请参阅 dateFormat()、toTime()、toDateTime() 以及QDate::fromString()。

QDate QLocale::toDate(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

将string 解析为给定格式format 中的日期。

解析string 并返回其所代表的日期。关于format 的解释，请参阅QDate::fromString()。

当format 仅指定年份的后两位数字时，将首先考虑从baseYear 开始的 100 个年份作为候选值。 在 6.7 版本之前，不存在baseYear 参数，系统始终使用 1900 年。这是baseYear 的默认行为，即从该年到 1999 年之间选择一年。在某些情况下，其他字段可能会导致选择下一个或上一个世纪，以确保结果与所有给定字段保持一致。详情请参阅QDate::fromString()。

如果无法解析该日期，则返回一个无效日期。

另请参阅 dateFormat()、toTime()、toDateTime() 以及QDate::fromString()。

QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

将string 解析为符合特定区域设置的format 中的日期时间。

解析string 并返回其所表示的日期时间。日期字符串的格式根据format 参数确定（参见dateFormat()）。

某些区域设置（特别是针对ShortFormat ）仅使用年份的最后两位数字。在这种情况下，将首先考虑以baseYear 为起点的100年范围内的日期。 在 6.7 版本之前，不存在baseYear 参数，系统始终使用 1900 年。这是baseYear 的默认行为，即从该年选定一年直至 1999 年。在某些情况下，其他字段可能会导致选择下一个或上一个世纪，以确保结果与所有给定字段保持一致。详情请参阅QDate::fromString()。

如果无法解析该字符串，则返回一个无效的QDateTime 。

另请参阅 dateTimeFormat()、toTime()、toDate() 以及QDateTime::fromString()。

QDateTime QLocale::toDateTime(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

将string 解析为给定时区format 中的日期时间。

解析string 并返回其所表示的日期和时间。有关format 的解释，请参阅QDateTime::fromString()。

当format 仅指定年份的后两位数字时，将首先考虑从baseYear 开始的 100 个年份作为候选值。 在 6.7 版本之前，不存在baseYear 参数，系统始终使用 1900 年。这是baseYear 的默认值，用于从该年到 1999 年之间选择年份。在某些情况下，其他字段可能会导致选择下一个或上一个世纪，以确保结果与所有给定的字段保持一致。详情请参阅QDate::fromString()。

如果无法解析该字符串，则返回一个无效的QDateTime 。 如果字符串可以被解析，但表示一个无效的日期时间（例如处于时区转换时被跳过的间隙中），则返回的QDateTime 表示一个相邻的有效日期时间（通常与之相差有效日期时间中的间隙宽度，例如时区转换时被跳过的小时）。将该值传递给 fromMSecsSinceEpoch() 函数将生成一个有效的日期时间，该日期时间无法被解析出的字符串准确表示。

另请参阅 dateTimeFormat()、toTime()、toDate() 以及QDateTime::fromString()。

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

返回由本地化字符串s 所表示的double类型值。

如果转换发生溢出，则返回无穷大；如果因其他原因（例如下溢）导致转换失败，则返回 0.0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &ok);    // ok == true,  d == 1234.0

请注意，最后一次转换的结果为 1234.0，因为在德语区域设置中，'.' 是千位分隔符。

该函数会忽略首尾的空白字符。

另请参阅 toFloat()、toInt() 和toString()。

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

返回由本地化字符串“s ”所表示的 double 类型值。

如果转换发生溢出，则返回无穷大；如果因其他原因（例如下溢）导致转换失败，则返回 0.0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

d = german.toDouble("1.234", &ok);    // ok == true,  d == 1234.0

请注意，最后一次转换返回 1234.0，因为在德语区域设置中，'.' 是千位分隔符。

该函数会忽略首尾的空格。

另请参阅 toFloat()、toInt() 和toString()。

float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

返回由本地化字符串s 所表示的浮点数。

如果转换发生溢出，则返回无穷大；如果因其他原因（例如下溢）导致转换失败，则返回 0.0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

该函数会忽略首尾的空白字符。

另请参阅 toDouble()、toInt() 和toString()。

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

返回由本地化字符串s 所表示的浮点数。

如果转换发生溢出，则返回无穷大；如果因其他原因（例如下溢）导致转换失败，则返回 0.0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

该函数会忽略首尾的空白字符。