Host.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_SRC_ANYP_HOST_H
#define SQUID_SRC_ANYP_HOST_H
 
#include "dns/forward.h"
#include "ip/Address.h"
#include "sbuf/SBuf.h"
 
#include <iosfwd>
#include <optional>
#include <variant>
 
namespace AnyP
{
 
class Host
{
public:
    static std::optional<Host> ParseIp(const Ip::Address &);
 
    static std::optional<Host> ParseSimpleDomainName(const SBuf &);
 
    static std::optional<Host> ParseWildDomainName(const SBuf &);
 
    // Accessor methods below are mutually exclusive: Exactly one method is
    // guaranteed to return a result other than std::nullopt.
 
    auto ip() const { return std::get_if<Ip::Address>(&raw_); }
 
    auto domainName() const { return std::get_if<SBuf>(&raw_); }
 
private:
    using Storage = std::variant<Ip::Address, Dns::DomainName>;
 
    static std::optional<Host> ParseDomainName(const SBuf &);
 
    // use a Parse*() function to create Host objects
    Host(const Storage &raw): raw_(raw) {}
 
    Storage raw_; 
};
 
class Bracketed
{
public:
    explicit Bracketed(const Host &aHost): host(aHost) {}
    const Host &host;
};
 
std::ostream &operator <<(std::ostream &, const Host &);
 
std::ostream &operator <<(std::ostream &, const Bracketed &);
 
} // namespace Anyp
 
#endif /* SQUID_SRC_ANYP_HOST_H */