Provides an STL style const reverse iterator for QString16.

See also

QString16::iterator

Typedef for an integer type representing the distance between two elements in a QString16.

Provides an STL style non-const reverse iterator for QString16.

See also

QString16::const_iterator

Typedef for an integer type representing sizes in a QString16.

Typedef for char16_t.

Typedef for the elements stored in a QString16.

This enum describes the various normalized forms of Unicode text.

See also

normalized(), Unicode Standard Annex #15

Constructs an empty string.

See also

isEmpty()

Constructs a new QString16 from data.

Copy constructs a new QString16 from other.

See also

operator=()

Move constructs a new QString16 from other.

Constructs a string of size 1 containing the code point c.

Constructs a string of the given numOfChars with every code point set to c.

See also

fill()

Constructs a string using the special Unicode character c.

Constructs a string with the first numOfChars number of code points pointed to by data. If numOfChars is not specified, the entire null terminated string will be used.

Constructs a string using the const iterator range begin to end.

Constructs a string using the given string literal cStr.

Constructs a string initialized with str. The entire string is copied including any null characters. The contents of the QByteArray must be valid UTF-8.

This constructor will only be available if you define CS_STRING_ALLOW_UNSAFE.

Warning

It is strongly advised not to use this method. Instead your code should call QString16::fromLatin1() or QString16::fromUtf8().

Constructs a string using the iterator range begin to end. The elements in the range must be implicitly convertible to QChar32.

Constructs a string using the string view str.

Destroys this string.

Appends the code point c to this string and returns a reference to this string.

Appends the first numOfChars number of code points pointed to by data.

Appends the string other to the end of this string. Returns a reference to this string.

See also

operator+=(), insert(), prepend()

Appends from iter_begin to iter_end, to the end of this string. Returns a reference to this string.

Appends the code point c to this string and returns a reference to this string.

Appends the given string view str to this string. Returns a reference to this string.

Appends the given string view str to this string, beginning at position indexStart in str and continuing for the length numOfChars. Returns a reference to this string.

Returns the code point at the given position index in the string. The index must be a valid position in the string.

See also

operator[]()

Returns the last code point in this string.

See also

front(), at(), operator[]()

Returns an STL style iterator pointing to the first code point in the string.

See also

constBegin(), end()

Returns a const STL style iterator pointing to the first code point in the string.

Returns a const STL style iterator pointing to the first code point in the string.

See also

begin(), cend()

Returns a const STL style iterator pointing to the imaginary item after the last code point in the string.

See also

cbegin(), end()

Removes numOfChar code points counting from the end of the string. If numOfChar is greater than size() the result is an empty string.

To remove characters from the beginning of the string, use remove().

See also

truncate(), resize(), remove()

Clears the contents of the string and makes it empty.

See also

resize(), isEmpty()

Compares this string with the string str. If cs is Qt::CaseSensitive the comparison is case sensitive, otherwise the comparison is case insensitive.

• if this string is less than str, returns -1
• if this string is equal to str, returns 0
• if this string is greater than str, returns 1

Compares str1 with str2. If cs is Qt::CaseSensitive the comparison is case sensitive, otherwise the comparison is case insensitive.

• if str1 is less than str2, returns -1
• if str1 is equal to str2, returns 0
• if str1 is greater than str2, returns 1

See also

operator==(), operator<(), operator>()

Compares this string with the string view str. If cs is Qt::CaseSensitive the comparison is case sensitive, otherwise the comparison is case insensitive.

• if this string is less than str, returns -1
• if this string is equal to str, returns 0
• if this string is greater than str, returns 1

Compares string view str1 with the string view str2. If cs is Qt::CaseSensitive the comparison is case sensitive, otherwise the comparison is case insensitive.

• if str1 is less than str2, returns -1
• if str1 is equal to str2, returns 0
• if str1 is greater than str2, returns 1

Returns a const STL style iterator pointing to the first code point in the string.

See also

begin(), constEnd()

Returns a pointer to the null terminated data stored in the string. The pointer is valid until the string is modified.

See also

data(), operator[]()

Returns a const STL style iterator pointing to the imaginary item after the last code point in the string.

See also

constBegin(), end()

Returns true if this string contains an occurrence of the character ch, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns true if this string contains an occurrence of the regular expression regExp, otherwise it returns false.

Returns true if this string contains an occurrence of the string str, otherwise it returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

indexOf(), count()

Returns true if this string contains an occurrence of the character c, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns true if this string contains an occurrence of the string view str, otherwise it returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

indexOf(), count()

Equivalent to calling size().

Returns the number of occurrences of the regular expression regExp in the string.

Returns the number of (potentially overlapping) occurrences of the string str in this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

contains(), indexOf()

Returns the number of occurrences of character c in the string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns the number of occurrences of the string view str in this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns an STL style iterator pointing to the last code point in the string, in reverse order.

See also

begin(), rbegin(), rend()

Returns a const STL style iterator pointing to the imaginary item before the first code point in the string, in reverse order.

See also

end(), rbegin(), rend()

Returns a pointer to the null terminated data stored in the string. The pointer is valid until the string is modified.

See also

constData(), operator[]()

Returns true if the string has no characters, otherwise returns false.

See also

size()

Returns an STL style iterator pointing to the imaginary item after the last code point in the string.

See also

begin(), constEnd()

Returns a const STL style iterator pointing to the imaginary item after the last code point in the string.

Returns true if the string ends with str, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

startsWith()

Returns true if the current string ends with c, otherwise returns false.

Returns true if the current string ends with the string view str, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Sets every character in the string to character c. If numOfChars is not the default value of -1, the string is resized to the value of numOfChars before the fill is done.

See also

resize()

Returns the first code point in this string.

See also

back(), at(), operator[]()

Wrapper for QStringParser::formatArg(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::formatArgs(). In order to use this method in your application include the <QStringParser> header file.

Constructs a new QString containing a copy of the string CFString.

Note

This method is only available on Mac OS X.

Returns a QString16 containing the first numOfChars number of Latin-1 characters specified in str. If value for numOfChars is -1 the entire str is used.

See also

toLatin1(), fromUtf8()

Returns a QString16 containing the Latin-1 string str.

See also

toLatin1(), fromUtf8()

Constructs a new QString containing a copy of the string NSString.

Note

This method is only available on Mac OS X.

Returns a QString16 containing the std::string str.

Returns a QString16 containing the std::wstring str.

Returns a QString16 containing the first numOfChars number of characters from the UTF-16 string str. If the value for numOfChars is -1 the str must be null terminated.

Returns a QString16 containing the first numOfChars number of characters from the C string str. If the value for numOfChars is -1 the str must be null terminated.

See also

toUtf8(), fromLatin1()

Returns a QString16 containing the UTF-8 string str.

See also

toUtf8(), fromLatin1()

Returns a QString16 containing the UTF-8 string str.

Returns the first code point in this string.

See also

back(), at(), operator[]()

Returns the index position of the first occurrence of the regular expression regExp in the string, searching forward from the index position from. Returns -1 if regExp is not found.

Returns the index position of the first occurrence of str in this string. The search begins at position from. Returns -1 if str is not found.

If from is -1 the search starts at the last character, if from is -2 the search starts at the next to last character, and so on. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

lastIndexOf(), contains(), count()

Returns the index position of the first occurrence of the character c in the string, searching forward from index position from. Returns -1 if c is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns the iterator position of the first occurrence of the regular expression regExp in the string. Returns the end iterator if the regExp is not found.

Returns the iterator position of the first occurrence of the string view str in the string, searching forward from iterator position from. Returns the end iterator if str is not found.

Returns an iterator to the first occurrence of str in this string. Returns the end iterator if str is not found.

Returns an iterator to the first occurrence of str in this string, searching forward from iterator from. Returns the end iterator if str is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns an iterator to the first occurrence of c in this string. Returns the end iterator if c is not found.

Returns an iterator to the first occurrence of c in this string, searching forward from iterator from. Returns the end iterator if c is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns the iterator position of the first occurrence of the string view str in the string, searching forward from iterator position from. Returns the end iterator if str is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Beginning at position first in the current string, insert str. Returns a reference to this string.

Beginning at position first in the current string, insert the range of characters from begin to end. Returns a reference to this string.

At position indexStart in the string, insert the first numOfChars number of code points pointed to by data.

Inserts the string str at the given indexStart and returns a reference to this string. If the given indexStart is greater than size() the string is first extended using resize().

See also

append(), prepend(), replace(), remove()

Inserts c at the given index indexStart in the string.

Inserts the string view str at the given position indexStart in this string. Returns a reference to this string.

Inserts the string view str at the given position indexStart in the string, beginning at the position srcStart in str and continuing for the length numOfChars.

Returns a reference to this string.

Returns true if the string has no characters, otherwise returns false.

See also

size()

Returns the last code point in this string.

See also

front(), at(), operator[]()

Returns the index position of the last occurrence of the string str in this string, searching backward from index position from. Returns -1 if str is not found.

If from is -1 the search starts at the last character, if from is -2 the search starts at the next to last character, and so on. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

indexOf(), contains(), count()

Returns the index position of the last occurrence of the character c, searching backward from position from. Returns -1 if str is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns an iterator to the last occurrence of str in this string. Returns the end iterator if str is not found.

Returns an iterator to the first occurrence of str in this string, searching backward from iterator from. Returns the end iterator if str is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns an iterator to the last occurrence of c in this string. Returns the end iterator if c is not found.

Returns an iterator to the last occurrence of c in this string, searching backward from iterator from. Returns the end iterator if c is not found.

If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns the iterator position of the last occurrence of the string view str in this string, searching backward from iterator position from. Returns the end iterator if str is not found.

If from is -1 the search starts at the last character, if from is -2 the search starts at the next to last character, and so on. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns a new QString16 containing the first numOfChars code points in this string. The entire string is returned if numOfChars is greater than size() or less than zero.

See also

leftView(), right(), mid(), startsWith()

Returns a string of size width that contains this string padded by the fill character. If truncate is false and the size() of the string is more than the value of width, then the returned string is a copy of the string.

If truncate is true and the size() of the string is more than width, then any characters in a copy of the string after position width are removed and the copy is returned.

See also

rightJustified()

Returns a QStringView16 containing the first numOfChars code points in this string. The entire string is returned if numOfChars is greater than size() or less than zero.

See also

rightView(), midView()

Returns the number of characters in this string. This method is the same as calling size().

See also

resize()

Compares string str with this string object and returns an integer based on the sort relationship of the strings. The comparison is performed platform dependent.

• if this string is less than str, returns -1
• if this string is equal to str, returns 0
• if this string is greater than str, returns 1

Compares string str1 with string str2 and returns an integer based on the sort relationship of the strings. The comparison is performed platform dependent.

• if str1 is less than str2, returns -1
• if str1 is equal to str2, returns 0
• if str1 is greater than str2, returns 1

Compares this string with the string view str and returns an integer based on the sort relationship of the strings. The comparison is performed platform dependent.

• if this string is less than str, returns -1
• if this string is equal to str, returns 0
• if this string is greater than str, returns 1

Compares string view str1 with string view str2 and returns an integer based on the sort relationship of the strings. The comparison is performed platform dependent.

• if str1 is less than str2, returns -1
• if str1 is equal to str2, returns 0
• if str1 is greater than str2, returns 1

Returns a string containing numOfChars characters of this string, starting at the iterator position iter.

Returns a string containing numOfChars characters of this string, starting at the position indexStart.

Returns an empty string if the index exceeds the length of the string. If there are less than numOfChars characters available in the string, starting at the given index, or if numOfChars is -1, the method returns all characters available from the specified index to the end of the string.

See also

left(), right()

Returns a QStringView16 containing the code points starting at iterator position iter for a length of numOfChars.

Returns a QStringView16 containing the code points starting at indexStart for a length of numOfChars.

• If the position exceeds the length of this string an empty QStringView is returned.
• The entire string is returned if there are less than numOfChars characters in this string, starting at the given position.
• The entire string is returned if numOfChars is -1.

See also

leftView(), rightView()

Returns the string in the given Unicode normalization mode, according to the given version of the Unicode standard.

Wrapper for QStringParser::number(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::number(). In order to use this method in your application include the <QStringParser> header file.

Appends the string other to the end of this string and returns a reference to this string.

See also

append(), prepend()

Appends c to this string and returns a reference to this string.

Appends the special Unicode character c to this string and returns a reference to this string.

Appends the string view str to this string.

Copy assigns from other and returns a reference to this object.

Assigns c to this string and returns a reference to this string.

Move assigns from other and returns a reference to this object.

Assigns the string view str to this string and returns a reference to this string.

Returns the code point at the specified index in the string. Equivalent to calling at(index).

Prepends the character c to this string and returns a reference to this string.

Prepends the first numOfChars number of characters pointed to by data.

Prepends the string other to the beginning of this string and returns a reference to this string.

See also

append(), insert()

Prepends from iter_begin to iter_end. Returns a reference to this string.

Prepends the character c to this string and returns a reference to this string.

This method is equivalent to appending the given other string onto the end of this string. It is the same as append(other).

See also

append()

Appends the given c character to the end of this string.

This method is equivalent to prepending the given other string to the beginning of this string. It is the same as prepend(other).

See also

prepend()

Prepends the given c character to the beginning of this string.

Returns an STL style iterator pointing to the last code point in the string, in reverse order.

See also

begin(), crbegin(), rend()

Returns a const STL style iterator pointing to the last code point in the string, in reverse order.

Removes every occurrence of the regular expression regExp in the string and returns a reference to the string.

See also

indexOf(), lastIndexOf(), replace()

Removes every occurrence of the given str in this string and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

This is the same as replace(str, "", cs).

See also

replace()

Removes every occurrence of the character c in this string, and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

This is the same as replace(c, "", cs).

See also

replace()

Removes numOfChars code points from the string, starting at the given indexStart index. Returns a reference to the string. If (indexStart + numOfChars) is beyond the end of the string, the string is truncated at the specified indexStart.

See also

insert(), replace()

Returns an STL style iterator pointing to the imaginary item before the first code point in the string, in reverse order.

See also

begin(), crbegin(), rend()

Returns a const STL style iterator pointing to the imaginary item before the first code point in the string, in reverse order.

Returns a copy of this string repeated the specified number of count. If the value for times is less than 1, an empty string is returned.

Replaces each occurrence in this string of the first beforeSize characters of before with the first afterSize characters of after and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Replaces every occurrence of the regular expression regExp in the string with after. Returns a reference to this string.

For regular expressions containing capturing parentheses in the pattern, occurrences of \1, \2, ..., in the passed parameter string "after" are replaced with the corresponding capture.

See also

indexOf(), lastIndexOf(), remove(), QRegularExpressionMatch::captured()

Replaces every occurrence of the string before with the string after and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

It is of value to note the replacement text is not rescanned after it is inserted.

Beginning at position first replace the characters up to but not including last with str. Returns a reference to this string.

Replace the range from first1 to last1 with the characters from first2 to last2. Returns a reference to this string.

Replaces every occurrence of the QChar32 before with the QChar32 after and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Replaces every occurrence of the QChar32 c in this string with the string after and returns a reference to this string. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Beginning at position indexStart in this string, replace the next numOfChars with the first sizeStr code points of data. Returns a reference to this string.

Beginning at position indexStart in this string, replace the next numOfChars with string str. Returns a reference to this string.

See also

insert(), remove()

Beginning at position indexStart in this string, replace the next numOfChars with the first sizeStr number of code points from the string str. Returns a reference to this string.

Beginning at position indexStart in this string, replace the next numOfChars with a single character c. Returns a reference to this string.

Sets the size of the string to numOfChars code points. If numOfChars is greater than the current size the string is extended to make it numOfChars code points long with the extra code points added to the end. The new code points are uninitialized.

If numOfChars is less than the current size, characters are removed from the end.

If you want to append a certain number of identical code points to the string, use operator+=() as follows rather than resize().

If you want to expand the string so that it reaches a certain width and fill the new positions with a particular code point, use the leftJustified() method:

If size is negative, it is equivalent to passing zero.

See also

truncate()

Sets the size of the string to numOfChars code points. If numOfChars is greater than the current size the string is extended to make it numOfChars characters long with the extra code points added to the end.

The new code points are initialized to c.

Returns a substring containing the count rightmost code points of the string. The entire string is returned if n is greater than size() or less than zero.

See also

left(), mid(), endsWith()

Returns a string of size() width that contains the fill character followed by the string.

If truncate is false and the size() of the string is more than the width, the returned string is a copy of the string.

If truncate is true and the size() of the string is more than width, the resulting string is truncated at position width.

See also

leftJustified()

Returns a QStringView16 containing the last count code points in this string. The entire string is returned if numOfChars is greater than size() or less than zero.

See also

leftView(), midView()

Wrapper for QStringParser::section(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::section(). In order to use this method in your application include the <QStringParser> header file.

Returns a string that has whitespace removed from the start and the end, and that has each sequence of internal whitespace replaced with a single space. This method is only called if this string is an rvalue, this occurs when the string is a temporary or has been moved.

Refer to the const reference version of simplified().

Returns a string that has whitespace removed from the start and the end, and that has each sequence of internal whitespace replaced with a single space.

Whitespace means any character for which QChar32::isSpace() returns true. This includes the ASCII characters '\t', '\n', '\v', '\f', '\r', and ' '.

See also

trimmed()

Returns the number of code points in this string.

The last character in the string is at position size() - 1. In addition, QString16 ensures the character at position size() is always '\0' so you can use the return value of data() and constData() as arguments to functions which expect null terminated strings.

See also

isEmpty(), resize()

Returns the number of storage units in this string. The storage size is the actual bytes required in the underlying container for a string. This value will usually be larger than size().

It is normally only used when passing a QString16 to a C API which expects a pointer and a length.

Wrapper for QStringParser::split(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::split(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::split(). In order to use this method in your application include the <QStringParser> header file.

Releases any memory not required to store the character data. In general you will rarely ever need to call this method.

Returns true if the current string starts with str, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

See also

endsWith()

Returns true if the string starts with c, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns true if the current string starts with the string view str, otherwise returns false. If cs is Qt::CaseSensitive the search is case sensitive, otherwise the search is case insensitive.

Returns a const STL style iterator pointing to the first storage unit in the string. In UTF-16 a code point such as the Greek letter Delta is one code point and requires one storage unit.

See also

size_storage()

Returns a const STL style iterator pointing to the imaginary item after the last storage unit in the string.

See also

size_storage()

Returns a const STL style iterator pointing to the last storage unit in the string, in reverse order.

See also

size_storage()

Returns a const STL style iterator pointing to one before the first storage unit in the string, in reverse order.

See also

size_storage()

Swaps other with this object. This operation is very fast and never fails.

Converts the string to case folded and returns the converted string. This method is only called if this string is an rvalue, this occurs when the string is a temporary or has been moved.

Refer to the const reference version of toCaseFolded().

Returns the case folded equivalent of the string. For most Unicode characters this is the same as toLower().

Creates a CFString from a QString. The caller owns the CFString and is responsible for releasing it.

Note

This method is only available on Mac OS X.

Wrapper for QStringParser::toDouble(). In order to use this method in your application include the <QStringParser> header file.

Wrapper for QStringParser::toFloat(). In order to use this method in your application include the <QStringParser> header file.

Converts a plain text string to an HTML string with the HTML meta characters <, >, &, and " replaced by the appropriate HTML syntax.

Note

This method replaces Qt::escape ( const QString & plain )

Wrapper for QStringParser::toInteger(). In order to use this method in your application include the <QStringParser> header file.

This method replaces the following set of methods: toInt, toUInt, toLong, toULong, toLongLong, toULongLong, toShort, toUShort. The required data type is passed as the template parameter to this method. The following example shows how to specify long as the type argument.