base64.hpp

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT License.
 
#pragma once
 
#include <algorithm>
#include <cstdint> // defines std::uint8_t
#include <stdexcept>
#include <stdint.h> // deprecated, defines uint8_t in global namespace. TODO: Remove when uint8_t in the global namespace is removed.
#include <string>
#include <vector>
 
namespace Azure { namespace Core {
 
  class Convert final {
  private:
    // This type currently only contains static methods and hence disallowing instance creation.
    Convert() = default;
 
  public:
    static std::string Base64Encode(const std::vector<uint8_t>& data);
 
    static std::vector<uint8_t> Base64Decode(const std::string& text);
  };
 
  namespace _internal {
    class Convert final {
    private:
      // This type currently only contains static methods and hence disallowing instance creation.
      Convert() = default;
 
    public:
      static std::string Base64Encode(const std::string& data);
    };
 
    class Base64Url final {
 
    public:
      static std::string Base64UrlEncode(const std::vector<uint8_t>& data)
      {
        auto base64 = Azure::Core::Convert::Base64Encode(data);
        // update to base64url
        auto trail = base64.find('=');
        if (trail != std::string::npos)
        {
          base64 = base64.substr(0, trail);
        }
        std::replace(base64.begin(), base64.end(), '+', '-');
        std::replace(base64.begin(), base64.end(), '/', '_');
        return base64;
      }
 
      static std::vector<uint8_t> Base64UrlDecode(const std::string& text)
      {
        std::string base64url(text);
        // base64url to base64
        std::replace(base64url.begin(), base64url.end(), '-', '+');
        std::replace(base64url.begin(), base64url.end(), '_', '/');
        switch (base64url.size() % 4)
        {
          case 0:
            break;
          case 2:
            base64url.append("==");
            break;
          case 3:
            base64url.append("=");
            break;
          default:
            throw std::invalid_argument("Unexpected Base64URL encoding in the HTTP response.");
        }
        return Azure::Core::Convert::Base64Decode(base64url);
      }
    };
  } // namespace _internal
 
}} // namespace Azure::Core