Changeset 95336 in vbox for trunk/include/iprt/cpp

Timestamp:

Jun 21, 2022 8:48:58 PM (3 years ago)

Author:

vboxsync

Message:

IPRT/RTCString: Added a truncate() method that takes UTF-8 encoding into account when truncating the string. bugref:10185

File:

• trunk/include/iprt/cpp/ministring.h (modified) (1 diff)

trunk/include/iprt/cpp/ministring.h

@@ -853 +853 @@
 
     /**
+     * Truncates the string to a max length of @a cchMax.
+     *
+     * If the string is shorter than @a cchMax characters, no change is made.
+     *
+     * If the @a cchMax is not at the start of a UTF-8 sequence, it will be adjusted
+     * down to the start of the UTF-8 sequence.  Thus, after a truncation, the
+     * length() may be smaller than @a cchMax.
+     *
+     */
+    RTCString &truncate(size_t cchMax) RT_NOEXCEPT;
+
+    /**
      * Index operator.
      *