ContainsCharType
Mon 01 January 2018Syntax
ContainsCharType(source_str, char_code)
Description
Use the ContainsCharType function to determine if any of the characters in source_str are of type char_code. The char_code is a numerical value representing a character type (see the following Parameters section for details). Most character types supported by this function equate to specific Unicode character blocks or are based on Unicode character properties.
Parameters
Field or Control |
Definition |
---|---|
source_str |
String to be examined. |
char_code |
A number value representing the character type to be tested for. The following table shows valid values. You can specify either a character code numeric value or a constant: |
Numeric Value |
Constant |
Character Set |
---|---|---|
0 |
%CharType_AlphaNumeric |
Basic Latin â Alphanumeric (printable range of 7-bit US-ASCII), Unicode characters in the range U+0020 â U+007E |
1 |
%CharType_ExtendedLatin1 |
Extended Latin-1 characters (ISO 8859-1 accents for Western European languages), Unicode characters in the range U+00BF â U+07E |
2 |
%CharType_HankakuKatakana |
Hankaku Katakana (half-width Japanese Katakana) |
3 |
%CharType_ZenkakuKatakana |
Zenkaku Katakana (full-width Japanese Katakana) |
4 |
%CharType_Hiragana |
Hiragana (Japanese) |
5 |
%CharType_Kanji |
Chinese, Japanese and Korean ideographic characters. Includes Japanese Kanji, Chinese Hanzi and Korean Hancha. |
6 |
%CharType_DBAlphaNumeric |
Full-width Latin Alphanumeric characters, primarily used for Japanese. Excludes |
7 |
None |
Korean Hangul syllables, excluding Hangul Jamo. |
8,9 |
None |
Reserved for future use. |
10 |
%CharType_JapanesePunctuation |
Full- and half-width punctuation, including space (U+0020) and Fullwidth / Ideographic Space (U+3000). |
11 |
None |
Greek |
12 |
None |
Cyrillic |
13 |
None |
Armenian |
14 |
None |
Hebrew |
15 |
None |
Arabic |
16 |
None |
Devanagari |
17 |
None |
Bengali |
18 |
None |
Gurmukhi |
19 |
None |
Gujarati |
20 |
None |
Oriya |
21 |
None |
Tamil |
22 |
None |
Telugu |
23 |
None |
Kannada |
24 |
None |
Malayalam |
25 |
None |
Thai |
26 |
None |
Lao |
27 |
None |
Tibetan |
28 |
None |
Georgian |
29 |
None |
Bopomofo |
Returns
ContainsCharType returns one of the following Number values. You can check for the constant instead of the numeric value if you prefer:
Numeric Value |
Constant Value |
Description |
---|---|---|
1 |
%CharType_Matched |
String contains at least one character of set char_code . |
0 |
%CharType_NotMatched |
String contains no characters of set char_code . |
-1 |
%CharType_Unknown |
UNKNOWN: unable to determine whether character is of set char_code. This occurs if the character being checked is an unallocated Unicode codepoint, or was added in a version of Unicode greater than that supported by PeopleTools. |