STR_TO_IP

Recebe uma string no formato a.b.c.d e retorna o valor numérico UDINT correspondente ao IP especificado; a string 0.0.0.0 é considerada inválida. É uma função.

Biblioteca: HI_STD · Namespace: HILS · Tipo: função

Função

             STR_TO_IP
          +--------------+
          |              |--- BOOL
          |              |
          |            IP|--- UDINT
          |              |
STRING ---|IP_STR ------ |---
          +--------------+

Por exemplo, se a string '192.168.0.224' for fornecida à função, será retornado o valor numérico 16#C0A800E0 no parâmetro IP.

Dica

Para conhecer melhor o recurso e suas funcionalidades acesse o vídeo tutorial: Utilizando a função STR_TO_IP.

Parâmetros

Nome	Direção	Tipo	Dimensão	Padrão	Faixa / Unidade	Descrição
IP_STR	IN_OUT	STRING	:*	—	—	String representando o IP no formato a.b.c.d.
IP	OUT	UDINT	—	—	—	Valor numérico do IP (Host-LittleEndian).

Retorno / Saídas

Retorna BOOL: TRUE indica que a string contém um valor válido de IP; FALSE caso contrário.

Nota

A string 0.0.0.0 é considerada um valor inválido de IP.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    DEST_IP : UDINT;                     (* Endereço IP de destino do socket 1 *)
    IP_STR  : STRING := '192.168.0.200'; (* String com o valor do IP de destino do socket 1 *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
HILS.STR_TO_IP(
  IP_STR,   // IP_STR [STRING] = string no formato a.b.c.d
  DEST_IP   // IP [UDINT] = valor numérico do IP (Host-LittleEndian)
  );
// retorna em DEST_IP o valor 16#C0A800C8
(* ... *)