aboutsummaryrefslogtreecommitdiff
path: root/libbutl/base64.hxx
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2021-09-28 19:24:31 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2021-09-28 20:29:59 +0300
commitdf1ef68cd8e8582724ce1192bfc202e0b9aeaf0c (patch)
treeb731ca4c68e60c00c7e7d499dbf4868ee7b71f44 /libbutl/base64.hxx
parent7a4fc37f264cdb67f2f83fa92703c869215bbc86 (diff)
Get rid of C++ modules related code and rename *.mxx files to *.hxx
Diffstat (limited to 'libbutl/base64.hxx')
-rw-r--r--libbutl/base64.hxx46
1 files changed, 46 insertions, 0 deletions
diff --git a/libbutl/base64.hxx b/libbutl/base64.hxx
new file mode 100644
index 0000000..f38e62f
--- /dev/null
+++ b/libbutl/base64.hxx
@@ -0,0 +1,46 @@
+// file : libbutl/base64.hxx -*- C++ -*-
+// license : MIT; see accompanying LICENSE file
+
+#pragma once
+
+#include <iosfwd>
+#include <string>
+#include <vector>
+
+#include <libbutl/export.hxx>
+
+namespace butl
+{
+ // Base64-encode a stream or a buffer. Split the output into 76 char-long
+ // lines (new line is the 77th). If reading from a stream, check if it has
+ // badbit, failbit, or eofbit set and throw invalid_argument if that's the
+ // case. Otherwise, set eofbit on completion. If writing to a stream, check
+ // if it has badbit, failbit, or eofbit set and throw invalid_argument if
+ // that's the case. Otherwise set badbit if the write operation fails.
+ //
+ LIBBUTL_SYMEXPORT void
+ base64_encode (std::ostream&, std::istream&);
+
+ LIBBUTL_SYMEXPORT std::string
+ base64_encode (std::istream&);
+
+ LIBBUTL_SYMEXPORT std::string
+ base64_encode (const std::vector<char>&);
+
+ // Base64-decode a stream or a string. Throw invalid_argument if the input
+ // is not a valid base64 representation. If reading from a stream, check if
+ // it has badbit, failbit, or eofbit set and throw invalid_argument if
+ // that's the case. Otherwise, set eofbit on completion. If writing to a
+ // stream, check if it has badbit, failbit, or eofbit set and throw
+ // invalid_argument if that's the case. Otherwise set badbit if the write
+ // operation fails.
+ //
+ LIBBUTL_SYMEXPORT void
+ base64_decode (std::ostream&, std::istream&);
+
+ LIBBUTL_SYMEXPORT void
+ base64_decode (std::ostream&, const std::string&);
+
+ LIBBUTL_SYMEXPORT std::vector<char>
+ base64_decode (const std::string&);
+}