AuroraMiddleware/qt5base-lts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Remove references to to/fromAscii in QString and QByteArray main docs

Browse Source 
Those functions are about to be deprecated and shouldn't be referred
to in the main documentation. Since they were temporarily changed to
mean UTF-8, this is not a behaviour change.

The next commit will update the code to match the documentation.

Change-Id: Ia8c2843c7f2b478f5691fe0224d5e631d94b1af6
Reviewed-by: Casper van Donderen <casper.vandonderen@nokia.com>
Reviewed-by: Lars Knoll <lars.knoll@nokia.com>
This commit is contained in:
Thiago Macieira 2012-05-02 12:55:49 +02:00 committed by Qt by Nokia
parent d9f4b130aa
commit 9c75a547a0
5 changed files with 125 additions and 139 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/corelib/doc/snippets/qstring/main.cpp
View File

@ -765,7 +765,7 @@ void Widget::sprintfFunction()
char buf[BufSize];
::snprintf(buf, BufSize, "%lld", 123456789LL);
QString str = QString::fromAscii(buf);
QString str = QString::fromUtf8(buf);
//! [63]
//! [64]

2
src/corelib/kernel/qvariant.cpp
View File

@ -1969,7 +1969,7 @@ QEasingCurve QVariant::toEasingCurve() const
\fn QByteArray QVariant::toByteArray() const
Returns the variant as a QByteArray if the variant has type() \l
ByteArray or \l String (converted using QString::fromAscii());
ByteArray or \l String (converted using QString::fromUtf8());
otherwise returns an empty byte array.
\sa canConvert(), convert()

114
src/corelib/tools/qbytearray.cpp
View File

@ -1249,12 +1249,12 @@ void QByteArray::chop(int n)
Appends the string \a str onto the end of this byte array and
returns a reference to this byte array. The Unicode data is
converted into 8-bit characters using QString::toAscii().
converted into 8-bit characters using QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
operator can lead to loss of information. You can disable this
operator by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
*/
@ -1613,12 +1613,12 @@ QByteArray &QByteArray::append(const QByteArray &ba)
\overload
Appends the string \a str to this byte array. The Unicode data is
converted into 8-bit characters using QString::toAscii().
converted into 8-bit characters using QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
*/
@ -1729,17 +1729,15 @@ QByteArray &QByteArray::insert(int i, const QByteArray &ba)
Inserts the string \a str at index position \a i in the byte
array. The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
If \a i is greater than size(), the array is first extended using
resize().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
You can disable this function by defining \c QT_NO_CAST_TO_ASCII when you
compile your applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toLocal8Bit()) explicitly if you want to
convert the data to \c{const char *}.
*/
/*!
@ -2053,14 +2051,12 @@ QByteArray &QByteArray::replace(const char *before, int bsize, const char *after
Replaces every occurrence of the string \a before with the byte
array \a after. The Unicode data is converted into 8-bit
characters using QString::toAscii().
characters using QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
You can disable this function by defining \c QT_NO_CAST_TO_ASCII when you
compile your applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toLocal8Bit()) explicitly if you want to
convert the data to \c{const char *}.
*/
/*! \fn QByteArray &QByteArray::replace(const QString &before, const char *after)
@ -2098,12 +2094,12 @@ QByteArray &QByteArray::replace(char before, const QByteArray &after)
Replaces every occurrence of the character \a before with the
string \a after. The Unicode data is converted into 8-bit
characters using QString::toAscii().
characters using QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
*/
@ -2244,14 +2240,12 @@ int QByteArray::indexOf(const QByteArray &ba, int from) const
\a from. Returns -1 if \a str could not be found.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
You can disable this function by defining \c QT_NO_CAST_TO_ASCII when you
compile your applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toLocal8Bit()) explicitly if you want to
convert the data to \c{const char *}.
*/
/*! \fn int QByteArray::indexOf(const char *str, int from) const
@ -2371,14 +2365,12 @@ int QByteArray::lastIndexOf(const QByteArray &ba, int from) const
last (size() - 1) byte. Returns -1 if \a str could not be found.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
If the QString contains non-ASCII Unicode characters, using this
function can lead to loss of information. You can disable this
function by defining \c QT_NO_CAST_TO_ASCII when you compile your
applications. You then need to call QString::toAscii() (or
QString::toLatin1() or QString::toUtf8() or QString::toLocal8Bit())
explicitly if you want to convert the data to \c{const char *}.
You can disable this function by defining \c QT_NO_CAST_TO_ASCII when you
compile your applications. You then need to call QString::toUtf8() (or
QString::toLatin1() or QString::toLocal8Bit()) explicitly if you want to
convert the data to \c{const char *}.
*/
/*! \fn int QByteArray::lastIndexOf(const char *str, int from) const
@ -2772,16 +2764,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool QByteArray::operator!=(const QString &str) const
@ -2790,16 +2781,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool QByteArray::operator<(const QString &str) const
@ -2808,16 +2798,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
str; otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool QByteArray::operator>(const QString &str) const
@ -2826,16 +2815,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
\a str; otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool QByteArray::operator<=(const QString &str) const
@ -2844,16 +2832,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
to string \a str; otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool QByteArray::operator>=(const QString &str) const
@ -2862,16 +2849,15 @@ QDataStream &operator>>(QDataStream &in, QByteArray &ba)
\a str; otherwise returns false.
The Unicode data is converted into 8-bit characters using
QString::toAscii().
QString::toUtf8().
The comparison is case sensitive.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. You
then need to call QString::fromAscii(), QString::fromLatin1(),
QString::fromUtf8(), or QString::fromLocal8Bit() explicitly if
you want to convert the byte array to a QString before doing the
comparison.
then need to call QString::fromUtf8(), QString::fromLatin1(),
or QString::fromLocal8Bit() explicitly if you want to convert the byte
array to a QString before doing the comparison.
*/
/*! \fn bool operator==(const QByteArray &a1, const QByteArray &a2)

8
src/corelib/tools/qchar.cpp
View File

@ -151,9 +151,9 @@ QT_BEGIN_NAMESPACE
to convert to and from traditional 8-bit \c{char}s. If you
defined \c QT_NO_CAST_FROM_ASCII and \c QT_NO_CAST_TO_ASCII, as
explained in the QString documentation, you will need to
explicitly call fromAscii() or fromLatin1(), or use QLatin1Char,
explicitly call fromLatin1(), or use QLatin1Char,
to construct a QChar from an 8-bit \c char, and you will need to
call toAscii() or toLatin1() to get the 8-bit value back.
call toLatin1() to get the 8-bit value back.
For more information see
\l{http://www.unicode.org/ucd/}{"About the Unicode Character Database"}.
@ -1251,7 +1251,7 @@ ushort QChar::toCaseFolded(ushort ucs2)
\note It is not possible to distinguish a non-Latin-1 character from a Latin-1 0
(NUL) character. Prefer to use unicode(), which does not have this ambiguity.
\sa toAscii(), unicode()
\sa unicode()
*/
/*!
@ -1262,7 +1262,7 @@ ushort QChar::toCaseFolded(ushort ucs2)
An alternative is to use QLatin1Char.
\sa fromAscii(), unicode()
\sa toLatin1(), unicode()
*/
/*!

138
src/corelib/tools/qstring.cpp
View File

@ -470,13 +470,12 @@ const QString::Null QString::null = { };
\snippet qstring/main.cpp 0
QString converts the \c{const char *} data into Unicode using the
fromAscii() function. fromAscii() treats ordinals above 128 as Latin-1
characters.
fromUtf8() function.
In all of the QString functions that take \c{const char *}
parameters, the \c{const char *} is interpreted as a classic
C-style '\\0'-terminated string. It is legal for the \c{const char
*} parameter to be 0.
C-style '\\0'-terminated string encoded in UTF-8. It is legal for
the \c{const char *} parameter to be 0.
You can also provide string data as an array of \l{QChar}s:
@ -604,12 +603,11 @@ const QString::Null QString::null = { };
\section1 Converting Between 8-Bit Strings and Unicode Strings
QString provides the following four functions that return a
\c{const char *} version of the string as QByteArray: toAscii(),
toLatin1(), toUtf8(), and toLocal8Bit().
QString provides the following three functions that return a
\c{const char *} version of the string as QByteArray: toUtf8(),
toLatin1(), and toLocal8Bit().
\list
\li toAscii() returns a Latin-1 (ISO 8859-1) encoded 8-bit string.
\li toLatin1() returns a Latin-1 (ISO 8859-1) encoded 8-bit string.
\li toUtf8() returns a UTF-8 encoded 8-bit string. UTF-8 is a
superset of US-ASCII (ANSI X3.4-1986) that supports the entire
@ -619,7 +617,7 @@ const QString::Null QString::null = { };
\endlist
To convert from one of these encodings, QString provides
fromAscii(), fromLatin1(), fromUtf8(), and fromLocal8Bit(). Other
fromLatin1(), fromUtf8(), and fromLocal8Bit(). Other
encodings are supported through the QTextCodec class.
As mentioned above, QString provides a lot of functions and
@ -644,14 +642,14 @@ const QString::Null QString::null = { };
\snippet code/src_corelib_tools_qstring.cpp 0
You then need to explicitly call fromAscii(), fromLatin1(),
fromUtf8(), or fromLocal8Bit() to construct a QString from an
You then need to explicitly call fromUtf8(), fromLatin1(),
or fromLocal8Bit() to construct a QString from an
8-bit string, or use the lightweight QLatin1String class, for
example:
\snippet code/src_corelib_tools_qstring.cpp 1
Similarly, you must call toAscii(), toLatin1(), toUtf8(), or
Similarly, you must call toLatin1(), toUtf8(), or
toLocal8Bit() explicitly to convert the QString to an 8-bit
string. (Other encodings are supported through the QTextCodec
class.)
@ -688,7 +686,7 @@ const QString::Null QString::null = { };
\snippet qstring/main.cpp 8
All functions except isNull() treat null strings the same as empty
strings. For example, toAscii().constData() returns a pointer to a
strings. For example, toUtf8().constData() returns a pointer to a
'\\0' character for a null string (\e not a null pointer), and
QString() compares equal to QString(""). We recommend that you
always use the isEmpty() function and avoid isNull().
@ -916,25 +914,25 @@ const QStaticStringData<1> QString::shared_empty = { Q_STATIC_STRING_DATA_HEADER
Constructs a string initialized with the 8-bit string \a str. The
given const char pointer is converted to Unicode using the
fromAscii() function.
fromUtf8() function.
You can disable this constructor by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
can be useful if you want to ensure that all user-visible strings
go through QObject::tr(), for example.
\sa fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()
\sa fromLatin1(), fromLocal8Bit(), fromUtf8()
*/
/*! \fn QString QString::fromStdString(const std::string &str)
Returns a copy of the \a str string. The given string is converted
to Unicode using the fromAscii() function.
to Unicode using the fromUtf8() function.
This constructor is only available if Qt is configured with STL
compatibility enabled.
\sa fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()
\sa fromLatin1(), fromLocal8Bit(), fromUtf8()
*/
/*! \fn QString QString::fromStdWString(const std::wstring &str)
@ -969,7 +967,7 @@ const QStaticStringData<1> QString::shared_empty = { Q_STATIC_STRING_DATA_HEADER
This operator is mostly useful to pass a QString to a function
that accepts a std::wstring object.
\sa utf16(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit()
\sa utf16(), toLatin1(), toUtf8(), toLocal8Bit()
*/
// ### replace with QCharIterator
@ -1002,11 +1000,11 @@ int QString::toUcs4_helper(const ushort *uc, int length, uint *out)
hold the complete string (allocating the array with the same length as the
string is always sufficient).
returns the actual length of the string in \a array.
This function returns the actual length of the string in \a array.
\note This function does not append a null character to the array.
\sa utf16(), toUcs4(), toAscii(), toLatin1(), toUtf8(), toLocal8Bit(), toStdWString()
\sa utf16(), toUcs4(), toLatin1(), toUtf8(), toLocal8Bit(), toStdWString()
*/
/*! \fn QString::QString(const QString &other)
@ -1133,7 +1131,7 @@ QString::QString(QChar ch)
/*! \fn QString::QString(const QByteArray &ba)
Constructs a string initialized with the byte array \a ba. The
given byte array is converted to Unicode using fromAscii(). Stops
given byte array is converted to Unicode using fromUtf8(). Stops
copying at the first 0 character, otherwise copies the entire byte
array.
@ -1142,7 +1140,7 @@ QString::QString(QChar ch)
can be useful if you want to ensure that all user-visible strings
go through QObject::tr(), for example.
\sa fromAscii(), fromLatin1(), fromLocal8Bit(), fromUtf8()
\sa fromLatin1(), fromLocal8Bit(), fromUtf8()
*/
/*! \fn QString::QString(const Null &)
@ -1369,7 +1367,7 @@ QString &QString::operator=(const QString &other)
\overload operator=()
Assigns \a ba to this string. The byte array is converted to Unicode
using the fromAscii() function. This function stops conversion at the
using the fromUtf8() function. This function stops conversion at the
first NUL character found, or the end of the \a ba byte array.
You can disable this operator by defining \c
@ -1383,7 +1381,7 @@ QString &QString::operator=(const QString &other)
\overload operator=()
Assigns \a str to this string. The const char pointer is converted
to Unicode using the fromAscii() function.
to Unicode using the fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -1395,8 +1393,9 @@ QString &QString::operator=(const QString &other)
\overload operator=()
Assigns character \a ch to this string. The character is converted
to Unicode using the fromAscii() function.
Assigns character \a ch to this string. Note that the character is
converted to Unicode using the fromLatin1() function, unlike other 8-bit
functions that operate on UTF-8 data.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -1560,7 +1559,7 @@ QString &QString::append(const QLatin1String &str)
\overload append()
Appends the byte array \a ba to this string. The given byte array
is converted to Unicode using the fromAscii() function.
is converted to Unicode using the fromUtf8() function.
You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -1573,7 +1572,7 @@ QString &QString::append(const QLatin1String &str)
\overload append()
Appends the string \a str to this string. The given const char
pointer is converted to Unicode using the fromAscii() function.
pointer is converted to Unicode using the fromUtf8() function.
You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -1619,7 +1618,7 @@ QString &QString::append(QChar ch)
\overload prepend()
Prepends the byte array \a ba to this string. The byte array is
converted to Unicode using the fromAscii() function.
converted to Unicode using the fromUtf8() function.
You can disable this function by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -1632,7 +1631,7 @@ QString &QString::append(QChar ch)
\overload prepend()
Prepends the string \a str to this string. The const char pointer
is converted to Unicode using the fromAscii() function.
is converted to Unicode using the fromUtf8() function.
You can disable this function by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -2179,7 +2178,7 @@ bool QString::operator==(const QLatin1String &other) const
\overload operator==()
The \a other byte array is converted to a QString using the
fromAscii() function. This function stops conversion at the
fromUtf8() function. This function stops conversion at the
first NUL character found, or the end of the byte array.
You can disable this operator by defining \c
@ -2193,7 +2192,7 @@ bool QString::operator==(const QLatin1String &other) const
\overload operator==()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -2242,7 +2241,7 @@ bool QString::operator<(const QLatin1String &other) const
\overload operator<()
The \a other byte array is converted to a QString using the
fromAscii() function. If any NUL characters ('\\0') are embedded
fromUtf8() function. If any NUL characters ('\\0') are embedded
in the byte array, they will be included in the transformation.
You can disable this operator by defining \c
@ -2256,7 +2255,7 @@ bool QString::operator<(const QLatin1String &other) const
\overload operator<()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -2285,7 +2284,7 @@ bool QString::operator<(const QLatin1String &other) const
\overload operator<=()
The \a other byte array is converted to a QString using the
fromAscii() function. If any NUL characters ('\\0') are embedded
fromUtf8() function. If any NUL characters ('\\0') are embedded
in the byte array, they will be included in the transformation.
You can disable this operator by defining \c
@ -2299,7 +2298,7 @@ bool QString::operator<(const QLatin1String &other) const
\overload operator<=()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -2344,7 +2343,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator>()
The \a other byte array is converted to a QString using the
fromAscii() function. If any NUL characters ('\\0') are embedded
fromUtf8() function. If any NUL characters ('\\0') are embedded
in the byte array, they will be included in the transformation.
You can disable this operator by defining \c
@ -2358,7 +2357,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator>()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -2388,7 +2387,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator>=()
The \a other byte array is converted to a QString using the
fromAscii() function. If any NUL characters ('\\0') are embedded in
fromUtf8() function. If any NUL characters ('\\0') are embedded in
the byte array, they will be included in the transformation.
You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
@ -2402,7 +2401,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator>=()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -2432,7 +2431,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator!=()
The \a other byte array is converted to a QString using the
fromAscii() function. If any NUL characters ('\\0') are embedded
fromUtf8() function. If any NUL characters ('\\0') are embedded
in the byte array, they will be included in the transformation.
You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
@ -2446,7 +2445,7 @@ bool QString::operator>(const QLatin1String &other) const
\overload operator!=()
The \a other const char pointer is converted to a QString using
the fromAscii() function.
the fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -3945,7 +3944,7 @@ static QByteArray toLatin1_helper(const QChar *data, int length)
characters. Those characters may be suppressed or replaced with a
question mark.
\sa fromLatin1(), toAscii(), toUtf8(), toLocal8Bit(), QTextCodec
\sa fromLatin1(), toUtf8(), toLocal8Bit(), QTextCodec
*/
QByteArray QString::toLatin1() const
{
@ -3991,7 +3990,7 @@ static QByteArray toLocal8Bit_helper(const QChar *data, int length)
locale, the returned byte array is undefined. Those characters may be
suppressed or replaced by another.
\sa fromLocal8Bit(), toAscii(), toLatin1(), toUtf8(), QTextCodec
\sa fromLocal8Bit(), toLatin1(), toUtf8(), QTextCodec
*/
QByteArray QString::toLocal8Bit() const
{
@ -4016,7 +4015,7 @@ QByteArray QString::toLocal8Bit() const
may be discarded and will not appear in the UTF-8 representation, or they
may be replaced by one or more replacement characters.
\sa fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec
\sa fromUtf8(), toLatin1(), toLocal8Bit(), QTextCodec
*/
QByteArray QString::toUtf8() const
{
@ -4034,7 +4033,7 @@ QByteArray QString::toUtf8() const
UCS-4 is a Unicode codec and is lossless. All characters from this string
can be encoded in UCS-4. The vector is not null terminated.
\sa fromUtf8(), toAscii(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4(), toWCharArray()
\sa fromUtf8(), toUtf8(), toLatin1(), toLocal8Bit(), QTextCodec, fromUcs4(), toWCharArray()
*/
QVector<uint> QString::toUcs4() const
{
@ -4107,7 +4106,7 @@ QString::Data *QString::fromAscii_helper(const char *str, int size)
If \a size is -1 (default), it is taken to be strlen(\a
str).
\sa toLatin1(), fromAscii(), fromUtf8(), fromLocal8Bit()
\sa toLatin1(), fromUtf8(), fromLocal8Bit()
*/
@ -4120,7 +4119,7 @@ QString::Data *QString::fromAscii_helper(const char *str, int size)
QTextCodec::codecForLocale() is used to perform the conversion.
\sa toLocal8Bit(), fromAscii(), fromLatin1(), fromUtf8()
\sa toLocal8Bit(), fromLatin1(), fromUtf8()
*/
QString QString::fromLocal8Bit_helper(const char *str, int size)
{
@ -4171,7 +4170,7 @@ QString QString::fromLocal8Bit_helper(const char *str, int size)
Unicode Plane (U+FFFE, U+FFFF, U+1FFFE, U+1FFFF, U+2FFFE, etc.), as well
as 16 codepoints in the range U+FDD0..U+FDDF, inclusive.
\sa toUtf8(), fromAscii(), fromLatin1(), fromLocal8Bit()
\sa toUtf8(), fromLatin1(), fromLocal8Bit()
*/
QString QString::fromUtf8_helper(const char *str, int size)
{
@ -4596,7 +4595,7 @@ QString& QString::fill(QChar ch, int size)
\overload operator+=()
Appends the byte array \a ba to this string. The byte array is converted
to Unicode using the fromAscii() function. If any NUL characters ('\\0')
to Unicode using the fromUtf8() function. If any NUL characters ('\\0')
are embedded in the \a ba byte array, they will be included in the
transformation.
@ -4611,7 +4610,7 @@ QString& QString::fill(QChar ch, int size)
\overload operator+=()
Appends the string \a str to this string. The const char pointer
is converted to Unicode using the fromAscii() function.
is converted to Unicode using the fromUtf8() function.
You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -4630,8 +4629,9 @@ QString& QString::fill(QChar ch, int size)
\overload operator+=()
Appends the character \a ch to this string. The character is
converted to Unicode using the fromAscii() function.
Appends the character \a ch to this string. Note that the character is
converted to Unicode using the fromLatin1() function, unlike other 8-bit
functions that operate on UTF-8 data.
You can disable this function by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -4754,10 +4754,10 @@ QString& QString::fill(QChar ch, int size)
\relates QString
Returns a string which is the result of concatenating \a s1 and \a
s2 (\a s2 is converted to Unicode using the QString::fromAscii()
s2 (\a s2 is converted to Unicode using the QString::fromUtf8()
function).
\sa QString::fromAscii()
\sa QString::fromUtf8()
*/
/*!
@ -4765,10 +4765,10 @@ QString& QString::fill(QChar ch, int size)
\relates QString
Returns a string which is the result of concatenating \a s1 and \a
s2 (\a s1 is converted to Unicode using the QString::fromAscii()
s2 (\a s1 is converted to Unicode using the QString::fromUtf8()
function).
\sa QString::fromAscii()
\sa QString::fromUtf8()
*/
/*!
@ -7384,7 +7384,7 @@ bool QString::isRightToLeft() const
Returns a std::string object with the data contained in this
QString. The Unicode data is converted into 8-bit characters using
the toAscii() function.
the toUtf8() function.
This operator is mostly useful to pass a QString to a function
that accepts a std::string object.
@ -7392,7 +7392,7 @@ bool QString::isRightToLeft() const
If the QString contains non-Latin1 Unicode characters, using this
can lead to loss of information.
\sa toAscii(), toLatin1(), toUtf8(), toLocal8Bit()
\sa toLatin1(), toUtf8(), toLocal8Bit()
*/
/*!
@ -7581,7 +7581,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -7606,7 +7606,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload operator!=()
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -7632,7 +7632,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c QT_NO_CAST_FROM_ASCII
when you compile your applications. This can be useful if you want
@ -7658,7 +7658,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -7684,7 +7684,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -7709,7 +7709,7 @@ QString &QString::setRawData(const QChar *unicode, int size)
\overload
The \a other const char pointer is converted to a QString using
the QString::fromAscii() function.
the QString::fromUtf8() function.
You can disable this operator by defining \c
QT_NO_CAST_FROM_ASCII when you compile your applications. This
@ -9061,7 +9061,7 @@ static inline bool qt_ends_with(const QChar *haystack, int haystackLen,
characters. Those characters may be suppressed or replaced with a
question mark.
\sa toAscii(), toUtf8(), toLocal8Bit(), QTextCodec
\sa toUtf8(), toLocal8Bit(), QTextCodec
*/
QByteArray QStringRef::toLatin1() const
{
@ -9100,7 +9100,7 @@ QByteArray QStringRef::toAscii() const
locale, the returned byte array is undefined. Those characters may be
suppressed or replaced by another.
\sa toAscii(), toLatin1(), toUtf8(), QTextCodec
\sa toLatin1(), toUtf8(), QTextCodec
*/
QByteArray QStringRef::toLocal8Bit() const
{
@ -9127,7 +9127,7 @@ QByteArray QStringRef::toLocal8Bit() const
may be discarded and will not appear in the UTF-8 representation, or they
may be replaced by one or more replacement characters.
\sa toAscii(), toLatin1(), toLocal8Bit(), QTextCodec
\sa toLatin1(), toLocal8Bit(), QTextCodec
*/
QByteArray QStringRef::toUtf8() const
{
@ -9145,7 +9145,7 @@ QByteArray QStringRef::toUtf8() const
UCS-4 is a Unicode codec and is lossless. All characters from this string
can be encoded in UCS-4.
\sa toAscii(), toLatin1(), toLocal8Bit(), QTextCodec
\sa toUtf8(), toLatin1(), toLocal8Bit(), QTextCodec
*/
QVector<uint> QStringRef::toUcs4() const
{