aboutsummaryrefslogtreecommitdiffstats
path: root/src/base64.h
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2018-05-12 12:47:18 +0200
committerDavid Robillard <d@drobilla.net>2018-11-25 22:12:46 +0100
commit95e4ca4d49f8aa8e736d4a6743bf961c93cf7f69 (patch)
tree7863e81d6d920dab94f7ebbfad9a9445187b5c5d /src/base64.h
parent3b4397f6ce5fc4aecd1074f78db308cc14f07bb5 (diff)
downloadserd-95e4ca4d49f8aa8e736d4a6743bf961c93cf7f69.tar.gz
serd-95e4ca4d49f8aa8e736d4a6743bf961c93cf7f69.tar.bz2
serd-95e4ca4d49f8aa8e736d4a6743bf961c93cf7f69.zip
Separate base64 implementation
Diffstat (limited to 'src/base64.h')
-rw-r--r--src/base64.h45
1 files changed, 45 insertions, 0 deletions
diff --git a/src/base64.h b/src/base64.h
new file mode 100644
index 00000000..5b3a801d
--- /dev/null
+++ b/src/base64.h
@@ -0,0 +1,45 @@
+/*
+ Copyright 2011-2018 David Robillard <http://drobilla.net>
+
+ Permission to use, copy, modify, and/or distribute this software for any
+ purpose with or without fee is hereby granted, provided that the above
+ copyright notice and this permission notice appear in all copies.
+
+ THIS SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+*/
+
+#ifndef SERD_BASE64_H
+#define SERD_BASE64_H
+
+#include <stdbool.h>
+#include <stddef.h>
+
+/**
+ Return the number of bytes required to encode `size` bytes in base64.
+
+ @param size The number of input (binary) bytes to encode.
+ @param wrap_lines Whether to wrap lines at a fixed length.
+ @return The length of the base64 encoding, exclusing null terminator.
+*/
+size_t
+serd_base64_get_length(size_t size, bool wrap_lines);
+
+/**
+ Encode `size` bytes of `buf` into `str`, which must be large enough.
+
+ @param str Output string buffer.
+ @param buf Input binary data.
+ @param size Number of bytes to encode from `buf`.
+ @param wrap_lines Whether to wrap lines at a fixed length.
+ @return True iff `str` contains newlines.
+*/
+bool
+serd_base64_encode(char* str, const void* buf, size_t size, bool wrap_lines);
+
+#endif // SERD_BASE64_H