1 files changed, 23 insertions, 5 deletions
diff --git a/src/corelib/text/qutf8stringview.qdoc b/src/corelib/text/qutf8stringview.qdoc
index 9c0c620d88..031769440c 100644
--- a/src/corelib/text/qutf8stringview.qdoc
+++ b/src/corelib/text/qutf8stringview.qdoc
@@ -318,11 +318,9 @@
     \fn template <typename Char, size_t N> QUtf8StringView::QUtf8StringView(const Char (&string)[N])
 
     Constructs a string view on the character string literal \a string.
-    The length is set to \c{N-1}, excluding the trailing \c{Char(0)}.
-    If you need the full array, use the constructor from pointer and
-    size instead:
-
-    \snippet code/src_corelib_text_qutf8stringview.cpp 2
+    The view covers the array until the first \c{Char(0)} is encountered,
+    or \c N, whichever comes first.
+    If you need the full array, use fromArray() instead.
 
     \a string must remain valid for the lifetime of this string view
     object.
@@ -331,6 +329,8 @@
     is an actual array and if \c Char is a compatible character type. The
     compatible character types are: \c char8_t, \c char, \c{signed char} and
     \c{unsigned char}.
+
+    \sa fromArray
 */
 
 /*!
@@ -353,6 +353,24 @@
 */
 
 /*!
+    \fn template <typename Char, size_t Size> static QBasicUtf8StringView fromArray(const Char (&string)[Size])
+
+    Constructs a string view on the full character string literal \a string,
+    including any trailing \c{Char(0)}. If you don't want the
+    null-terminator included in the view then you can chop() it off
+    when you are certain it is at the end. Alternatively you can use
+    the constructor overload taking an array literal which will create
+    a view up to, but not including, the first null-terminator in the data.
+
+    \a string must remain valid for the lifetime of this string view
+    object.
+
+    This function will work with any array literal if \c Char is a
+    compatible character type. The compatible character types
+    are: \c char8_t, \c char, \c{signed char} and \c{unsigned char}.
+*/
+
+/*!
     \fn QString QUtf8StringView::toString() const
 
     Returns a deep copy of this string view's data as a QString.