compareTo()

Description

Compares two Strings, testing whether one comes before or after the other, or whether they’re equal. The strings are compared character by character, using the ASCII values of the characters. That means, for example, that ‘a’ comes before ‘b’ but after ‘A’. Numbers come before letters.

Syntax


string.compareTo(string2)

Parameters

string: a variable of type String
string2: another variable of type String

Returns

a negative number: if string comes before string2
0: if string equals string2
a positive number: if string comes after string2

Example

StringComparisonOperators

See also

String
equals()
equalsIgnoreCase()
== (comparison)


Language Reference Home

The text of the 86Duino reference is a modification of the Arduino reference, and is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.