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 文字编码、
• 领土是大写、两个字母的 ISO 3166 领土代码（也可识别某些数字代码），以及
• 代码集和修饰符将被忽略。

分隔符可以是下划线'_' （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 字段）组合在一起，以便唯一地指定该语言、脚本和地域。请注意，如果统一码联盟的Likely Subtag Rules 在保留这些字段时暗示要省略这些字段，则可以省略这些字段。如果需要其他格式，请参阅name() 了解如何从单个字段构建字符串。

与uiLanguages() 不同的是，bcp47Name() 返回的值代表QLocale 数据的本地名称；它不必是用户界面应使用的语言。

该函数试图使本地名称符合 RFC 5646 中定义的 IETF 最佳通用实践 47。自 Qt 6.7 起，它支持一个可选的separator 参数，该参数可用于覆盖 BCP47 规定的使用连字符来分隔标记。不过，在 IETF 定义的协议中使用时，应保留默认值QLocale::TagSeparator::Dash 。

另请参阅 name(),language(),territory(),script() 和uiLanguages().

[static] 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 将考虑所有已知代码。代码按以下顺序匹配：ISO639Part1,ISO639Part2B,ISO639Part2T,ISO639Part3,LegacyLanguageCode 。

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

此函数在 Qt 6.3 中引入。

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

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

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

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

此函数在 Qt 6.1 中引入。

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

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

根据 ISO 3166 标准的定义，返回与两位字母或三位数字territoryCode 对应的QLocale::Territory 枚举。

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

此函数在 Qt 6.2 中引入。

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

QLocale QLocale::collation() const

返回校对时使用的本地语言。

结果通常是本 locale；但是，系统 locale（通常是默认 locale）将返回系统校对 locale。结果适合传递给QCollator 的构造函数。

另请参阅 QCollator 。

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

返回一个字符串，该字符串表示用 locale 定义的分隔符连接给定list 的字符串。

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

根据format 返回货币符号。

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

返回当前本地使用的日期格式。

如果format 是LongFormat ，格式将是详细的，否则将是简短的。例如，en_US locale 的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 locale 的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 指定。

例如，如果 locale 为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 起）以字符串形式返回，因为在某些语言中，它不是一个单独的字符，例如，它可能由乘号和 "十到幂 "运算符的表示形式组成。

另请参阅 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)

根据 ISO 639 标准的定义，返回language 的双字母或三字母语言代码。

如果指定，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)

返回包含language 名称的QString 。

另请参见 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 指定。

例如，如果 locale 为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 XML 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)

根据 ISO 15924 标准的定义，返回script 的四字母脚本代码。

此函数在 Qt 6.1 中引入。

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

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

返回包含script 名称的QString 。

另请参见 languageToString()、territoryToString()、script() 和bcp47Name()。

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

将全局默认 locale 设置为locale 。

当构建QLocale 对象且无参数时，将使用该语系。如果未调用此函数，则使用系统的 locale。

警告此函数不可重入。

另请参阅 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

按照type 指定的格式，返回作为独立文本使用的month 的本地化名称。

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

返回此 locale 的地域。

此函数在 Qt 6.2 中引入。

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

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

根据 ISO 3166 标准的定义，返回territory 的双字母地区代码。

此函数在 Qt 6.2 中引入。

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

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory 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 locale 的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

此函数重载 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 作为特定于本地的format 中的日期。

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

有些本地语言（尤其是ShortFormat ）只使用年份的最后两位数。在这种情况下，首先会考虑从baseYear 开始的 100 年。在 6.7 之前，没有baseYear 参数，总是使用 1900。这是baseYear 的默认设置，选择从 1900 年到 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 的默认设置，选择从 1900 年到 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 的默认设置，选择从 1900 年到 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 的默认设置，选择从 1900 年到 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(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