diff options
author | David Robillard <d@drobilla.net> | 2020-08-14 15:51:14 +0200 |
---|---|---|
committer | David Robillard <d@drobilla.net> | 2020-08-14 19:07:52 +0200 |
commit | dee13339e45305ff0a15b3d50d7cbccdc4722b86 (patch) | |
tree | b0ee56c36cdebeffcd4d274b3e3b77b0f0de026e /src/base64.h | |
parent | 8827c4a88998b12cbfd2076c207d2d46e57b0b51 (diff) | |
download | serd-dee13339e45305ff0a15b3d50d7cbccdc4722b86.tar.gz serd-dee13339e45305ff0a15b3d50d7cbccdc4722b86.tar.bz2 serd-dee13339e45305ff0a15b3d50d7cbccdc4722b86.zip |
Separate base64 implementation
Diffstat (limited to 'src/base64.h')
-rw-r--r-- | src/base64.h | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/src/base64.h b/src/base64.h new file mode 100644 index 00000000..ab3dd0d9 --- /dev/null +++ b/src/base64.h @@ -0,0 +1,46 @@ +/* + 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> +#include <stdint.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 Wrap lines at 76 characters to conform to RFC 2045. + @return The length of the base64 encoding, excluding 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 Wrap lines at 76 characters to conform to RFC 2045. + @return True iff `str` contains newlines. +*/ +bool +serd_base64_encode(uint8_t* str, const void* buf, size_t size, bool wrap_lines); + +#endif // SERD_BASE64_H |