A.3.5 The Package Wide_Characters.Handling
1/3
{
AI05-0185-1}
The package Wide_Characters.Handling provides operations
for classifying Wide_Characters and case folding for Wide_Characters.
Static Semantics
2/3
{
AI05-0185-1}
The library package Wide_Characters.Handling has
the following declaration:3/3
package Ada.Wide_Characters.Handling is
4/3
function Is_Control (Item : Wide_Character) return Boolean;
5/3
function Is_Letter (Item : Wide_Character) return Boolean;
6/3
function Is_Lower (Item : Wide_Character) return Boolean;
7/3
function Is_Upper (Item : Wide_Character) return Boolean;
8/3
function Is_Digit (Item : Wide_Character) return Boolean;
9/3
function Is_Decimal_Digit (Item : Wide_Character) return Boolean
renames Is_Digit;
10/3
function Is_Hexadecimal_Digit (Item : Wide_Character) return Boolean;
11/3
function Is_Alphanumeric (Item : Wide_Character) return Boolean;
12/3
function Is_Special (Item : Wide_Character) return Boolean;
13/3
function Is_Line_Terminator (Item : Wide_Character) return Boolean;
14/3
function Is_Mark (Item : Wide_Character) return Boolean;
15/3
function Is_Other_Format (Item : Wide_Character) return Boolean;
16/3
function Is_Punctuation_Connector (Item : Wide_Character) return Boolean;
17/3
function Is_Space (Item : Wide_Character) return Boolean;
18/3
function Is_Graphic (Item : Wide_Character) return Boolean;
19/3
function To_Lower (Item : Wide_Character) return Wide_Character;
function To_Upper (Item : Wide_Character) return Wide_Character;
20/3
function To_Lower (Item : Wide_String) return Wide_String;
function To_Upper (Item : Wide_String) return Wide_String;
21/3
end Ada.Wide_Characters.Handling;
22/3
{
AI05-0185-1}
The subprograms defined in Wide_Characters.Handling
are locale independent.23/3
function Is_Control (Item : Wide_Character) return Boolean;
24/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as other_control, otherwise
returns False.25/3
function Is_Letter (Item : Wide_Character) return Boolean;
26/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as letter_uppercase, letter_lowercase,
letter_titlecase, letter_modifier,
letter_other, or number_letter;
otherwise returns False.27/3
function Is_Lower (Item : Wide_Character) return Boolean;
28/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as letter_lowercase, otherwise
returns False.29/3
function Is_Upper (Item : Wide_Character) return Boolean;
30/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as letter_uppercase, otherwise
returns False.31/3
function Is_Digit (Item : Wide_Character) return Boolean;
32/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as number_decimal, otherwise
returns False.33/3
function Is_Hexadecimal_Digit (Item : Wide_Character) return Boolean;
34/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as number_decimal, or
is in the range 'A' .. 'F' or 'a' .. 'f', otherwise returns False.35/3
function Is_Alphanumeric (Item : Wide_Character) return Boolean;
36/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as letter_uppercase, letter_lowercase,
letter_titlecase, letter_modifier,
letter_other, number_letter,
or number_decimal; otherwise returns False.37/3
function Is_Special (Item : Wide_Character) return Boolean;
38/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as graphic_character,
but not categorized as letter_uppercase, letter_lowercase,
letter_titlecase, letter_modifier,
letter_other, number_letter,
or number_decimal; otherwise returns False.39/3
function Is_Line_Terminator (Item : Wide_Character) return Boolean;
40/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as separator_line or separator_paragraph,
or if Item is a conventional line terminator character (Line_Feed, Line_Tabulation,
Form_Feed, Carriage_Return, Next_Line); otherwise returns False.41/3
function Is_Mark (Item : Wide_Character) return Boolean;
42/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as mark_non_spacing or
mark_spacing_combining, otherwise returns
False.43/3
function Is_Other_Format (Item : Wide_Character) return Boolean;
44/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as other_format, otherwise
returns False.45/3
function Is_Punctuation_Connector (Item : Wide_Character) return Boolean;
46/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as punctuation_connector,
otherwise returns False.47/3
function Is_Space (Item : Wide_Character) return Boolean;
48/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as separator_space, otherwise
returns False.49/3
function Is_Graphic (Item : Wide_Character) return Boolean;
50/3
{
AI05-0185-1}
Returns True if the Wide_Character designated by
Item is categorized as graphic_character,
otherwise returns False.51/3
function To_Lower (Item : Wide_Character) return Wide_Character;
52/3
{
AI05-0185-1}
Returns the Simple Lowercase Mapping as defined
by documents referenced in the note in section 1 of ISO/IEC 10646:2003
of the Wide_Character designated by Item. If the Simple Lowercase Mapping
does not exist for the Wide_Character designated by Item, then the value
of Item is returned.52.a/3
Discussion: The
case mappings come from Unicode as ISO/IEC 10646:2003 does not include
case mappings (but rather references the Unicode ones as above).
53/3
function To_Lower (Item : Wide_String) return Wide_String;
54/3
{
AI05-0185-1}
Returns the result of applying the To_Lower conversion
to each Wide_Character element of the Wide_String designated by Item.
The result is the null Wide_String if the value of the formal parameter
is the null Wide_String. The lower bound of the result Wide_String is
1.55/3
function To_Upper (Item : Wide_Character) return Wide_Character;
56/3
{
AI05-0185-1}
Returns the Simple Uppercase Mapping as defined
by documents referenced in the note in section 1 of ISO/IEC 10646:2003
of the Wide_Character designated by Item. If the Simple Uppercase Mapping
does not exist for the Wide_Character designated by Item, then the value
of Item is returned.57/3
function To_Upper (Item : Wide_String) return Wide_String;
58/3
{
AI05-0185-1}
Returns the result of applying the To_Upper conversion
to each Wide_Character element of the Wide_String designated by Item.
The result is the null Wide_String if the value of the formal parameter
is the null Wide_String. The lower bound of the result Wide_String is
1.Extensions to Ada 2005
58.a/3
{
AI05-0185-1}
The package Wide_Characters.Handling
is new.
Ada 2005 and 2012 Editions sponsored in part by Ada-Europe
