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/api.h>
32 #include <cxxtools/textcodec.h>
33 #include <cxxtools/string.h>
34 
35 namespace cxxtools
36 {
37 
38 class Base64Codec : public TextCodec<char, char>
39 {
40  public:
41  explicit Base64Codec(size_t ref = 0)
42  : TextCodec<char, char>(ref)
43  {}
44 
45  virtual ~Base64Codec()
46  {}
47 
48  protected:
49  result do_in(MBState& s,
50  const char* fromBegin,
51  const char* fromEnd,
52  const char*& fromNext,
53  char* toBegin,
54  char* toEnd,
55  char*& toNext) const;
56 
58  const char* fromBegin,
59  const char* fromEnd,
60  const char*& fromNext,
61  char* toBegin,
62  char* toEnd,
63  char*& toNext) const;
64 
65  result do_unshift(MBState& state,
66  char* toBegin,
67  char* toEnd,
68  char*& toNext) const;
69 
70  bool do_always_noconv() const throw()
71  {
72  return false;
73  }
74 
75  int do_length(MBState& s, const char* fromBegin,
76  const char* fromEnd, size_t max) const
77  {
78  const int from = (fromEnd - fromBegin) / 4;
79  const int to = max / 3;
80  return to > from ? from * 4 : to * 4;
81  }
82 
83  int do_encoding() const throw()
84  {
85  // stateful encoding
86  return -1;
87  }
88 
89  int do_max_length() const throw()
90  {
91  //worst case: XX== -> x
92  return 4;
93  }
94 
95  public:
103  static std::string decode(const char* data, unsigned size)
104  { return cxxtools::decode<Base64Codec>(data, size); }
107  static std::string decode(const std::string& data)
108  { return cxxtools::decode<Base64Codec>(data); }
109 
112  static std::string encode(const char* data, unsigned size)
113  { return cxxtools::encode<Base64Codec>(data, size); }
114 
117  static std::string encode(const std::string& data)
118  { return cxxtools::encode<Base64Codec>(data); }
119 };
120 
121 
122 } //namespace cxxtools
123 
124 #endif