Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qlocale_tools_p.h
Go to the documentation of this file.
1// Copyright (C) 2021 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QLOCALE_TOOLS_P_H
5#define QLOCALE_TOOLS_P_H
6
7//
8// W A R N I N G
9// -------------
10//
11// This file is not part of the Qt API. It exists for the convenience
12// of internal files. This header file may change from version to version
13// without notice, or even be removed.
14//
15// We mean it.
16//
17
18#include "qlocale_p.h"
19#include "qstring.h"
20
21#if !defined(QT_SUPPORTS_INT128) && (defined(Q_CC_MSVC) && (_MSC_VER >= 1930) && __has_include(<__msvc_int128.hpp>))
22#include <__msvc_int128.hpp>
23#define QT_USE_MSVC_INT128
24#endif
25
27
28#if defined(QT_SUPPORTS_INT128)
29using qinternalint128 = qint128;
30using qinternaluint128 = quint128;
31#elif defined(QT_USE_MSVC_INT128)
32using qinternalint128 = std::_Signed128;
33using qinternaluint128 = std::_Unsigned128;
34#endif
35
41
42// API note: this function can't process a number with more than 2.1 billion digits
43[[nodiscard]] QSimpleParsedNumber<double>
44qt_asciiToDouble(const char *num, qsizetype numLen,
46void qt_doubleToAscii(double d, QLocaleData::DoubleForm form, int precision,
47 char *buf, qsizetype bufSize,
48 bool &sign, int &length, int &decpt);
49
50[[nodiscard]] QString qulltoBasicLatin(qulonglong l, int base, bool negative);
51[[nodiscard]] QString qulltoa(qulonglong l, int base, const QStringView zero);
52[[nodiscard]] char *qulltoa2(char *p, qulonglong n, int base);
53[[nodiscard]] Q_CORE_EXPORT QString qdtoa(qreal d, int *decpt, int *sign);
54[[nodiscard]] QString qdtoBasicLatin(double d, QLocaleData::DoubleForm form,
55 int precision, bool uppercase);
56[[nodiscard]] QByteArray qdtoAscii(double d, QLocaleData::DoubleForm form,
57 int precision, bool uppercase);
58
59#if defined(QT_SUPPORTS_INT128) || defined(QT_USE_MSVC_INT128)
60[[nodiscard]] Q_CORE_EXPORT QString quint128toBasicLatin(qinternaluint128 number,
61 int base = 10);
62[[nodiscard]] Q_CORE_EXPORT QString qint128toBasicLatin(qinternalint128 number,
63 int base = 10);
64#endif
65
66#if QT_VERSION < QT_VERSION_CHECK(6, 12, 0)
67[[deprecated("Use qIsNull(double) instead.")]]
68[[nodiscard]] constexpr inline bool isZero(double d)
69{
70 return qIsNull(d);
71}
72#endif
73
74// Enough space for the digits before the decimal separator:
75[[nodiscard]] inline int wholePartSpace(double d)
76{
77 Q_ASSERT(d >= 0); // caller should call qAbs() if needed
78 // Optimize for numbers between -512k and 512k - otherwise, use the
79 // maximum number of digits in the whole number part of a double:
80 return d > (1 << 19) ? std::numeric_limits<double>::max_exponent10 + 1 : 6;
81}
82
83// Returns code-point of same kind (UCS2 or UCS4) as zero; digit is 0 through 9
84template <typename UcsInt>
85[[nodiscard]] inline UcsInt unicodeForDigit(uint digit, UcsInt zero)
86{
87 // Must match qlocale.cpp's NumberTokenizer's digit-digestion.
88 Q_ASSERT(digit < 10);
89 if (!digit)
90 return zero;
91
92 // See QTBUG-85409: Suzhou's digits are U+3007, U+3021, ..., U+3029
93 if (zero == u'\u3007')
94 return u'\u3020' + digit;
95 // In util/locale_database/ldml.py, LocaleScanner.numericData() asserts no
96 // other number system in CLDR has discontinuous digits.
97
98 return zero + digit;
99}
100
101[[nodiscard]] Q_CORE_EXPORT double qstrntod(const char *s00, qsizetype len,
102 char const **se, bool *ok);
103[[nodiscard]] inline double qstrtod(const char *s00, char const **se, bool *ok)
104{
105 qsizetype len = qsizetype(strlen(s00));
106 return qstrntod(s00, len, se, ok);
107}
108
109[[nodiscard]] Q_AUTOTEST_EXPORT
110QSimpleParsedNumber<qlonglong> qstrntoll(const char *nptr, qsizetype size, int base);
111[[nodiscard]] QSimpleParsedNumber<qulonglong> qstrntoull(const char *nptr, qsizetype size, int base);
112
113QT_END_NAMESPACE
114
115#endif
\inmodule QtCore
QDataStream & operator>>(QDataStream &in, QByteArray &ba)
Reads a byte array into ba from the stream in and returns a reference to the stream.
quint16 qChecksum(QByteArrayView data, Qt::ChecksumType standard)
Definition qlist.h:80
static QLatin1StringView scriptToCode(QLocale::Script script)
Definition qlocale.cpp:254
QString toUpper(const QString &str, bool *ok) const
static const QLocalePrivate * get(const QLocale &l)
Definition qlocale_p.h:541
QString toLower(const QString &str, bool *ok) const
quint16 languageId() const
Definition qlocale_p.h:526
static QLocale::Language codeToLanguage(QStringView code, QLocale::LanguageCodeTypes codeTypes=QLocale::AnyLanguageCode) noexcept
Definition qlocale.cpp:109
const QLocaleData *const m_data
Definition qlocale_p.h:559
QLatin1StringView scriptCode() const
Definition qlocale_p.h:536
QLocale::MeasurementSystem measurementSystem() const
Definition qlocale.cpp:3556
quint16 territoryId() const
Definition qlocale_p.h:527
static QLatin1StringView territoryToCode(QLocale::Territory territory)
Definition qlocale.cpp:262
qsizetype m_index
Definition qlocale_p.h:561
static QLocale::Territory codeToTerritory(QStringView code) noexcept
Definition qlocale.cpp:210
static std::array< char, 4 > languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes=QLocale::AnyLanguageCode)
Definition qlocale.cpp:229
static QLocale::Script codeToScript(QStringView code) noexcept
Definition qlocale.cpp:204
QLocale::NumberOptions m_numberOptions
Definition qlocale_p.h:562
QLatin1StringView territoryCode() const
Definition qlocale_p.h:538
constexpr QLocalePrivate(const QLocaleData *data, qsizetype index, QLocale::NumberOptions numberOptions=QLocale::DefaultNumberOptions, int refs=0)
Definition qlocale_p.h:520
std::array< char, 4 > languageCode(QLocale::LanguageCodeTypes codeTypes=QLocale::AnyLanguageCode) const
Definition qlocale_p.h:532
static QBasicAtomicInt s_generation
Definition qlocale_p.h:564
QByteArray bcp47Name(char separator='-') const
Definition qlocale.cpp:489
QBasicAtomicInt ref
Definition qlocale_p.h:560
qsizetype fallbackLocaleIndex() const
Definition qlocale_p.h:568
@ StringToAlternateQuotation
Definition qlocale_p.h:162
@ DateTimeToStringShort
Definition qlocale_p.h:150
@ StandaloneMonthNameLong
Definition qlocale_p.h:168
@ ListToSeparatedString
Definition qlocale_p.h:164
@ StandaloneDayNameNarrow
Definition qlocale_p.h:173
@ StandaloneMonthNameNarrow
Definition qlocale_p.h:170
@ StringToStandardQuotation
Definition qlocale_p.h:161
@ StandaloneDayNameShort
Definition qlocale_p.h:172
@ StandaloneDayNameLong
Definition qlocale_p.h:171
@ StandaloneMonthNameShort
Definition qlocale_p.h:169
virtual QLocale fallbackLocale() const
virtual QVariant query(QueryType type, QVariant &&in=QVariant()) const
Combined button and popup list for selecting options.
constexpr char ascii_space_chars[]
Definition qlocale_p.h:71
constexpr auto makeCharacterSetMatch() noexcept
Definition qlocale_p.h:80
static constexpr bool isLowerCaseAscii(char c)
static const quint16 crc_tbl[16]
QByteArray qCompress(const uchar *data, qsizetype nbytes, int compressionLevel)
ZLibOp
@ Decompression
static Q_DECL_COLD_FUNCTION const char * zlibOpAsString(ZLibOp op)
static QByteArray toCase_template(T &input, uchar(*lookup)(uchar))
static void q_fromPercentEncoding(QByteArray *ba, char percent)
int qstrnicmp(const char *str1, qsizetype len1, const char *str2, qsizetype len2)
static qsizetype lastIndexOfHelper(const char *haystack, qsizetype l, const char *needle, qsizetype ol, qsizetype from)
static constexpr bool isUpperCaseAscii(char c)
static QByteArray xxflate(ZLibOp op, QArrayDataPointer< char > out, QByteArrayView input, qxp::function_ref< int(z_stream *) const > init, qxp::function_ref< int(z_stream *, size_t) const > processChunk, qxp::function_ref< void(z_stream *) const > deinit)
static constexpr uchar asciiLower(uchar c)
static qsizetype countCharHelper(QByteArrayView haystack, char needle) noexcept
static constexpr uchar asciiUpper(uchar c)
Q_CORE_EXPORT char * qstrncpy(char *dst, const char *src, size_t len)
Q_CORE_EXPORT int qstrnicmp(const char *, const char *, size_t len)
Q_CORE_EXPORT int qstricmp(const char *, const char *)
Q_CORE_EXPORT char * qstrdup(const char *)
Q_CORE_EXPORT char * qstrcpy(char *dst, const char *src)
Q_DECL_PURE_FUNCTION Q_CORE_EXPORT const void * qmemrchr(const void *s, int needle, size_t n) noexcept
Q_CORE_EXPORT int qstrcmp(const char *str1, const char *str2)
#define __has_include(x)
#define __has_feature(x)
bool qt_splitLocaleName(QStringView name, QStringView *lang=nullptr, QStringView *script=nullptr, QStringView *cntry=nullptr) noexcept
Definition qlocale.cpp:649
Q_DECLARE_TYPEINFO(QLocaleData::GroupSizes, Q_PRIMITIVE_TYPE)
Q_DECLARE_TYPEINFO(QLocaleId, Q_PRIMITIVE_TYPE)
qsizetype qt_repeatCount(QStringView s) noexcept
Definition qlocale.cpp:762
constexpr bool ascii_isspace(uchar c) noexcept
Definition qlocale_p.h:587
#define ForEachQLocaleRange(X)
Definition qlocale_p.h:471
QString qt_readEscapedFormatString(QStringView format, qsizetype *idx)
Definition qlocale.cpp:712
StrayCharacterMode
@ TrailingJunkAllowed
@ TrailingJunkProhibited
@ WhitespacesAllowed
Q_CORE_EXPORT double qstrntod(const char *s00, qsizetype len, char const **se, bool *ok)
double qstrtod(const char *s00, char const **se, bool *ok)
QSimpleParsedNumber< double > qt_asciiToDouble(const char *num, qsizetype numLen, StrayCharacterMode strayCharMode=TrailingJunkProhibited)
QByteArray qdtoAscii(double d, QLocaleData::DoubleForm form, int precision, bool uppercase)
char * qulltoa2(char *p, qulonglong n, int base)
int wholePartSpace(double d)
QString qdtoBasicLatin(double d, QLocaleData::DoubleForm form, int precision, bool uppercase)
UcsInt unicodeForDigit(uint digit, UcsInt zero)
QString qulltoa(qulonglong l, int base, const QStringView zero)
QSimpleParsedNumber< qulonglong > qstrntoull(const char *nptr, qsizetype size, int base)
void qt_doubleToAscii(double d, QLocaleData::DoubleForm form, int precision, char *buf, qsizetype bufSize, bool &sign, int &length, int &decpt)
QString qulltoBasicLatin(qulonglong l, int base, bool negative)
constexpr size_t qHash(const QSize &s, size_t seed=0) noexcept
Definition qsize.h:191
CharBuff buff
Definition qlocale_p.h:239
static constexpr int MaxRange
Definition qlocale_p.h:49
constexpr bool matches(uchar c) const noexcept
Definition qlocale_p.h:61
constexpr QCharacterSetMatch(std::string_view set) noexcept
Definition qlocale_p.h:52
QStringView viewListEntry(const char16_t *table, qsizetype index) const
Definition qlocale_p.h:429
char32_t ucsFirst(const char16_t *table) const
Definition qlocale_p.h:433
QString getData(const char16_t *table) const
Definition qlocale_p.h:415
QString getListEntry(const char16_t *table, qsizetype index) const
Definition qlocale_p.h:425
QStringView viewData(const char16_t *table) const
Definition qlocale_p.h:421
void setZero(QStringView zero)
Definition qlocale_p.h:355
bool isValid(NumberMode mode) const
Definition qlocale_p.h:375
QString positiveSign() const
Definition qlocale.cpp:1110
static float convertDoubleToFloat(double d, bool *ok)
Definition qlocale_p.h:319
QString groupSeparator() const
Definition qlocale.cpp:1069
QSimpleParsedNumber< qint64 > stringToLongLong(QStringView str, int base, QLocale::NumberOptions options) const
Definition qlocale.cpp:4831
char32_t zeroUcs() const
Definition qlocale.cpp:1089
quint8 m_grouping_least
Definition qlocale_p.h:512
QString zeroDigit() const
Definition qlocale.cpp:1084
bool numberToCLocale(QStringView s, QLocale::NumberOptions number_options, NumberMode mode, CharBuff *result) const
Definition qlocale.cpp:4609
quint8 m_grouping_higher
Definition qlocale_p.h:511
QString decimalPoint() const
Definition qlocale.cpp:1064
QString doubleToString(double d, int precision=-1, DoubleForm form=DFSignificantDigits, int width=-1, unsigned flags=NoFlags) const
Definition qlocale.cpp:4056
static Q_AUTOTEST_EXPORT bool allLocaleDataRows(bool(*check)(qsizetype, const QLocaleData &))
Definition qlocale.cpp:519
quint8 m_weekend_start
Definition qlocale_p.h:508
quint8 m_currency_digits
Definition qlocale_p.h:505
QLocaleId id() const
Definition qlocale_p.h:396
QString listSeparator() const
Definition qlocale.cpp:1079
static QSimpleParsedNumber< quint64 > bytearrayToUnsLongLong(QByteArrayView num, int base)
Definition qlocale.cpp:4878
QString percentSign() const
Definition qlocale.cpp:1074
@ BlankBeforePositive
Definition qlocale_p.h:264
@ AddTrailingZeroes
Definition qlocale_p.h:261
double stringToDouble(QStringView str, bool *ok, QLocale::NumberOptions options) const
Definition qlocale.cpp:4815
QString longLongToString(qint64 l, int precision=-1, int base=10, int width=-1, unsigned flags=NoFlags) const
Definition qlocale.cpp:4297
@ DoubleScientificMode
Definition qlocale_p.h:275
@ DoubleStandardMode
Definition qlocale_p.h:275
@ DFSignificantDigits
Definition qlocale_p.h:255
quint8 m_first_day_of_week
Definition qlocale_p.h:507
quint8 m_weekend_end
Definition qlocale_p.h:509
NumericData numericData(NumberMode mode) const
Definition qlocale.cpp:4382
quint8 m_currency_rounding
Definition qlocale_p.h:506
QString exponentSeparator() const
Definition qlocale.cpp:1115
static qsizetype findLocaleIndex(QLocaleId localeId) noexcept
Definition qlocale.cpp:579
QString negativeSign() const
Definition qlocale.cpp:1105
static const QLocaleData * c() noexcept
Definition qlocale.cpp:953
QSimpleParsedNumber< quint64 > stringToUnsLongLong(QStringView str, int base, QLocale::NumberOptions options) const
Definition qlocale.cpp:4842
QString unsLongLongToString(quint64 l, int precision=-1, int base=10, int width=-1, unsigned flags=NoFlags) const
Definition qlocale.cpp:4312
quint8 m_grouping_first
Definition qlocale_p.h:510
QLocaleId withLikelySubtagsAdded() const noexcept
Fill in blank fields of a locale ID.
Definition qlocale.cpp:321
QLocaleId withLikelySubtagsRemoved() const noexcept
Definition qlocale.cpp:410
ushort script_id
Definition qlocale_p.h:223
bool operator==(QLocaleId other) const noexcept
Definition qlocale_p.h:192
bool matchesAll() const noexcept
Definition qlocale_p.h:201
bool isValid() const noexcept
Definition qlocale_p.h:196
bool operator!=(QLocaleId other) const noexcept
Definition qlocale_p.h:194
bool acceptScriptTerritory(QLocaleId other) const noexcept
Definition qlocale_p.h:212
ushort territory_id
Definition qlocale_p.h:223
bool acceptLanguage(quint16 lang) const noexcept
Definition qlocale_p.h:206
QByteArray name(char separator='-') const
Definition qlocale.cpp:434
ushort language_id
Definition qlocale_p.h:223
CurrencyToStringArgument(const QVariant &v, const QString &s)
Definition qlocale_p.h:119