Changeset 85154 in vbox for trunk/include

Timestamp:

Jul 9, 2020 5:22:51 PM (5 years ago)

Author:

vboxsync

Message:

IPRT: Added RTStrSplit + testcases.

Location:

trunk/include/iprt

Files:

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

trunk/include/iprt/mangling.h

@@ -2167 +2167 @@
 # define RTStrMemFind64                                 RT_MANGLER(RTStrMemFind64)
 # define RTStrMemFind64_EndProc                         RT_MANGLER(RTStrMemFind64_EndProc)
+# define RTStrSplit                                     RT_MANGLER(RTStrSplit)
 # define RTStrmClearError                               RT_MANGLER(RTStrmClearError)
 # define RTStrmClose                                    RT_MANGLER(RTStrmClose)

trunk/include/iprt/string.h

@@ -2515 +2515 @@
 
 /**
+ * Splits a string buffer with a given separator into separate strings.
+ * If no separators are found, no strings are returned. Consequtive separators will be skipped.
+ *
+ * @returns iprt status code.
+ * @param   pcszStrings         String buffer to split.
+ * @param   cbStrings           Size (in bytes) of string buffer to split, including terminator.
+ * @param   pcszSeparator       Separator to use / find for splitting strings.
+ * @param   ppapszStrings       Where to return the allocated string array on success. Needs to be free'd by the caller.
+ * @param   pcStrings           Where to return the number of split strings in \a ppapszStrings.
+ */
+RTDECL(int) RTStrSplit(const char *pcszStrings, size_t cbStrings,
+                       const char *pcszSeparator, char ***ppapszStrings, size_t *pcStrings);
+
+/**
  * Locates a case sensitive substring.
  *