gcc/ada/a-wichha.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                         GNAT RUN-TIME COMPONENTS                         --
   4 --                                                                          --
   5 --         A D A . W I D E _ C H A R A C T E R S . H A N D L I N G          --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                                                                          --
   9 -- This specification is derived from the Ada Reference Manual for use with --
  10 -- GNAT.  In accordance with the copyright of that document, you can freely --
  11 -- copy and modify this specification,  provided that if you redistribute a --
  12 -- modified version,  any changes that you have made are clearly indicated. --
  13 --                                                                          --
  14 ------------------------------------------------------------------------------
  15
  16 package Ada.Wide_Characters.Handling is
  17
  18    function Is_Control (Item : Wide_Character) return Boolean;
  19    pragma Inline (Is_Control);
  20    --  Returns True if the Wide_Character designated by Item is categorized as
  21    --  other_control, otherwise returns false.
  22
  23    function Is_Letter (Item : Wide_Character) return Boolean;
  24    pragma Inline (Is_Letter);
  25    --  Returns True if the Wide_Character designated by Item is categorized as
  26    --  letter_uppercase, letter_lowercase, letter_titlecase, letter_modifier,
  27    --  letter_other, or number_letter. Otherwise returns false.
  28
  29    function Is_Lower (Item : Wide_Character) return Boolean;
  30    pragma Inline (Is_Lower);
  31    --  Returns True if the Wide_Character designated by Item is categorized as
  32    --  letter_lowercase, otherwise returns false.
  33
  34    function Is_Upper (Item : Wide_Character) return Boolean;
  35    pragma Inline (Is_Upper);
  36    --  Returns True if the Wide_Character designated by Item is categorized as
  37    --  letter_uppercase, otherwise returns false.
  38
  39    function Is_Digit (Item : Wide_Character) return Boolean;
  40    pragma Inline (Is_Digit);
  41    --  Returns True if the Wide_Character designated by Item is categorized as
  42    --  number_decimal, otherwise returns false.
  43
  44    function Is_Decimal_Digit (Item : Wide_Character) return Boolean
  45      renames Is_Digit;
  46
  47    function Is_Hexadecimal_Digit (Item : Wide_Character) return Boolean;
  48    --  Returns True if the Wide_Character designated by Item is categorized as
  49    --  number_decimal, or is in the range 'A' .. 'F' or 'a' .. 'f', otherwise
  50    --  returns false.
  51
  52    function Is_Alphanumeric (Item : Wide_Character) return Boolean;
  53    pragma Inline (Is_Alphanumeric);
  54    --  Returns True if the Wide_Character designated by Item is categorized as
  55    --  number_decimal, or is in the range 'A' .. 'F' or 'a' .. 'f', otherwise
  56    --  returns false.
  57
  58    function Is_Special (Item : Wide_Character) return Boolean;
  59    pragma Inline (Is_Special);
  60    --  Returns True if the Wide_Character designated by Item is categorized
  61    --  as graphic_character, but not categorized as letter_uppercase,
  62    --  letter_lowercase, letter_titlecase, letter_modifier, letter_other,
  63    --  number_letter, or number_decimal. Otherwise returns false.
  64
  65    function Is_Line_Terminator (Item : Wide_Character) return Boolean;
  66    pragma Inline (Is_Line_Terminator);
  67    --  Returns True if the Wide_Character designated by Item is categorized as
  68    --  separator_line or separator_paragraph, or if Item is a conventional line
  69    --  terminator character (CR, LF, VT, or FF). Otherwise returns false.
  70
  71    function Is_Mark (Item : Wide_Character) return Boolean;
  72    pragma Inline (Is_Mark);
  73    --  Returns True if the Wide_Character designated by Item is categorized as
  74    --  mark_non_spacing or mark_spacing_combining, otherwise returns false.
  75
  76    function Is_Other (Item : Wide_Character) return Boolean;
  77    pragma Inline (Is_Other);
  78    --  Returns True if the Wide_Character designated by Item is categorized as
  79    --  other_format, otherwise returns false.
  80
  81    function Is_Punctuation (Item : Wide_Character) return Boolean;
  82    pragma Inline (Is_Punctuation);
  83    --  Returns True if the Wide_Character designated by Item is categorized as
  84    --  punctuation_connector, otherwise returns false.
  85
  86    function Is_Space (Item : Wide_Character) return Boolean;
  87    pragma Inline (Is_Space);
  88    --  Returns True if the Wide_Character designated by Item is categorized as
  89    --  separator_space, otherwise returns false.
  90
  91    function Is_Graphic (Item : Wide_Character) return Boolean;
  92    pragma Inline (Is_Graphic);
  93    --  Returns True if the Wide_Character designated by Item is categorized as
  94    --  graphic_character, otherwise returns false.
  95
  96    function To_Lower (Item : Wide_Character) return Wide_Character;
  97    pragma Inline (To_Lower);
  98    --  Returns the Simple Lowercase Mapping of the Wide_Character designated by
  99    --  Item. If the Simple Lowercase Mapping does not exist for the
 100    --  Wide_Character designated by Item, then the value of Item is returned.
 101
 102    function To_Lower (Item : Wide_String) return Wide_String;
 103    --  Returns the result of applying the To_Lower Wide_Character to
 104    --  Wide_Character conversion to each element of the Wide_String designated
 105    --  by Item. The result is the null Wide_String if the value of the formal
 106    --  parameter is the null Wide_String.
 107
 108    function To_Upper (Item : Wide_Character) return Wide_Character;
 109    pragma Inline (To_Upper);
 110    --  Returns the Simple Uppercase Mapping of the Wide_Character designated by
 111    --  Item. If the Simple Uppercase Mapping does not exist for the
 112    --  Wide_Character designated by Item, then the value of Item is returned.
 113
 114    function To_Upper (Item : Wide_String) return Wide_String;
 115    --  Returns the result of applying the To_Upper Wide_Character to
 116    --  Wide_Character conversion to each element of the Wide_String designated
 117    --  by Item. The result is the null Wide_String if the value of the formal
 118    --  parameter is the null Wide_String.
 119
 120 end Ada.Wide_Characters.Handling;