Changeset 24893 in vbox for trunk/include/iprt

Timestamp:

Nov 24, 2009 12:09:03 PM (15 years ago)

Author:

vboxsync

Message:

IPRT: Improved RTStrVersionCompare() + testcase.

File:

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

trunk/include/iprt/string.h

@@ -1058 +1058 @@
 
 /**
- * Converts a string representation of a version number to an unsigned number.
+ * Compares two version strings and returns the result. The version string has
+ * to be made of at least one number section, each section delimited by a ".",
+ * e.g. "123.45.67". Trailing zeros at the beginning and non-digits in a section
+ * will be skipped, so "12.foo006" becomes "12.6".
  *
  * @returns iprt status code.
@@ -1069 +1072 @@
  * @retval  VERR_NO_DIGITS
  *
- * @param   pszValue    Pointer to the string value.
- * @param   pu32        Where to store the converted number.
- */
-RTDECL(int) RTStrVersionToUInt32(const char *pszVer, uint32_t *pu32);
+ * @todo    Deal with prefixes and suffixes!
+ * @param   pszVer1     First version string to compare.
+ * @param   pszVer2     First version string to compare.*
+ * @param   pui8Res     Pointer uint8_t value where to store the comparison result:
+ *                      0 if equal, 1 if pszVer1 is greater, 2 if pszVer2 is greater.
+ */
+RTDECL(int) RTStrVersionCompare(const char *pszVer1, const char *pszVer2, uint8_t *pui8Res);
 
 /**