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