Library: Foundation
Package: Core
Header: Poco/Ascii.h
This class contains enumerations and static utility functions for dealing with ASCII characters and their properties.
The classification functions will also work if non-ASCII character codes are passed to them, but classification will only check for ASCII characters.
This allows the classification methods to be used on the single bytes of a UTF-8 string, without causing assertions or inconsistent results (depending upon the current locale) on bytes outside the ASCII range, as may be produced by Ascii::isSpace(), etc.
Member Functions: hasProperties, hasSomeProperties, isAlpha, isAlphaNumeric, isAscii, isDigit, isHexDigit, isLower, isPunct, isSpace, isUpper, properties, toLower, toUpper
ASCII character properties.
ACP_CONTROL = 0x0001
ACP_SPACE = 0x0002
ACP_PUNCT = 0x0004
ACP_DIGIT = 0x0008
ACP_HEXDIGIT = 0x0010
ACP_ALPHA = 0x0020
ACP_LOWER = 0x0040
ACP_UPPER = 0x0080
ACP_GRAPH = 0x0100
ACP_PRINT = 0x0200
static bool hasProperties(
int ch,
int properties
);
Returns true if the given character is within the ASCII range and has all of the given properties.
static bool hasSomeProperties(
int ch,
int properties
);
Returns true if the given character is within the ASCII range and has at least one of the given properties.
static bool isAlpha(
int ch
);
Returns true if and only if the given character is an alphabetic character.
static bool isAlphaNumeric(
int ch
);
Returns true if and only if the given character is an alphabetic character.
static bool isAscii(
int ch
);
Returns true if and only if the given character code is within the ASCII range (0 .. 127).
static bool isDigit(
int ch
);
Returns true if and only if the given character is a digit.
static bool isHexDigit(
int ch
);
Returns true if and only if the given character is a hexadecimal digit.
static bool isLower(
int ch
);
Returns true if and only if the given character is a lowercase alphabetic character.
static bool isPunct(
int ch
);
Returns true if and only if the given character is a punctuation character.
static bool isSpace(
int ch
);
Returns true if and only if the given character is a whitespace.
static bool isUpper(
int ch
);
Returns true if and only if the given character is an uppercase alphabetic character.
static int properties(
int ch
);
Return the ASCII character properties for the character with the given ASCII value.
If the character is outside the ASCII range (0 .. 127), 0 is returned.
static int toLower(
int ch
);
If the given character is an uppercase character, return its lowercase counterpart, otherwise return the character.
static int toUpper(
int ch
);
If the given character is a lowercase character, return its uppercase counterpart, otherwise return the character.