O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

nl :: Inet :: Endereço de IP

#include <src/inet/IPAddress.h>

Endereço de protocolo da Internet.

Resumo

A camada Nest Inet usa objetos dessa classe para representar endereços de protocolo da Internet (independente da versão do protocolo).

Atributos públicos

Addr [4]
uint32_t
Matriz de palavras opacas para conter endereços IP (independente da versão do protocolo)

Atributos estáticos públicos

Any
O objeto de endereço IP não especificado distinto.

Funções públicas

GlobalId (void) const
uint64_t
Extraia o identificador de rede global de 16 bits de um endereço ULA IPv6.
InterfaceId (void) const
uint64_t
Extraia o IID de um endereço ULA IPv6.
IsIPv4 (void) const
bool
Teste se o endereço é compatível com IPv4.
IsIPv4Broadcast (void) const
bool
Teste se o endereço é uma transmissão IPv4.
IsIPv4Multicast (void) const
bool
Teste se o endereço é multicast IPv4.
IsIPv6 (void) const
bool
Teste se o endereço é compatível com IPv6.
IsIPv6GlobalUnicast (void) const
bool
Teste se o endereço é um endereço unicast global IPv6.
IsIPv6LinkLocal (void) const
bool
Teste se o endereço é endereço local com link IPv6 (LL).
IsIPv6Multicast (void) const
bool
Teste se o endereço é multicast IPv6.
IsIPv6ULA (void) const
bool
Teste se o endereço é um endereço local exclusivo (ULA) IPv6.
IsMulticast (void) const
bool
Teste se o endereço é multicast IPv4 ou IPv6.
Subnet (void) const
uint16_t
Extraia o identificador de sub-rede de 16 bits de um endereço ULA IPv6.
ToIPv4 (void) const
Extraia o endereço IPv4 como uma estrutura de dados da plataforma.
ToIPv4 (void) const
struct in_addr
ToIPv6 (void) const
ip6_addr_t
Extraia o endereço IPv6 como uma estrutura de dados da plataforma.
ToIPv6 (void) const
struct in6_addr
ToString (char *buf, uint32_t bufSize) const
char *
Emita o endereço IP no formato de apresentação de texto convencional.
Type (void) const
IPAddressType
Extraia o tipo de endereço IP.
WriteAddress (uint8_t *& p) const
void
Emita o endereço IP na representação de rede padrão.
operator!= (const IPAddress & other) const
bool
Compare este endereço IP com outro para obter a desigualdade.
operator= (const IPAddress & other)
Operador de atribuição convencional.
operator== (const IPAddress & other) const
bool
Compare este endereço IP com outro para equivalência.

Funções estáticas públicas

FromIPv4 (const ip4_addr_t & addr)
FromIPv4 (const struct in_addr & addr)
Injete o endereço IPv4 de uma estrutura de dados da plataforma.
FromIPv6 (const ip6_addr_t & addr)
FromIPv6 (const struct in6_addr & addr)
Injete o endereço IPv6 de uma estrutura de dados da plataforma.
FromSockAddr (const struct sockaddr & sockaddr)
Injete o endereço IPv6 de um struct sockaddr& POSIX struct sockaddr&
FromString (const char *str, IPAddress & output)
bool
Digitalize o endereço IP a partir de seu texto de apresentação convencional.
FromString (const char *str, size_t strLen, IPAddress & output)
bool
Digitalize o endereço IP a partir de seu texto de apresentação convencional.
MakeIPv4Broadcast (void)
Construa um endereço de broadcast IPv4.
MakeIPv6Multicast (uint8_t aFlags, uint8_t aScope, const uint8_t aGroupId[NL_INET_IPV6_MCAST_GROUP_LEN_IN_BYTES])
Construa um endereço multicast IPv6 a partir de suas partes.
MakeIPv6Multicast (uint8_t aFlags, uint8_t aScope, uint32_t aGroupId)
Construa um endereço multicast IPv6 a partir de suas partes.
MakeIPv6PrefixMulticast (uint8_t aScope, uint8_t aPrefixLength, const uint64_t & aPrefix, uint32_t aGroupId)
Construa um endereço multicast IPv6 provisório com prefixo a partir de suas partes.
MakeIPv6TransientMulticast (uint8_t aFlags, uint8_t aScope, const uint8_t aGroupId[NL_INET_IPV6_MCAST_GROUP_LEN_IN_BYTES])
Construa um endereço multicast IPv6 transitório a partir de suas partes.
MakeIPv6WellKnownMulticast (uint8_t aScope, uint32_t aGroupId)
Construa um endereço multicast IPv6 conhecido a partir de suas partes.
MakeLLA (uint64_t interfaceId)
Construa um endereço local de link IPv6 (LL) a partir de seu IID.
MakeULA (uint64_t globalId, uint16_t subnet, uint64_t interfaceId)
Construa um endereço local exclusivo (ULA) IPv6 a partir de suas partes.
ReadAddress (const uint8_t *& p, IPAddress & output)
void
Emita o endereço IP na representação de rede padrão.

Atributos públicos

Addr

uint32_t Addr[4]

Matriz de palavras opacas para conter endereços IP (independente da versão do protocolo)

O endereço IPv6 usa todos os 128 bits divididos em quatro inteiros não assinados ordenados por bytes de rede de 32 bits. Os endereços IPv4 são V4COMPAT, ou seja, as três primeiras palavras são zero e a quarta palavra contém o endereço IPv4 na ordem de bytes da rede.

Atributos estáticos públicos

Qualquer

IPAddress Any

O objeto de endereço IP não especificado distinto.

Este objeto é usado como uma constante para comparações de equivalência. Ele não deve ser modificado por usuários do Nest Inet Layer.

Funções públicas

GlobalId

uint64_t GlobalId(
  void
) const 

Extraia o identificador de rede global de 16 bits de um endereço ULA IPv6.

Use este método com um endereço local único IPv6 (ULA) para extrair o identificador de rede global, que é os 40 bits imediatamente após o prefixo de rede ULA distinto, ou seja, fd00 :: / 8. Em outras palavras, o identificador de rede global está localizado nos cinco bytes do 2º ao 6º bytes no endereço.

Detalhes
Devoluções
Identificador de rede global de 40 bits ou zero se o endereço IP não for um endereço local exclusivo IPv6.

InterfaceId

uint64_t InterfaceId(
  void
) const 

Extraia o IID de um endereço ULA IPv6.

Use este método com um endereço local exclusivo (ULA) IPv6 para extrair o identificador identificador (IID), que é os 64 bits menos significativos do endereço.

Detalhes
Devoluções
Identificador de interface de 64 bits ou zero se o endereço IP não for um endereço local exclusivo IPv6.

IsIPv4

bool IsIPv4(
  void
) const 

Teste se o endereço é compatível com IPv4.

Use este método para verificar se o endereço pertence à família de endereços IPv4. Observe bem: o endereço não especificado não é um endereço IPv4.

Detalhes
Valores Retornados
true
O endereço é IPv4 e não o endereço não especificado.
false
O endereço é IPv6 ou o endereço não especificado.

IsIPv4Broadcast

bool IsIPv4Broadcast(
  void
) const 

Teste se o endereço é uma transmissão IPv4.

Use este método para verificar se o endereço é o endereço de difusão IPv4 com finalidade especial.

Detalhes
Valores Retornados
true
O endereço é a transmissão IPv4
false
De outra forma

IsIPv4Multicast

bool IsIPv4Multicast(
  void
) const 

Teste se o endereço é multicast IPv4.

Use este método para verificar se o endereço é um endereço multicast IPv4.

Detalhes
Valores Retornados
true
O endereço é multicast IPv4
false
De outra forma

IsIPv6

bool IsIPv6(
  void
) const 

Teste se o endereço é compatível com IPv6.

Use este método para verificar se o endereço pertence à família de endereços IPv6. Observe bem: o endereço não especificado não é um endereço IPv6.

Detalhes
Valores Retornados
true
O endereço é IPv6 e não o endereço não especificado.
false
O endereço é IPv4 ou o endereço não especificado.

IsIPv6GlobalUnicast

bool IsIPv6GlobalUnicast(
  void
) const 

Teste se o endereço é um endereço unicast global IPv6.

Use este método para verificar se o endereço pertence à família de endereços IPv6 e tem o prefixo de endereço unicast global.

Detalhes
Valores Retornados
true
O endereço é IPv6 global unicast
false
De outra forma

IsIPv6LinkLocal

bool IsIPv6LinkLocal(
  void
) const 

Teste se o endereço é endereço local com link IPv6 (LL).

Use este método para verificar se o endereço pertence à família de endereços IPv6 e tem o prefixo de endereço local com link IPv6 reservado.

Detalhes
Valores Retornados
true
O endereço é link-local IPv6
false
De outra forma

IsIPv6Multicast

bool IsIPv6Multicast(
  void
) const 

Teste se o endereço é multicast IPv6.

Use este método para verificar se o endereço pertence à família de endereços IPv6 e tem o prefixo de endereço multicast IPv6 reservado.

Detalhes
Valores Retornados
true
O endereço é multicast IPv6
false
De outra forma

IsIPv6ULA

bool IsIPv6ULA(
  void
) const 

Teste se o endereço é um endereço local exclusivo IPv6 (ULA).

Use este método para verificar se o endereço pertence à família de endereços IPv6 e tem o prefixo de endereço local exclusivo IPv6 reservado.

Detalhes
Valores Retornados
true
O endereço é IPv6 local exclusivo
false
De outra forma

IsMulticast

bool IsMulticast(
  void
) const 

Teste se o endereço é IPv4 ou multicast IPv6.

Use este método para verificar se o endereço pertence à família de endereços IPv4 ou IPv6 e tem o prefixo de endereço multicast IPv4 ou IPv6 reservado.

Detalhes
Valores Retornados
true
O endereço é IPv4 ou multicast IPv6
false
De outra forma

Sub-rede

uint16_t Subnet(
  void
) const 

Extraia o identificador de sub-rede de 16 bits de um endereço ULA IPv6.

Use este método com um endereço local exclusivo (ULA) IPv6 para extrair o identificador de sub-rede, que é os 16 bits menos significativos do prefixo de rede. O prefixo da rede são os 64 bits mais significativos do endereço. Em outras palavras, o identificador de sub-rede está localizado no 7º e 8º bytes de um endereço de 16 bytes.

Detalhes
Devoluções
Identificador de sub-rede de 16 bits ou zero se o endereço IP não for um endereço local exclusivo IPv6.

ToIPv4

ip4_addr_t ToIPv4(
  void
) const 

Extraia o endereço IPv4 como uma estrutura de dados da plataforma.

Use ToIPv4() const para extrair o conteúdo como um endereço IPv4, se possível. Os endereços IPv6 e o ​​endereço não especificado são extraídos como 0.0.0.0 .

O resultado é do tipo struct in_addr (no POSIX) ou ip4_addr_t (no LwIP).

Detalhes
Devoluções
O endereço IPv4 encapsulado ou 0.0.0.0 se o endereço não for especificado ou não for um endereço IPv4.

ToIPv4

struct in_addr ToIPv4(
  void
) const 

ToIPv6

ip6_addr_t ToIPv6(
  void
) const 

Extraia o endereço IPv6 como uma estrutura de dados da plataforma.

Use ToIPv6() const para extrair o conteúdo como um endereço IPv6, se possível. Os endereços IPv4 e o endereço não especificado são extraídos como [::] .

O resultado é do tipo struct in6_addr (no POSIX) ou ip6_addr_t (no LwIP).

Detalhes
Devoluções
O endereço IPv4 encapsulado ou [::] if the address is either unspecified or not an IPv4 address.

ToIPv6

struct in6_addr ToIPv6(
  void
) const 

Para sequenciar

char * ToString(
  char *buf,
  uint32_t bufSize
) const 

Emita o endereço IP no formato de apresentação de texto convencional.

Use ToString(char *buf, uint32_t bufSize) const para gravar a forma de apresentação de texto convencional do endereço IP na memória localizada em buf e estendendo até bufSize bytes, incluindo seu caractere de terminação NUL.

Detalhes
Parâmetros
[out] buf
O endereço do texto emitido.
[in] bufSize
O tamanho do buffer para o texto emitido.

Observação Bem: não é compatível com RFC 5952 em algumas plataformas. Especificamente, a compressão de zero não pode ser aplicada de acordo com a seção 4.2.

Detalhes
Devoluções
O argumento buf se não houver erro de formatação ou zero caso contrário.

Tipo

IPAddressType Type(
  void
) const 

Extraia o tipo de endereço IP.

Use este método para retornar um valor do tipo enumerado IPAddressType para indicar o tipo do endereço IP.

Detalhes
Valores Retornados
kIPAddressType_IPv4
O endereço é IPv4.
kIPAddressType_IPv6
O endereço é IPv6.
kIPAddressType_Any
O endereço é o endereço não especificado.

WriteAddress

void WriteAddress(
  uint8_t *& p
) const 

Emita o endereço IP na representação de rede padrão.

Use WriteAddress(uint8_t *&p) para codificar o endereço IP no formato binário definido pela RFC 4291 para endereços IPv6. Os endereços IPv4 são codificados de acordo com a seção 2.5.5.1 "Endereço IPv6 compatível com IPv4" (V4COMPAT).

Detalhes
Parâmetros
[in,out] p
Referência ao cursor a ser usado para escrever.

operador! =

bool operator!=(
  const IPAddress & other
) const 

Compare este endereço IP com outro para obter a desigualdade.

Detalhes
Parâmetros
[in] other
O endereço a ser comparado.
Valores Retornados
true
Se equivalente a other
false
De outra forma

operador =

IPAddress & operator=(
  const IPAddress & other
)

Operador de atribuição convencional.

Detalhes
Parâmetros
[in] other
O endereço a ser copiado.
Devoluções
Uma referência a este objeto.

operador ==

bool operator==(
  const IPAddress & other
) const 

Compare este endereço IP com outro para equivalência.

Detalhes
Parâmetros
[in] other
O endereço para comparar.
Valores Retornados
true
Se equivalente a other
false
De outra forma

Funções estáticas públicas

FromIPv4

IPAddress FromIPv4(
  const ip4_addr_t & addr
)

Esta é uma função de membro sobrecarregado, fornecido por conveniência. Ela difere da função acima apenas no (s) argumento (s) que aceita.

FromIPv4

IPAddress FromIPv4(
  const struct in_addr & addr
)

Injete o endereço IPv4 de uma estrutura de dados da plataforma.

Use FromIPv4(const ip4_addr_t &addr) para injetar addr como um endereço IPv4.

O argumento addr é do tipo const struct in_addr& (no POSIX) ou const ip4_addr_t& (no LwIP).

Detalhes
Devoluções
O endereço IP construído.

FromIPv6

IPAddress FromIPv6(
  const ip6_addr_t & addr
)

Esta é uma função de membro sobrecarregado, fornecido por conveniência. Ela difere da função acima apenas no (s) argumento (s) que aceita.

FromIPv6

IPAddress FromIPv6(
  const struct in6_addr & addr
)

Injete o endereço IPv6 de uma estrutura de dados da plataforma.

Use FromIPv6(const ip6_addr_t &addr) para injetar addr como um endereço IPv6.

O argumento addr é do tipo const struct in6_addr& (no POSIX) ou const ip6_addr_t& (no LwIP).

Detalhes
Devoluções
O endereço IP construído.

FromSockAddr

IPAddress FromSockAddr(
  const struct sockaddr & sockaddr
)

Injete o endereço IPv6 de um struct sockaddr& POSIX struct sockaddr&

Use FromSockAddr(const struct sockaddr& sockaddr) para injetar sockaddr.sa_addr como um endereço IPv6.

Detalhes
Devoluções
O endereço IP construído.

FromString

bool FromString(
  const char *str,
  IPAddress & output
)

Digitalize o endereço IP a partir de seu texto de apresentação convencional.

Use FromString(const char *str, IPAddress& output) para substituir um endereço IP digitalizando a apresentação de texto convencional localizada em str .

Detalhes
Parâmetros
[in] str
O endereço do texto emitido.
[out] output
O objeto a ser definido para o endereço verificado.

Detalhes
Valores Retornados
true
O formato de apresentação é válido
false
De outra forma

FromString

bool FromString(
  const char *str,
  size_t strLen,
  IPAddress & output
)

Digitalize o endereço IP a partir de seu texto de apresentação convencional.

Use FromString(const char *str, size_t strLen, IPAddress& output) para sobrescrever um endereço IP digitalizando a apresentação de texto convencional localizada em str .

Detalhes
Parâmetros
[in] str
Um ponteiro para o texto a ser digitalizado.
[in] strLen
O comprimento do texto a ser digitalizado.
[out] output
O objeto a ser definido para o endereço verificado.

Detalhes
Valores Retornados
true
O formato de apresentação é válido
false
De outra forma

MakeIPv4Broadcast

IPAddress MakeIPv4Broadcast(
  void
)

Construa um endereço de broadcast IPv4.

Detalhes
Devoluções
O endereço IP construído.

MakeIPv6Multicast

IPAddress MakeIPv6Multicast(
  uint8_t aFlags,
  uint8_t aScope,
  const uint8_t aGroupId[NL_INET_IPV6_MCAST_GROUP_LEN_IN_BYTES]
)

Construa um endereço multicast IPv6 a partir de suas partes.

Uso MakeIPv6Multicast(uint8_t flags, uint8_t scope, uint8_t groupId[14]) para construir um endereço IPv6 multicast com flags para encaminhamento âmbito scope e octetos identificador de grupo groupId .

Detalhes
Devoluções
O endereço IP construído.

MakeIPv6Multicast

IPAddress MakeIPv6Multicast(
  uint8_t aFlags,
  uint8_t aScope,
  uint32_t aGroupId
)

Construa um endereço multicast IPv6 a partir de suas partes.

Use MakeIPv6Multicast(uint8_t flags, uint8_t scope, uint32_t groupId) para construir um endereço de multicast IPv6 com flags para encaminhamento escopo scope e grupo identificador groupId .

Detalhes
Devoluções
O endereço IP construído.

MakeIPv6PrefixMulticast

IPAddress MakeIPv6PrefixMulticast(
  uint8_t aScope,
  uint8_t aPrefixLength,
  const uint64_t & aPrefix,
  uint32_t aGroupId
)

Construa um endereço multicast IPv6 provisório com prefixo a partir de suas partes.

Use MakeIPv6PrefixMulticast(uint8_t scope, uint8_t prefixlen, const uint64_t prefix, uint32_t groupId) para construir um endereço multicast IPv6 de prefixo transiente para roteamento de scope e octetos de identificador de grupo groupId , qualificado pelo prefixo de prefix de prefixlen bits.

Detalhes
Devoluções
O endereço IP construído.

MakeIPv6TransientMulticast

IPAddress MakeIPv6TransientMulticast(
  uint8_t aFlags,
  uint8_t aScope,
  const uint8_t aGroupId[NL_INET_IPV6_MCAST_GROUP_LEN_IN_BYTES]
)

Construa um endereço multicast IPv6 transitório a partir de suas partes.

Use MakeIPv6TransientMulticast(uint8_t flags, uint8_t scope, uint8_t groupId[14]) para construir uma IPv6 endereço transitória multicast com flags para encaminhamento escopo scope e octetos identificador de grupo groupId .

Detalhes
Devoluções
O endereço IP construído.

MakeIPv6WellKnownMulticast

IPAddress MakeIPv6WellKnownMulticast(
  uint8_t aScope,
  uint32_t aGroupId
)

Construa um endereço multicast IPv6 conhecido a partir de suas partes.

Uso MakeIPv6WellKnownMulticast(uint8_t scope, uint32_t groupId) para construir um endereço multicast IPv6 para encaminhamento âmbito scope e grupo identificador groupId .

Detalhes
Devoluções
O endereço IP construído.

MakeLLA

IPAddress MakeLLA(
  uint64_t interfaceId
)

Construa um endereço local de link IPv6 (LL) a partir de seu IID.

Use MakeLLA(uint64_t interfaceId) para construir um endereço local de link IPv6 (LL) com o identificador de interfaceId .

Detalhes
Devoluções
O endereço IP construído.

MakeULA

IPAddress MakeULA(
  uint64_t globalId,
  uint16_t subnet,
  uint64_t interfaceId
)

Construa um endereço local exclusivo (ULA) IPv6 a partir de suas partes.

Use MakeULA(uint64_t globalId, uint16_t subnet, uint64_t interfaceId) para construir um endereço local exclusivo (ULA) com identificador de rede global globalId , identificador de subnet rede subnet - subnet e identificador de interface (IID) interfaceId .

Detalhes
Devoluções
O endereço IP construído.

ReadAddress

void ReadAddress(
  const uint8_t *& p,
  IPAddress & output
)

Emita o endereço IP na representação de rede padrão.

Use ReadAddress(uint8_t *&p, IPAddress &output) para decodificar o endereço IP em p para a output do objeto.

Detalhes
Parâmetros
[in,out] p
Referência ao cursor a ser usado para leitura.
[out] output
Objeto para receber endereço IP decodificado.