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

Timestamp:

Jun 28, 2017 10:26:10 PM (8 years ago)

Author:

vboxsync

Message:

RTCString: Added append methods for appending a substring.

File:

• trunk/include/iprt/cpp/ministring.h (modified) (3 diffs)

trunk/include/iprt/cpp/ministring.h

@@ -369 +369 @@
 
     /**
-     * Appends the string @a that to @a this.
+     * Appends the string @a pszThat to @a this.
      *
      * @param   pszThat         The C string to append.
@@ -378 +378 @@
      */
     RTCString &append(const char *pszThat);
+
+    /**
+     * Appends the a substring from @a rThat to @a this.
+     *
+     * @param   pszThat         The C string to append.
+     * @param   offStart        The start of the substring to append (byte offset,
+     *                          not codepoint).
+     * @param   cchMax          The maximum number of bytes to append.
+     *
+     * @throws  std::bad_alloc  On allocation error.  The object is left unchanged.
+     *
+     * @returns Reference to the object.
+     */
+    RTCString &append(const RTCString &rThat, size_t offStart, size_t cchMax = RTSTR_MAX);
+
+    /**
+     * Appends the first @a cchMax chars from string @a pszThat to @a this.
+     *
+     * @param   pszThat         The C string to append.
+     * @param   cchMax          The maximum number of bytes to append.
+     *
+     * @throws  std::bad_alloc  On allocation error.  The object is left unchanged.
+     *
+     * @returns Reference to the object.
+     */
+    RTCString &append(const char *pszThat, size_t cchMax);
 
     /**
@@ -1037 +1063 @@
     }
 
+    /**
+     * Appends exactly @a cchSrc chars from @a pszSrc to @a this.
+     *
+     * This is an internal worker for the append() methods.
+     *
+     * @param   pszSrc          The source string.
+     * @param   cchSrc          The source string length (exact).
+     * @throws  std::bad_alloc  On allocation error.  The object is left unchanged.
+     *
+     * @returns Reference to the object.
+     */
+    RTCString &appendWorker(const char *pszSrc, size_t cchSrc);
+
     static DECLCALLBACK(size_t) printfOutputCallback(void *pvArg, const char *pachChars, size_t cbChars);