ip.h

#ifndef SOURCEMETA_CORE_IP_H_
#define SOURCEMETA_CORE_IP_H_
 
#ifndef SOURCEMETA_CORE_IP_EXPORT
#include <sourcemeta/core/ip_export.h>
#endif
 
#include <cstdint>     // std::uint8_t
#include <optional>    // std::optional
#include <string_view> // std::string_view

 
namespace sourcemeta::core {

SOURCEMETA_CORE_IP_EXPORT
auto is_ipv4(std::string_view address) -> bool;

SOURCEMETA_CORE_IP_EXPORT
auto is_ipv6(std::string_view address) -> bool;

enum class IPAddressClass : std::uint8_t {
  Public,
  Loopback,
  Private,
  LinkLocal,
  UniqueLocal,
  Multicast,
  Reserved,
  Unspecified
};

SOURCEMETA_CORE_IP_EXPORT
auto ipv4_classify(const std::string_view address)
    -> std::optional<IPAddressClass>;

SOURCEMETA_CORE_IP_EXPORT
auto ipv6_classify(const std::string_view address)
    -> std::optional<IPAddressClass>;

SOURCEMETA_CORE_IP_EXPORT
auto ip_is_globally_routable(const std::string_view address) -> bool;
 
} // namespace sourcemeta::core
 
#endif