Changeset 103283 in vbox for trunk/include

Timestamp:

Feb 8, 2024 3:22:17 PM (13 months ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

161577

Message:

IPRT/string: Added RTStrCat2() as a convenient function.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• string.h (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -2266 +2266 @@
 # define RTStrCalcUtf16LenEx                            RT_MANGLER(RTStrCalcUtf16LenEx)
 # define RTStrCat                                       RT_MANGLER(RTStrCat)
+# define RTStrCat2                                      RT_MANGLER(RTStrCat2)
 # define RTStrCatEx                                     RT_MANGLER(RTStrCatEx)
 # define RTStrCatP                                      RT_MANGLER(RTStrCatP)

trunk/include/iprt/string.h

@@ -2461 +2461 @@
  * String concatenation with overflow handling.
  *
+ * @return  Pointer to \a pszDst on success, or NULL on failure.
+ *
+ * @param   pszDst              The destination buffer.
+ * @param   cbDst               The size of the destination buffer (in bytes).
+ * @param   pszSrc              The source string.  NULL is not OK.
+ */
+RTDECL(char *) RTStrCat2(char *pszDst, size_t cbDst, const char *pszSrc);
+
+/**
+ * String concatenation with overflow handling.
+ *
  * @retval  VINF_SUCCESS on success.
  * @retval  VERR_BUFFER_OVERFLOW if the destination buffer is too small.  The