1 /*
2  * Copyright (C) 2012 Jiří Pinkava - Seznam.cz a. s.
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * As a special exception, you may use this file as part of a free
10  * software library without restriction. Specifically, if other files
11  * instantiate templates or use macros or inline functions from this
12  * file, or you compile this file and link it with other files to
13  * produce an executable, this file does not by itself cause the
14  * resulting executable to be covered by the GNU General Public
15  * License. This exception does not however invalidate any other
16  * reasons why the executable file might be covered by the GNU Library
17  * General Public License.
18  *
19  * This library is distributed in the hope that it will be useful,
20  * but WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
22  * Lesser General Public License for more details.
23  */
24 
25 #ifndef CXXTOOLS_ICONVWRAP_H
26 #define CXXTOOLS_ICONVWRAP_H
27 
28 #include <iconv.h>
29 
30 namespace cxxtools
31 {
32 
33   /** Wraps iconv. */
34 class iconvwrap {
35   public:
36 
37     /** Create iconvwrap object. */
38     iconvwrap();
39 
40     /** Create iconvwrap object and initializes it.
41      *
42      * @param tocode destination encoding name
43      * @param fromcode source encoding name
44      */
45     iconvwrap(const char *tocode, const char *fromcode);
46 
47     /** Close iconvwrap object, release resouces.
48      *
49      * @return true on succes, otherwise return false and set errno. */
50     bool close();
51 
52     /** Recode input string into output buffer.
53      *
54      * @param inbuf
55      * @param inbytesleft
56      * @param outbuf
57      * @param outbytesleft
58      * @return true if all succesfully converted, on error returns false
59      *      and se errno
60      */
61     bool convert(char **inbuf, size_t *inbytesleft,
62         char **outbuf, size_t *outbytesleft);
63 
64 
65     /** Return true if IConv is open, false otherwise. */
66     bool is_open();
67 
68     /** (Re)initializes iconvwrap object.
69      *
70      * @param tocode target encoding name
71      * @param fromcode source encoding name
72      * @return true on succes, on error return false and set errno
73      */
74     bool open(const char *tocode, const char *fromcode);
75 
76     /** Destroy iconvwrap object. */
77     ~iconvwrap();
78 
79   protected:
80     iconv_t cd;
81 };
82 
83 }
84 
85 #endif
86