base64codec.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2005 by Marc Boris Duerner
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  * You should have received a copy of the GNU Lesser General Public
25  * License along with this library; if not, write to the Free Software
26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
27  */
28 #ifndef cxxtools_Base64Codec_h
29 #define cxxtools_Base64Codec_h
30 
31 #include <cxxtools/textcodec.h>
32 
33 namespace cxxtools
34 {
35 
36 class Base64Codec : public TextCodec<char, char>
37 {
38  public:
39  explicit Base64Codec(size_t ref = 0)
40  : TextCodec<char, char>(ref)
41  {}
42 
43  virtual ~Base64Codec()
44  {}
45 
46  protected:
47  result do_in(MBState& s,
48  const char* fromBegin,
49  const char* fromEnd,
50  const char*& fromNext,
51  char* toBegin,
52  char* toEnd,
53  char*& toNext) const;
54 
55  result do_out(MBState& s,
56  const char* fromBegin,
57  const char* fromEnd,
58  const char*& fromNext,
59  char* toBegin,
60  char* toEnd,
61  char*& toNext) const;
62 
63  result do_unshift(MBState& state,
64  char* toBegin,
65  char* toEnd,
66  char*& toNext) const;
67 
68  bool do_always_noconv() const throw()
69  {
70  return false;
71  }
72 
73  int do_length(MBState& /*s*/, const char* fromBegin,
74  const char* fromEnd, size_t max) const
75  {
76  const int from = (fromEnd - fromBegin) / 4;
77  const int to = max / 3;
78  return to > from ? from * 4 : to * 4;
79  }
80 
81  int do_encoding() const throw()
82  {
83  // stateful encoding
84  return -1;
85  }
86 
87  int do_max_length() const throw()
88  {
89  //worst case: XX== -> x
90  return 4;
91  }
92 
93  public:
101  static std::string decode(const char* data, unsigned size)
102  { return cxxtools::decode<Base64Codec>(data, size); }
105  static std::string decode(const std::string& data)
106  { return cxxtools::decode<Base64Codec>(data); }
107 
110  static std::string encode(const char* data, unsigned size)
111  { return cxxtools::encode<Base64Codec>(data, size); }
112 
115  static std::string encode(const std::string& data)
116  { return cxxtools::encode<Base64Codec>(data); }
117 };
118 
119 
120 } //namespace cxxtools
121 
122 #endif