1 /*****************************************************************
2 |
3 |   Neptune - Base64
4 |
5 | Copyright (c) 2002-2008, Axiomatic Systems, LLC.
6 | All rights reserved.
7 |
8 | Redistribution and use in source and binary forms, with or without
9 | modification, are permitted provided that the following conditions are met:
10 |     * Redistributions of source code must retain the above copyright
11 |       notice, this list of conditions and the following disclaimer.
12 |     * Redistributions in binary form must reproduce the above copyright
13 |       notice, this list of conditions and the following disclaimer in the
14 |       documentation and/or other materials provided with the distribution.
15 |     * Neither the name of Axiomatic Systems nor the
16 |       names of its contributors may be used to endorse or promote products
17 |       derived from this software without specific prior written permission.
18 |
19 | THIS SOFTWARE IS PROVIDED BY AXIOMATIC SYSTEMS ''AS IS'' AND ANY
20 | EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
21 | WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
22 | DISCLAIMED. IN NO EVENT SHALL AXIOMATIC SYSTEMS BE LIABLE FOR ANY
23 | DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
24 | (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 | LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
26 | ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
27 | (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
28 | SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 |
30 ****************************************************************/
31 
32 #ifndef _NPT_BASE64_H_
33 #define _NPT_BASE64_H_
34 
35 /*----------------------------------------------------------------------
36 |   includes
37 +---------------------------------------------------------------------*/
38 #include "NptDataBuffer.h"
39 #include "NptStrings.h"
40 
41 /*----------------------------------------------------------------------
42 |   constants
43 +---------------------------------------------------------------------*/
44 const NPT_Cardinal NPT_BASE64_MIME_BLOCKS_PER_LINE = 19;
45 const NPT_Cardinal NPT_BASE64_PEM_BLOCKS_PER_LINE  = 16;
46 
47 /*----------------------------------------------------------------------
48 |   NPT_Base64
49 +---------------------------------------------------------------------*/
50 class NPT_Base64 {
51 public:
52     // class methods
53     static NPT_Result Decode(const char*     base64,
54                              NPT_Size        size,
55                              NPT_DataBuffer& data,
56                              bool            url_safe = false);
57     static NPT_Result Encode(const NPT_Byte* data,
58                              NPT_Size        size,
59                              NPT_String&     base64,
60                              NPT_Cardinal    max_blocks_per_line = 0,
61                              bool            url_safe = false);
62 
63 private:
64     // this class is purely static
65     NPT_Base64();
66 };
67 
68 #endif // _NPT_BASE64_H_
69