Partilhar via


has_ipv4()

Aplica-se a: ✅Microsoft FabricAzure Data ExplorerAzure MonitorMicrosoft Sentinel

Retorna um valor que indica se um endereço IPv4 especificado aparece em um texto.

As entradas de endereço IP em um texto devem ser delimitadas corretamente com caracteres não alfanuméricos. Por exemplo, endereços IP delimitados corretamente são:

  • "Estes pedidos provieram de: 192.168.1.1, 10.1.1.115 e 10.1.1.201"
  • "05:04:54 127.0.0.1 OBTER /favicon.ico 404"

Sintaxe

has_ipv4( fonte,ip_address)

Saiba mais sobre convenções de sintaxe.

Parâmetros

Nome Tipo Obrigatório Descrição
fonte string ✔️ O texto a pesquisar.
ip_address string ✔️ O valor que contém o endereço IP para o qual pesquisar.

Devoluções

true se o ip_address for um endereço IPv4 válido e tiver sido encontrado na origem. Caso contrário, a função retorna false.

Sugestão

Exemplos

O exemplo a seguir demonstra o uso has_ipv4 com vários valores escalares, onde cada endereço IP é fornecido como um argumento de cadeia de caracteres separado. Os endereços IP no texto são devidamente delimitados por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54 127.0.0.1 GET /favicon.ico 404', '127.0.0.1')

Realização

Resultado
verdadeiro

O exemplo a seguir demonstra o uso has_ipv4 com um endereço IP inválido. O endereço IP no texto é devidamente delimitado por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54 127.0.0.256 GET /favicon.ico 404', '127.0.0.256')

Realização

Resultado
falso

O exemplo a seguir demonstra o uso has_ipv4 com um endereço IP delimitado incorretamente. O endereço IP no texto é delimitado incorretamente por caracteres não alfanuméricos.

print result=has_ipv4('05:04:54127.0.0.1 GET /favicon.ico 404', '127.0.0.1')

Realização

Resultado
falso