1 /*
2  * Copyright (C) 2006 Alexey Proskuryakov <ap@webkit.org>
3  * Copyright (C) 2010 Patrick Gansterer <paroga@paroga.com>
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY
15  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE COMPUTER, INC. OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  */
26 
27 #ifndef Base64_h
28 #define Base64_h
29 
30 #include <wtf/Vector.h>
31 #include <wtf/text/CString.h>
32 #include <wtf/text/WTFString.h>
33 
34 namespace WebCore {
35 
36 enum Base64DecodePolicy { FailOnInvalidCharacter, IgnoreWhitespace, IgnoreInvalidCharacters };
37 
38 void base64Encode(const char*, unsigned, Vector<char>&, bool insertLFs = false);
39 void base64Encode(const Vector<char>&, Vector<char>&, bool insertLFs = false);
40 void base64Encode(const CString&, Vector<char>&, bool insertLFs = false);
41 String base64Encode(const char*, unsigned, bool insertLFs = false);
42 String base64Encode(const Vector<char>&, bool insertLFs = false);
43 String base64Encode(const CString&, bool insertLFs = false);
44 
45 bool base64Decode(const String&, Vector<char>&, Base64DecodePolicy = FailOnInvalidCharacter);
46 bool base64Decode(const Vector<char>&, Vector<char>&, Base64DecodePolicy = FailOnInvalidCharacter);
47 bool base64Decode(const char*, unsigned, Vector<char>&, Base64DecodePolicy = FailOnInvalidCharacter);
48 
base64Encode(const Vector<char> & in,Vector<char> & out,bool insertLFs)49 inline void base64Encode(const Vector<char>& in, Vector<char>& out, bool insertLFs)
50 {
51     base64Encode(in.data(), in.size(), out, insertLFs);
52 }
53 
base64Encode(const CString & in,Vector<char> & out,bool insertLFs)54 inline void base64Encode(const CString& in, Vector<char>& out, bool insertLFs)
55 {
56     base64Encode(in.data(), in.length(), out, insertLFs);
57 }
58 
base64Encode(const Vector<char> & in,bool insertLFs)59 inline String base64Encode(const Vector<char>& in, bool insertLFs)
60 {
61     return base64Encode(in.data(), in.size(), insertLFs);
62 }
63 
base64Encode(const CString & in,bool insertLFs)64 inline String base64Encode(const CString& in, bool insertLFs)
65 {
66     return base64Encode(in.data(), in.length(), insertLFs);
67 }
68 
69 } // namespace WebCore
70 
71 #endif // Base64_h
72