Changeset 18552 in vbox for trunk/include

Timestamp:

Mar 30, 2009 2:46:47 PM (16 years ago)

Author:

vboxsync

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

45421

Message:

IPRT: Untested RTStrIStr and RTStrStr. (testcase is underways)

File:

• trunk/include/iprt/string.h (modified) (2 diffs)

trunk/include/iprt/string.h

@@ -884 +884 @@
 
 /**
+ * Locates a case insensitive substring.
+ *
+ * If any of the two strings are NULL, then NULL is returned. If the needle is
+ * an empty string, then the haystack is returned (i.e. matches anything).
+ *
+ * @returns Pointer to the first occurance of the substring if found, NULL if
+ *          not.
+ *
+ * @param   pszHaystack The string to search.
+ * @param   pszNeedle   The substring to search for.
+ *
+ * @remarks The difference between this and strstr is the handling of NULL
+ *          pointers.s
+ */
+RTDECL(char *) RTStrStr(const char *pszHaystack, const char *pszNeedle);
+
+/**
+ * Locates a case insensitive substring.
+ *
+ * If any of the two strings are NULL, then NULL is returned. If the needle is
+ * an empty string, then the haystack is returned (i.e. matches anything).
+ *
+ * @returns Pointer to the first occurance of the substring if found, NULL if
+ *          not.
+ *
+ * @param   pszHaystack The string to search.
+ * @param   pszNeedle   The substring to search for.
+ *
+ */
+RTDECL(char *) RTStrIStr(const char *pszHaystack, const char *pszNeedle);
+
+/**
+ * Converts the string to lower case.
+ *
+ * @returns Pointer to the converted string.
+ * @param   psz     The string to convert.
+ */
+RTDECL(char *) RTStrToLower(char *psz);
+
+/**
+ * Converts the string to upper case.
+ *
+ * @returns Pointer to the converted string.
+ * @param   psz     The string to convert.
+ */
+RTDECL(char *) RTStrToUpper(char *psz);
+
+/**
  * Find the length of a zero-terminated byte string, given
  * a max string length.
@@ -969 +1017 @@
                                           const char *pszString, size_t cchString,
                                           size_t *poffPattern);
-
-/**
- * Converts the string to lower case.
- *
- * @returns Pointer to the converted string.
- * @param   psz     The string to convert.
- */
-RTDECL(char *) RTStrToLower(char *psz);
-
-/**
- * Converts the string to upper case.
- *
- * @returns Pointer to the converted string.
- * @param   psz     The string to convert.
- */
-RTDECL(char *) RTStrToUpper(char *psz);