Files
xmlada/unicode/unicode-ccs.ads
Emmanuel Briot 53dc51bf5c Update copyright notices
Change-Id: Iae1283292b460ead48dedc565d6f24259e497e69
2017-01-03 10:02:38 +01:00

73 lines
3.4 KiB
Ada

------------------------------------------------------------------------------
-- XML/Ada - An XML suite for Ada95 --
-- --
-- Copyright (C) 2001-2017, AdaCore --
-- --
-- This library is free software; you can redistribute it and/or modify it --
-- under terms of the GNU General Public License as published by the Free --
-- Software Foundation; either version 3, or (at your option) any later --
-- version. This library is distributed in the hope that it will be useful, --
-- but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHAN- --
-- TABILITY or FITNESS FOR A PARTICULAR PURPOSE. --
-- --
-- As a special exception under Section 7 of GPL version 3, you are granted --
-- additional permissions described in the GCC Runtime Library Exception, --
-- version 3.1, as published by the Free Software Foundation. --
-- --
-- You should have received a copy of the GNU General Public License and --
-- a copy of the GCC Runtime Library Exception along with this program; --
-- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
-- <http://www.gnu.org/licenses/>. --
-- --
------------------------------------------------------------------------------
-- This is the root of the hierarchy that provides coded character sets.
-- These CCS can be used to convert from any encoding (like Iso/Latin-1)
-- to Unicode.
-- See http://www.isoc.org:8080/codage/iso8859/jeuxiso.en.htm for a list
-- of the ISO 8859-* character sets
-- ??? URL above is invalid
package Unicode.CCS is
-- Each of the child package shall have two public functions with
-- the following profile:
-- function Convert (Char : Unicode_Char) return Unicode_Char
-- that converts from a code point representing an abstract character in
-- the specific encoding to the code point for the same character in
-- Unicode, or reverse.
-- ??? This is not consistent with the specification of type Unicode_Char,
-- which states that values of Unicode_Char always are code points in
-- the Unicode repertoire.
type Conversion_Function is access
function (Char : Unicode_Char) return Unicode_Char;
type Character_Set is record
To_Unicode : Conversion_Function;
To_CS : Conversion_Function;
end record;
--------------------
-- Character sets --
--------------------
function Identity (Char : Unicode_Char) return Unicode_Char;
-- return its parameter directly.
Unicode_Character_Set : constant Character_Set :=
(To_Unicode => Identity'Access,
To_CS => Identity'Access);
Invalid_Code : exception;
-- Exception raised when trying to convert to a code point that
-- is not available in the specific character set. This can never be
-- raised when converting to Unicode, since it is universal by definition.
Unknown_Character_Set : exception;
-- Raised by Get_Conversion or Get_Revert_Conversion when the name is
-- unknown.
end Unicode.CCS;