Framework (A-Z)

Reference for Wiring version 1.0 Build 0100+ If you have a previous version, use the reference included with your software. If see any errors or have any comments, let us know.

Class

String
Name

equalsIgnoreCase()
Examples 
void setup() 
{
  Serial.begin(9600);
  String str1 = String("CCCP");
  String str2 = String("ccCP");
  // Tests to see if str1 is equal to str2
  if (str1.equalsIgnoreCase(str2) == true) {
    Serial.println("Equal");  // They are equal ignoring case differences so this line will print
  } 
  else {
    Serial.println("Not equal");
  }
}

void loop() 
{
}

String str1 = String("CCCP");   
String str3 = String("cccp"); 
// Tests to see if str1 is equal to str3   

void setup() { 
  Serial.begin(9600); 
  if (str1.equalsIgnoreCase(str3) == true) {   
    Serial.println("Equal");  // They are equal ignoring case differences so this line will print
  }  
  else {   
    Serial.println("Not equal");
  }
} 

void loop() { 
  // Nothing for loop()
}
Description Compares two strings to see if they are equal ignoriong case differences. This method is necessary because it's not possible to compare strings using the equality operator (==). Returns true if the strings are the same and false if they are not.
Syntax 
equalsIgnoreCase(str)
Parameters
str String: any valid String
Returns boolean
Usage Application
Updated on July 07, 2011 11:09:06pm PDT

Creative Commons License