1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
-- --
-- package Copyright (c) Dmitry A. Kazakov --
-- Strings_Edit.UTF8.Handling Luebeck --
-- Interface Spring, 2005 --
-- --
-- Last revision : 10:11 25 Jun 2005 --
-- --
-- This library is free software; you can redistribute it and/or --
-- modify it under the terms of the GNU General Public License as --
-- published by the Free Software Foundation; either version 2 of --
-- the License, 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 --
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU --
-- General Public License for more details. You should have --
-- received a copy of the GNU General Public License along with --
-- this library; if not, write to the Free Software Foundation, --
-- Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. --
-- --
-- --
-- --
-- --
-- --
-- --
-- --
--____________________________________________________________________--
--
-- This package provides conversions between UTF-8 strings and standard
-- Ada's strings and characters.
--
package Strings_Edit.UTF8.Handling is
--
-- To_String -- Conversion from UTF-8 to Latin-1
--
-- Value - The UTF-8 string to convert
-- [ Substitute ] - For non-Latin-1 code points
--
-- These functions convert a UTF-8 encoded string to Latin-1 character
-- string (standard Ada string). The parameter Substitute specifies the
-- character that substitutes non-Latin-1 code points in Value. If
-- omitted Constraint_Error is propagated when non-Latin-1 code points
-- appear in Value.
--
-- Returns :
--
-- Latin-1 equivalent
--
-- Exceptions :
--
-- Constraint_Error - Non-Latin-1 code points in Value
-- Data_Error - Illegal UTF-8 string
--
function To_String (Value : String) return String;
function To_String
( Value : String;
Substitute : Character
) return String;
--
-- To_UTF8 -- Conversion to UTF-8
--
-- Value - Character or a string
--
-- These functions convert the parameter Value to a UTF-8 encoded
-- string. The parameter can be Character, String, Wide_Character or
-- Wide_String. The result can be from 1 to 3 bytes long. Note that
-- Character has Latin-1 encoding which differs from UTF-8 in the
-- positions greater than 127.
--
-- Returns :
--
-- Value encoded in UTF-8
--
function To_UTF8 (Value : Character ) return String;
function To_UTF8 (Value : String ) return String;
function To_UTF8 (Value : Wide_Character) return String;
function To_UTF8 (Value : Wide_String ) return String;
--
-- To_Wide_String -- Conversion from UTF-8 to UCS-2
--
-- Value - The UTF-8 string to convert
-- [ Substitute ] - For non-Latin-1 code points
--
-- These functions convert a UTF-8 encoded string to UCS-2 character
-- string (Ada's Wide_String). The parameter Substitute specifies the
-- character that substitutes non-UCS-2 code points in Value. If omitted
-- Constraint_Error is propagated when non-UCS-2 characters appear in
-- Value.
--
-- Returns :
--
-- UCS-2 equivalent
--
-- Exceptions :
--
-- Constraint_Error - Non-UCS-2 code point in Value
-- Data_Error - Illegal UTF-8 string
--
function To_Wide_String (Value : String) return Wide_String;
function To_Wide_String
( Value : String;
Substitute : Wide_Character
) return Wide_String;
end Strings_Edit.UTF8.Handling;
|
