Changeset 103252 in vbox for trunk/include

Timestamp:

Feb 7, 2024 2:40:12 PM (12 months ago)

Author:

vboxsync

Message:

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

Location:

trunk/include/iprt

Files:

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

trunk/include/iprt/mangling.h

@@ -2273 +2273 @@
 # define RTStrConvertHexBytesEx                         RT_MANGLER(RTStrConvertHexBytesEx)
 # define RTStrCopy                                      RT_MANGLER(RTStrCopy)
+# define RTStrCopy2                                     RT_MANGLER(RTStrCopy2)
 # define RTStrCopyEx                                    RT_MANGLER(RTStrCopyEx)
 # define RTStrCopyP                                     RT_MANGLER(RTStrCopyP)

trunk/include/iprt/string.h

@@ -2378 +2378 @@
  * String copy 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 *) RTStrCopy2(char *pszDst, size_t cbDst, const char *pszSrc);
+
+/**
+ * String copy with overflow handling.
+ *
  * @retval  VINF_SUCCESS on success.
  * @retval  VERR_BUFFER_OVERFLOW if the destination buffer is too small.  The