QLocale 类

成员函数文档

QLocale::QLocale()

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

如果没有使用 setDefault() 设置默认区域，则此区域将与由 system() 返回的区域相同。

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

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

这是一个重载函数。

[自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() 以及 匹配语言、脚本和地区组合。

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

为指定的 language 和 territory 构造一个 QLocale 对象。

如果此组合使用多个脚本，则选择可能的脚本。如果 QLocale 没有指定 language 的相关数据，则使用默认区域设置。如果 QLocale 没有指定 language 和 territory 的组合数据，可以考虑使用替代地区。

有关内容setDefault() 以及 匹配语言、脚本和地区组合。

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

为指定的 language、script 和 territory 构造一个 QLocale 对象。

如果 QLocale 没有给定组合的数据，它将找到尽可能好的匹配数据。如果 language 是 AnyLanguage 且无法从 script 和 territory 中推断出语言，或者 QLocale 没有给定语言的任何数据（无论是 language 还是如上所述推断出的），则回退到默认区域设置。

• language 是 AnyLanguage 且无法从 script 和 territory 中推断出任何语言。
• QLocale 没有给定语言的相关数据，无论是作为 language 还是如上所述推断出的。

有关内容setDefault() 以及 匹配语言、脚本和地区组合。

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

将其他对象的副本作为 QLocale 对象构建。

[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 数据的区域名称；这不必是用户界面应使用的语言。

此函数尝试使区域名称符合 IETF 最高常用实践 47（由 RFC 5646 定义）。从 Qt 6.7 开始，它支持可选的 separator 参数，可用于覆盖 BCP47 指定的使用连字符来分隔标记。但是，在使用 IETF 定义的协议时，应保留默认值 QLocale::TagSeparator::Dash。

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

[静态] QLocale QLocale::c()

返回一个初始化为 "C" 区域的 QLocale 对象。

此区域以 en_US 为基础，但具有各种独特的怪癖，例如简化的数字格式和自己的日期格式。它实现了描述 "C" 编程语言标准库函数行为的 POSIX 标准。

这包括其排序列是基于字母的 ASCII 值，因此对于区分大小写的排序，所有大写字母都排在任何小写字母之前（而不是每个字母的大小写形式相邻，然后是下一个字母的两个形式）。

另请参阅 system()。

[静态 noexcept，自 6.3 以来] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

返回与 ISO 639 标准中定义的两位或三位 languageCode 对应的 QLocale::Language 枚举。

如果有指定，codeTypes 选择要考虑的代码集。默认情况下，Qt 所知的所有代码都予以考虑。代码按以下顺序匹配：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对应的QLocale::Territory枚举，该枚举由ISO 3166标准定义。

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

此函数从Qt 6.2开始引入。

另请参阅territoryToCode()，codeToLanguage()，以及codeToScript()。

QLocale QLocale::collation() const

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

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

另请参阅QCollator。

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

返回表示以区域设置定义的 separator 连接一个给定的list字符串的字符串。

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

根据指定的format返回货币符号。

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

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

如果format是LongFormat，则格式将是详尽的，否则将是简短的。例如，对于LongFormat的en_US区域设置，格式是dddd, MMMM d, yyyy，而对于ShortFormat，格式是M/d/yy。

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

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

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

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

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

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

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

例如，如果区域设置是 en_US 并且 day 是 1，则 长格式 返回 Monday，短格式 是 Mon，而 窄格式 是 M。

另请参阅 monthName() 和 standaloneDayName。

QString QLocale::decimalPoint() const

返回本地的分数部分分隔符。

这是在表示具有小数部分的数量时，将整数部分从小数部分隔开的标记。这通常被称为“小数点字符”——尽管在许多区域设置中，它不是一个“点”或类似的点。自 Qt 6.0 以来，作为一个字符串返回，因为某些区域设置可能需要超过一个 UTF-16 代码点来表示其分隔符。

另请参阅 groupSeparator() 和 toString。

QString QLocale::exponential() const

返回本地的指数分隔符。

这是在某种浮点数表示中用作将尾数与指数分隔的标记。自 Qt 6.0 以来，作为一个字符串返回，因为，在某些区域设置中，它可能不是单个字符——例如，它可能包括一个乘号和“十的幂”运算符的表示。

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

Qt::DayOfWeek QLocale::firstDayOfWeek() const

返回当前区域设置的星期第一天。

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

将字节数转换成一个人可读的本地化字符串，包含一个数字和量化单位。量化单位的选择使得数字至少为一，尽量小。例如，如果字节数为16384，精度为2，且格式为DataSizeIecFormat（默认），则该函数返回"16.00 KiB"；对于1330409069609字节，它返回"1.21 GiB"；等等。如果格式为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()。

[静态，自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()。

[静态] QString QLocale::languageToString(QLocale::Language language)

返回包含language名称的QString。

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

[静态] 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。

例如，如果区域是 en_US 并且 month 是 1，则 LongFormat 将返回 January。 ShortFormat Jan 并且NarrowFormat J。

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

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

此区域设置的简称。

返回表示语言和区域设置的字符串 "language_territory"，其中语言是 ISO 639 的两个小写字母语言代码，区域设置是 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().

[自 6.2 版起] QString QLocale::nativeTerritoryName() const

返回.locale 为地区提供的本地名称。例如，对于西班牙/西班牙地区的本地，返回 "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。

[自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()。

[静态，自6.1版本起] QString QLocale::scriptToCode(QLocale::Script script)

返回按ISO 15924标准定义的四个字母脚本代码。

此函数从Qt 6.1开始引入。

另请参阅script()，name()，bcp47Name()，languageToCode()和territoryToCode()。

[静态] QString QLocale::scriptToString(QLocale::Script script)

返回包含script名称的QString。

另请参阅languageToString()，territoryToString()，script()和bcp47Name()。

[静态] 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

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

如果区域信息未指定独立的日子名称，则返回值与dayName()相同。

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

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

返回作为独立文本使用的月份的本地化名称，格式由类型指定。

如果区域信息未指定独立月份名称，则返回值与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)

返回领土的两字母领土代码，根据ISO 3166标准定义。

此函数从Qt 6.2开始引入。

另请参阅codeToTerritory()，territory()，name()，bcp47Name()，languageToCode()和scriptToCode().

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

返回一个包含领土名称的QString。

此函数从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(qulonglong value, const QString &symbol = QString()) const

这是一个重载函数。

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

这是一个重载函数。

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

这是一个重载函数。

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

这是一个重载函数。

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

这是一个重载函数。

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

此函数是 toCurrencyString() 的重载。

返回 value 作为货币的本地化字符串表示形式。如果提供了 symbol，则使用它代替默认的货币符号。如果提供了 precision，则用于设置货币值的精度。

另请参阅currencySymbol。

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

此函数是 toCurrencyString() 的重载。

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

将 string 作为特定区域设置中的日期读取。

解析 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, const QString &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

将字符串作为特定区域设置的格式的日期时间来读取。

解析字符串并返回它所表示的日期时间。日期字符串的格式根据格式参数选择（参阅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

将字符串作为给定格式的日期时间来读取。

解析字符串并返回它所表示的日期时间。有关对格式的解析，请参阅QDateTime::fromString。

当 format 只指定年份的最后两位时，以 baseYear 开始的100年是首先考虑的候选年份。在6.7版本之前，没有 baseYear 参数，始终使用1900年。这是 baseYear 的默认值，从那时到1999年选择年份数值。在某些情况下，其他字段可能导致选择下一个或前一个世纪，以达到所有字段给定的一致结果。关于详细信息，请参阅 QDate::fromString。

如果字符串无法解析，则返回无效的QDateTime。如果字符串可以解析并且表示的日期时间无效（例如，由时区转换跳过的间隙中的日期时间），则返回一个无效的QDateTime，其toMSecsSinceEpoch()表示一个有效的附近日期时间。通过将该值传递给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(const QString &s, bool *ok = nullptr) const

返回由本地化字符串s表示的double。

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

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">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。

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

返回由本地化字符串s表示的double。

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

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">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。

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

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

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

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toDouble(), toInt(), 和 toString.

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

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

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

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toDouble(), toInt(), 和 toString.

int QLocale::toInt(const QString &s, bool *ok = nullptr) const

返回本地化字符串 s 表示的整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toUInt() 和 toString.

int QLocale::toInt(QStringView s, bool *ok = nullptr) const

返回本地化字符串 s 表示的整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toUInt() 和 toString.

long QLocale::toLong(const QString &s, bool *ok = nullptr) const

返回本地化字符串 s 表示的长整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toInt(), toULong(), toDouble(), 和 toString.

long QLocale::toLong(QStringView s, bool *ok = nullptr) const

返回本地化字符串 s 表示的长整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toInt(), toULong(), toDouble(), 和 toString.

qlonglong QLocale::toLongLong(const QString &s, bool *ok = nullptr) const

返回本地化字符串 s 表示的长长整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toInt(), toULongLong(), toDouble(), 和 toString.

qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

返回本地化字符串 s 表示的长长整数值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toInt(), toULongLong(), toDouble(), 和 toString.

QString QLocale::toLower(const QString &str) const

返回 str 的小写副本。

如果 Qt Core 使用 ICU 库，则会使用它们根据当前区域设置规则执行转换。否则，转换将以平台依赖的方式执行，并以 QString::toLower() 作为通用回退。

另请参阅 QString::toLower.

short QLocale::toShort(const QString &s, bool *ok = nullptr) const

返回本地化字符串 s 表示的 short int 值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toUShort() 和 toString.

short QLocale::toShort(QStringView s, bool *ok = nullptr) const

返回本地化字符串 s 表示的 short int 值。

如果转换失败，则函数返回 0。

如果ok不是nullptr，则通过将*i translate="no">ok设置为false来报告失败，并通过将*i translate="no">ok设置为true来报告成功。

此函数忽略前导和尾随空白。

另请参阅 toUShort() 和 toString.

QString QLocale::toString(qlonglong i) const

返回一个本地化的字符串表示的 i。

另请参阅toLongLong()、numberOptions()、zeroDigit() 和 positiveSign().

QString QLocale::toString(qulonglong i) const

这是一个重载函数。

另请参阅toULongLong()、numberOptions()、zeroDigit() 和 positiveSign().

QString QLocale::toString(long i) const