blob: 98f6ff96609417ba00c1032e7926b2b92172c4d2 (
plain)
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
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/***************************************************************************
* utf8.h
*
* Tue Feb 27 19:18:23 CET 2007
* Copyright 2006 Bent Bisballe Nyeng
* deva@aasimon.org
****************************************************************************/
/*
* This file is part of Artefact.
*
* Artefact 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.
*
* Artefact 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 Artefact; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
*/
#ifndef __ARTEFACT_UTF8_H__
#define __ARTEFACT_UTF8_H__
#include <string>
#include <map>
#include "exception.h"
/**
* This exception is thrown by UTF8 when the subsystem fails to initialize.
*/
class UTF8CreateException: public Exception {
public:
UTF8CreateException(std::string reason) :
Exception("Error during creation of the UTF8 subsystem: " + reason) {}
};
/**
* This exception is thrown by UTF8 when the subsystem fails encode the gives string.
*/
class UTF8EncodeException: public Exception {
public:
UTF8EncodeException(std::string reason) :
Exception("Error during UTF8 encoding: " + reason) {}
};
/**
* This exception is thrown by UTF8 when the subsystem fails decode the gives string.
*/
class UTF8DecodeException: public Exception {
public:
UTF8DecodeException(std::string reason) :
Exception("Error during UTF8 decoding: " + reason) {}
};
/**
* UTF-8 handler class.\n
* It is used to convert between UTF-8 and some native charset Default
* is ISO-8859-1. (Currently only the ISO-8859-1 charset is implemented!)
*/
class UTF8 {
public:
/**
* Constructor.
* @param encoding A string containing native charset. Default is ISO-8859-1
*/
UTF8(std::string encoding = "ISO-8859-1") throw(UTF8CreateException);
/**
* Encode a string from native encoding to UTF-8
* @param s The string to encode.
* @return The UTF-8 encoded string.
*/
std::string encode(std::string s) throw(UTF8EncodeException);
/**
* Decode a string from UTF-8 to native encoding.
* @param s The UTF-8 string to decode.
* @return The decoded string.
*/
std::string decode(std::string s) throw(UTF8DecodeException);
private:
std::string encoding;
std::map< std::string, std::string > map_encode;
std::map< std::string, std::string > map_decode;
};
#endif/*__ARTEFACT_UTF8_H__*/
|
