base32.h 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940
  1. // Base32 implementation
  2. //
  3. // Copyright 2010 Google Inc.
  4. // Author: Markus Gutschke
  5. //
  6. // Licensed under the Apache License, Version 2.0 (the "License");
  7. // you may not use this file except in compliance with the License.
  8. // You may obtain a copy of the License at
  9. //
  10. // http://www.apache.org/licenses/LICENSE-2.0
  11. //
  12. // Unless required by applicable law or agreed to in writing, software
  13. // distributed under the License is distributed on an "AS IS" BASIS,
  14. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15. // See the License for the specific language governing permissions and
  16. // limitations under the License.
  17. //
  18. // Encode and decode from base32 encoding using the following alphabet:
  19. // ABCDEFGHIJKLMNOPQRSTUVWXYZ234567
  20. // This alphabet is documented in RFC 4648/3548
  21. //
  22. // We allow white-space and hyphens, but all other characters are considered
  23. // invalid.
  24. //
  25. // All functions return the number of output bytes or -1 on error. If the
  26. // output buffer is too small, the result will silently be truncated.
  27. #pragma once
  28. #include <stddef.h>
  29. #include <stdint.h>
  30. /**
  31. * @brief Decodes Base-32 encoded bytes into plain bytes.
  32. * @param encoded Base-32 encoded bytes
  33. * @param[out] result result output buffer
  34. * @param bufSize result output buffer size
  35. * @return Decoded result length in bytes if successfully decoded; \c 0 otherwise
  36. */
  37. size_t base32_decode(const uint8_t* encoded, uint8_t* result, size_t bufSize);