FCL/sf/mw/hb: comparison src/hbcore/i18n/hbstringutil.cpp

equal deleted inserted replaced

-:06ff229162e9
+:11d3954df52a
 #ifndef QT_NO_REGEXP
 #include <QRegExp>
 #endif
 /*!
-@beta
+@stable
 @hbcore
 \class HbStringUtil
 \brief The HbStringUtil class can be used to execute operations on strings,
 such as comparisons and finding data sequences.
-\ingroup i18n
-\warning This class is only useful in Symbian platforms since it uses Symbian
-methods in order to implement different functionalities.
 \sa HbStringUtil
 */
 /*!
 \enum HbStringUtil::Option
 */
 /*!
 Searches source string's collated data for a
 match with collated data supplied in pattern string
+\attention Cross-Platform API
 \param strFrom Source string.
 \param strToMatch Pattern string.
 \param maxLevel Determines the tightness of the collation.
 Level 0 - Character identity;
 Level 3 - Character identity, accents, case and Unicode value;
 \param flags The flags that will be used. Default value is Default.
 \param wildChar Wild card character.
 \param wildSequenceChar Wild card sequence character.
 \param escapeChar The escape character, for example,  '?', '*'.
 \return If a match is found the offset within source string's
 data where the match first occurs. -1 if match is not found.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,3}
 /*!
 Compares source string's data with the other string's
 data using the specified collation method.
+\attention Cross-Platform API
 \param string1 Source string.
 \param string2 String whose data is to be compared with the source string.
 \param maxLevel Maximum level to use for comparing.
 Level 0 - Character identity;
 Level 1 - Character identity and accents;
 Level 2 - Character identity, accents and case;
 Level 3 - Character identity, accents, case and Unicode value;
 \param flags The flags that will be used. Default value is Default.
 \return Positive if source string is greater, negative if it is less and
 zero	if the content of both strings match.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,1}
 /*!
 Searches for the first occurence of the specified collated
 data sequence in the aStrFrom to the specified maximum
 collation level.
+\attention Cross-Platform API
 \param strFrom Source string.
 \param strToFind String whose data is to be compared with the source string.
 \param maxLevel The maximum collation level.
 Level 0 - Character identity;
 Level 1 - Character identity and accents;
 Level 2 - Character identity, accents and case;
 Level 3 - Character identity, accents, case and Unicode value;
 \return Offset of the data sequence from the beginning of the
 aStrFrom. -1 if the data sequence cannot be found.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,5}
 /*!
 Searches source string's folded data for a
 match with folded data supplied in pattern string
+\attention Cross-Platform API
 \param strFrom Source string.
 \param strToMatch Pattern string.
 \return If a match is found the offset within source string's
 data where the match first occurs. -1 if match is not found.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,4}
 /*!
 Searches for the first occurence of the specified folded
 data sequence in the strFrom.
+\attention Cross-Platform API
 \param strFrom Source string.
 \param strToFind String whose data is to be compared with the source string.
 \return Offset of the data sequence from the beginning of the
 strFrom. -1 if the data sequence cannot be found. Zero,
 if the length of search data sequence is zero.
 Example
 /*!
 Compares source string's folded data with the other string's
 folded data.
+\attention Cross-Platform API
 \param string1 Source string.
 \param string2 String whose data is to be compared with the source string.
 \return Positive if source string is greater, negative if it is less and
 zero if the content of both strings match.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,2}
 return ch;
 }
 /*!
 Converts digits to native digits based on current UI language.
+\attention Cross-Platform API
 \param str digits to be converted.
 */
 QString HbStringUtil::convertDigits( const QString str )
 {
 	HbExtendedLocale locale = HbExtendedLocale::system();
 	return converted;
 }
 /*!
 Converts the digit from Latin to native or native to latin or native to native
+\attention Cross-Platform API
 \param str digits to be converted.
 \param digitType type of the digit to be converted to
 */
 QString HbStringUtil::convertDigitsTo( const QString str, const DigitType digitType )
 {
 }
 /*!
 Sorts QStrings into alphabetically order (overwrites the strList's original content)
+\attention Cross-Platform API
 \param strList List of QStrings which need to be sorted.
 Example
 \snippet{unittest_hbstringutil/unittest_hbstringutil.cpp,7}
 */

changeset 3	11d3954df52a
parent 1	f7ac710697a9
child 6	c3690ec91ef8