Changeset 93057 in vbox for trunk/include

Timestamp:

Dec 22, 2021 2:21:25 PM (3 years ago)

Author:

vboxsync

Message:

IPRT: Added RTStrDupNEx and RTStrDupNExTag.

Location:

trunk/include/iprt

Files:

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

trunk/include/iprt/mangling.h

@@ -2228 +2228 @@
 # define RTStrDupExTag                                  RT_MANGLER(RTStrDupExTag)
 # define RTStrDupNTag                                   RT_MANGLER(RTStrDupNTag)
+# define RTStrDupNExTag                                 RT_MANGLER(RTStrDupNExTag)
 # define RTStrDupTag                                    RT_MANGLER(RTStrDupTag)
 # define RTStrEnd                                       RT_MANGLER(RTStrEnd)

trunk/include/iprt/string.h

@@ -310 +310 @@
  *
  * @returns iprt status code.
- * @param   ppszString      Receives pointer of the allocated UTF-8 string.
+ * @param   ppszCopy        Receives pointer of the allocated UTF-8 string.
  *                          The returned pointer must be freed using RTStrFree().
  * @param   pszString       UTF-8 string to duplicate.
  */
-#define RTStrDupEx(ppszString, pszString)   RTStrDupExTag((ppszString), (pszString), RTSTR_TAG)
+#define RTStrDupEx(ppszCopy, pszString)     RTStrDupExTag((ppszCopy), (pszString), RTSTR_TAG)
 
 /**
@@ -320 +320 @@
  *
  * @returns iprt status code.
- * @param   ppszString      Receives pointer of the allocated UTF-8 string.
+ * @param   ppszCopy        Receives pointer of the allocated UTF-8 string.
  *                          The returned pointer must be freed using RTStrFree().
  * @param   pszString       UTF-8 string to duplicate.
  * @param   pszTag          Allocation tag used for statistics and such.
  */
-RTDECL(int)  RTStrDupExTag(char **ppszString, const char *pszString, const char *pszTag);
+RTDECL(int)  RTStrDupExTag(char **ppszCopy, const char *pszString, const char *pszTag);
 
 /**
@@ -347 +347 @@
  */
 RTDECL(char *) RTStrDupNTag(const char *pszString, size_t cchMax, const char *pszTag);
+
+/**
+ * Allocates a new copy of the given UTF-8 substring (default tag).
+ *
+ * @returns iprt status code (VINF_SUCCESS or VERR_NO_STR_MEMORY).
+ * @param   ppszCopy        Receives pointer of the allocated UTF-8 substring.
+ *                          The returned pointer must be freed using RTStrFree().
+ * @param   pszString       UTF-8 string to duplicate.
+ * @param   cchMax          The max number of chars to duplicate, not counting
+ *                          the terminator.
+ * @param   pszTag          Allocation tag used for statistics and such.
+ */
+#define RTStrDupNEx(ppszCopy, pszString, cchMax)    RTStrDupNExTag((ppszCopy), (pszString), (cchMax), RTSTR_TAG)
+
+/**
+ * Allocates a new copy of the given UTF-8 substring (custom tag).
+ *
+ * @returns iprt status code (VINF_SUCCESS or VERR_NO_STR_MEMORY).
+ * @param   ppszCopy        Receives pointer of the allocated UTF-8 substring.
+ *                          The returned pointer must be freed using RTStrFree().
+ * @param   pszString       UTF-8 string to duplicate.
+ * @param   cchMax          The max number of chars to duplicate, not counting
+ *                          the terminator.
+ * @param   pszTag          Allocation tag used for statistics and such.
+ */
+RTDECL(int) RTStrDupNExTag(char **ppszCopy, const char *pszString, size_t cchMax, const char *pszTag);
 
 /**