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

equals()

Examples
String str1 = String("CCCP");
String str2 = String("CCCP");
// Tests to see if str1 is equal to str2
if (str1.equals(str2) == true) {
  // They are equal so this line will print
  Serial.println("Equal");  
} else {
  Serial.println("Not equal");
}

String str1 = String("CCCP");   
String str3 = String("CCCP"); 
// Tests to see if str1 is equal to str3   
 
void setup() { 
  Serial.begin(9600); 
  if (str1.equals(str3) == true) {   
    Serial.println("Equal");  // They are equal so this line will print   
  }  
  else {   
    Serial.println("Not equal");   
  }  
} 
 
void loop() { 
  // Nothing for loop() 
}
Description Compares two strings to see if they are the same. 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
equals(str)
Parameters
str String: any valid String
Returns boolean
Usage Application
Updated on July 07, 2011 11:09:05pm PDT

Creative Commons License