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

QStringView: document utf16() and why it's the way it is

Browse Source 
Change-Id: If141308f4a35a10ff86b0c5259bc4df849bba36a
Reviewed-by: Lars Knoll <lars.knoll@qt.io>
This commit is contained in:
Marc Mutz 2017-03-27 15:49:52 +02:00
parent 2c265d2700
commit 239e862ff7
1 changed files with 20 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
src/corelib/tools/qstringview.cpp
View File

@ -106,7 +106,10 @@ QT_BEGIN_NAMESPACE
If in doubt, obtain a strong reference to the data by calling toString() to convert
the QStringView into a QString.
QStringView is a \e{Literal Type}.
QStringView is a \e{Literal Type}, but since it stores data as \c{char16_t}, iteration
is not \c constexpr (casts from \c{const char16_t*} to \c{const QChar*}, which is not
allowed in \c constexpr functions). You can use an indexed loop and/or utf16() in
\c constexpr contexts instead.
\note We strongly discourage the use of QList<QStringView>,
because QList is a very inefficient container for QStringViews (it would heap-allocate
@ -318,7 +321,22 @@ QT_BEGIN_NAMESPACE
Returns a const pointer to the first character in the string.
\sa begin(), end()
\note The character array represented by the return value is \e not null-terminated.
\sa begin(), end(), utf16()
*/
/*!
\fn const storage_type *QStringView::utf16() const
Returns a const pointer to the first character in the string.
\c{storage_type} is \c{char16_t}, except on MSVC 2013 (which lacks \c char16_t support),
where it is \c{wchar_t} instead.
\note The character array represented by the return value is \e not null-terminated.
\sa begin(), end(), data()
*/
/*!