base32.h 1.4 KB

123456789101112131415161718192021222324252627282930313233343536373839
  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 <stdint.h>
  29. /**
  30. * @brief Decodes Base-32 encoded bytes into plain bytes.
  31. * @param encoded Base-32 encoded bytes
  32. * @param[out] result result output buffer
  33. * @param bufSize result output buffer size
  34. * @return Decoded result length in bytes if successfully decoded; \c -1 otherwise
  35. */
  36. int base32_decode(const uint8_t* encoded, uint8_t* result, int bufSize);