Add compareToNumeric to OUString & Co

1 files changed, 22 insertions, 0 deletions

diff --git a/sal/inc/rtl/ustring.hxx b/sal/inc/rtl/ustring.hxx
index b56413d8bfbe..76bbe2668b6c 100644
--- a/sal/inc/rtl/ustring.hxx
+++ b/sal/inc/rtl/ustring.hxx
@@ -330,6 +330,28 @@ public:
     }
 
     /**
+      Compares two strings using natural order.
+
+      For non digit characters, the comparison use the same algorithm as
+      rtl_str_compare. When a number is encountered during the comparison,
+      natural order is used. Thus, Heading 10 will be considered as greater
+      than Heading 2. Numerical comparison is done using decimal representation.
+
+      Beware that "MyString 001" and "MyString 1" will be considered as equal
+      since leading 0 are meaningless.
+
+      @param    str         the object to be compared.
+      @return   0 - if both strings are equal
+                < 0 - if this string is less than the string argument
+                > 0 - if this string is greater than the string argument
+    */
+    sal_Int32 compareToNumeric( const OUString & str ) const SAL_THROW(())
+    {
+        return rtl_ustr_compare_Numeric( pData->buffer,
+                                            str.pData->buffer );
+    }
+
+    /**
       Compares two strings with an maximum count of characters.
 
       The comparison is based on the numeric value of each character in