Character Analysis

[Characters]

isAlphaNumeric(thisChar)

Description

Analyse if a char is alphanumeric (a-z or A-Z or 0-9).

Parameters

thisChar: the char to be analysed.

Returns

True or false.

isAlpha(thisChar)

Description

Analyse if a char is is alpha (a-z or A-Z).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isAscii(thisChar)

Description

Analyse if a char is ASCII. (Visit the wiki website to get the detail for ASCII character set)

Parameters

thisChar: the char to be analysed

Returns

True or false.

isWhitespace(thisChar)

Description

Analyse if a char is a white space (‘ ‘ or ‘\t’).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isControl(thisChar)

Description

Analyse if a char is a control character. (Visit the wiki website to get detail for control character)

Parameters

thisChar: the char to be analysed

Returns

True or false.

isDigit(thisChar)

Description

Analyse if a char is a digit (0-9).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isGraph(thisChar)

Description

Analyse if a char is a printable character (not including space character: ‘ ‘).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isLowerCase(thisChar)

Description

Analyse if a char is a lower case character.

Parameters

thisChar: the char to be analysed

Returns

True or false.

isPrintable(thisChar)

Description

Analyse if a char is a printable character (including space character: ‘ ‘).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isPunct(thisChar)

Description

Analyse if a char is punctuation character.

Parameters

thisChar: the char to be analysed

Returns

True or false.

isSpace(thisChar)

Description

Analyse if a char is a space character (‘ ‘, ‘\f’, ‘\n’, ‘\r’, ‘\t’, ‘\v’ characters).

Parameters

thisChar: the char to be analysed

Returns

True or false.

isUpperCase(thisChar)

Description

Analyse if a char is an upper case character.

Parameters

thisChar: the char to be analysed

Returns

True or false.

isHexadecimalDigit(thisChar)

Description

Analyse if a char is a valid hexadecimal digit (0-9 and A-F).

Parameters

thisChar: the char to be analysed

Returns

True or false.

Example Code

/*
  Character analysis operators
 
 Examples using the character analysis operators.
 Send any byte and the sketch will tell you about it.
 
 created 29 Nov 2010
 modified 2 Apr 2012
 by Tom Igoe
 
 This example code is in the public domain.
 */
 
void setup() {
  // Open serial communications and wait for port to open:
  Serial.begin(9600);
  while (!Serial) {
    ; // wait for serial port to connect. Needed for native USB port only
  }
 
  // send an intro:
  Serial.println("send any byte and I'll tell you everything I can about it");
  Serial.println();
}
 
void loop() {
  // get any incoming bytes:
  if (Serial.available() > 0) {
    int thisChar = Serial.read();
 
    // say what was sent:
    Serial.print("You sent me: \'");
    Serial.write(thisChar);
    Serial.print("\'  ASCII Value: ");
    Serial.println(thisChar);
 
    // analyze what was sent:
    if (isAlphaNumeric(thisChar)) {
      Serial.println("it's alphanumeric");
    }
    if (isAlpha(thisChar)) {
      Serial.println("it's alphabetic");
    }
    if (isAscii(thisChar)) {
      Serial.println("it's ASCII");
    }
    if (isWhitespace(thisChar)) {
      Serial.println("it's whitespace");
    }
    if (isControl(thisChar)) {
      Serial.println("it's a control character");
    }
    if (isDigit(thisChar)) {
      Serial.println("it's a numeric digit");
    }
    if (isGraph(thisChar)) {
      Serial.println("it's a printable character that's not whitespace");
    }
    if (isLowerCase(thisChar)) {
      Serial.println("it's lower case");
    }
    if (isPrintable(thisChar)) {
      Serial.println("it's printable");
    }
    if (isPunct(thisChar)) {
      Serial.println("it's punctuation");
    }
    if (isSpace(thisChar)) {
      Serial.println("it's a space character");
    }
    if (isUpperCase(thisChar)) {
      Serial.println("it's upper case");
    }
    if (isHexadecimalDigit(thisChar)) {
      Serial.println("it's a valid hexadecimaldigit (i.e. 0 - 9, a - F, or A - F)");
    }
 
    // add some space and ask for another byte:
    Serial.println();
    Serial.println("Give me another byte:");
    Serial.println();
  }
}

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.