cpp/string/basic string/compare

Compares two character sequences.

@1@ Compares this string to.

@2@ Compares a substring of this string to.
 * If, the substring is.

@3@ Compares a substring of this string to a substring  of.
 * If, the first substring is.
 * If, the second substring is.

@4@ Compares this string to the null-terminated character sequence beginning at the character pointed to by with length.

@5@ Compares a substring of this string to the null-terminated character sequence beginning at the character pointed to by  with length.
 * If, the substring is.

@6@ Compares a substring of this string to the characters in the range. The characters in may include null characters.
 * If, the substring is.

@7-9@

A character sequence consisting of characters starting at  is compared to a character sequence consisting of  characters starting at  as follows:
 * First, calculate the number of characters to compare, as if by.
 * Then compare the sequences by calling . For standard strings this function performs character-by-character lexicographical comparison. If the result is zero (the character sequences are equal so far), then their sizes are compared as follows:

Return value

 * Negative value if appears before the character sequence specified by the arguments, in lexicographical order.
 * Zero if both character sequences compare equivalent.
 * Positive value if appears after the character sequence specified by the arguments, in lexicographical order.

Exceptions
The overloads taking parameters named or  throws std if the argument is out of range.

@7@ @8,9@ Throws anything thrown by the conversion to std.