Changeset 103252 in vbox

Timestamp:

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

Author:

vboxsync

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

161541

Message:

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

Location:

trunk

Files:

trunk/include/iprt/mangling.h

r103014	r103252
2273	2273	# define RTStrConvertHexBytesEx RT_MANGLER(RTStrConvertHexBytesEx)
2274	2274	# define RTStrCopy RT_MANGLER(RTStrCopy)
	2275	# define RTStrCopy2 RT_MANGLER(RTStrCopy2)
2275	2276	# define RTStrCopyEx RT_MANGLER(RTStrCopyEx)
2276	2277	# define RTStrCopyP RT_MANGLER(RTStrCopyP)

-              r103024
+              r103252
  * 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

-              r98103
+              r103252
 RTDECL(int) RTStrCopy(char *pszDst, size_t cbDst, const char *pszSrc)
+DECLINLINE(int) rtStrCopy(char *pszDst, size_t cbDst, const char *pszSrc)
+{
     size_t cchSrc = strlen(pszSrc);
 …
     return VERR_BUFFER_OVERFLOW;
+}
+RTDECL(int) RTStrCopy(char *pszDst, size_t cbDst, const char *pszSrc)
+{
+    return rtStrCopy(pszDst, cbDst, pszSrc);
+}
 RT_EXPORT_SYMBOL(RTStrCopy);
+RTDECL(char *) RTStrCopy2(char *pszDst, size_t cbDst, const char *pszSrc)
+{
+    return RT_SUCCESS(rtStrCopy(pszDst, cbDst, pszSrc)) ? pszDst : NULL;
+}
+RT_EXPORT_SYMBOL(RTStrCopy2);

Note: See TracChangeset for help on using the changeset viewer.