Changeset 26659 in vbox for trunk

Timestamp:

Feb 19, 2010 2:42:37 PM (15 years ago)

Author:

vboxsync

Message:

IPRT: Added RTStrCopy and RTStrCopyEx for strcpy with overflow handling.

Location:

trunk

Files:

• include/iprt/string.h (modified) (1 diff)
• src/VBox/Runtime/Makefile.kmk (modified) (3 diffs)
• src/VBox/Runtime/common/string/RTStrCopy.cpp (added)
• src/VBox/Runtime/common/string/RTStrCopyEx.cpp (added)

trunk/include/iprt/string.h

@@ -1012 +1012 @@
 
 /**
+ * String copy with overflow handling.
+ *
+ * @retval  VINF_SUCCESS on success.
+ * @retval  VERR_BUFFER_OVERFLOW if the destination buffer is too small.  The
+ *          buffer will contain as much of the string as it can hold, fully
+ *          terminated.
+ *
+ * @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(int) RTStrCopy(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
+ *          buffer will contain as much of the string as it can hold, fully
+ *          terminated.
+ *
+ * @param   pszDst              The destination buffer.
+ * @param   cbDst               The size of the destination buffer (in bytes).
+ * @param   pszSrc              The source string.  NULL is not OK.
+ * @param   cchSrcMax           The maximum number of chars (not code points) to
+ *                              copy from the source string, not counting the
+ *                              terminator as usual.
+ */
+RTDECL(int) RTStrCopyEx(char *pszDst, size_t cbDst, const char *pszSrc, size_t cchSrcMax);
+
+/**
  * Performs a case sensitive string compare between two UTF-8 strings.
  *

trunk/src/VBox/Runtime/Makefile.kmk

@@ -296 +296 @@
         common/string/RTStrCmp.cpp \
         common/string/RTStrConvertHexBytes.cpp \
+        common/string/RTStrCopy.cpp \
+        common/string/RTStrCopyEx.cpp \
         common/string/RTStrNCmp.cpp \
         common/string/RTStrNLen.cpp \
@@ -860 +862 @@
         common/path/RTPathStripTrailingSlash.cpp \
         common/string/RTStrCmp.cpp \
+        common/string/RTStrCopy.cpp \
+        common/string/RTStrCopyEx.cpp \
         common/string/RTStrNCmp.cpp \
         common/string/RTStrNLen.cpp \
@@ -1287 +1291 @@
         common/rand/randparkmiller.cpp \
         common/string/RTStrCmp.cpp \
+        common/string/RTStrCopy.cpp \
+        common/string/RTStrCopyEx.cpp \
         common/string/RTStrNCmp.cpp \
         common/string/RTStrNLen.cpp \