IP_TO_STR

Converte um valor de IP de 32 bits em little endian (host order) na string correspondente no formato a.b.c.d. Por exemplo, para o valor 16#C0A800E0 a função retorna '192.168.0.224'. É uma função (sem estado; não requer instância).

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

Função

              IP_TO_STR
           +--------------+
 UDINT ----|IP            |
           |              |
STRING ----|IP_STR ------ |----
           +--------------+

A função recebe o endereço IP como um inteiro de 32 bits em IP e escreve a representação textual, no formato decimal ponteado a.b.c.d, no parâmetro IP_STR. O valor de IP é interpretado em ordem de host (little endian): o octeto mais significativo do valor corresponde ao primeiro campo da string.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IP	IN	UDINT	0	—	Valor numérico do IP (host, little endian).
IP_STR	IN_OUT	STRING	—	—	Recebe a string do IP no formato a.b.c.d.

Retorno / Saídas

A função não possui valor de retorno; o resultado é entregue no parâmetro IP_STR.

Ver também

STR_TO_IP, GET_DSYSVAR

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; (* String com o valor do IP de destino do socket 1 *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)

(* O endereço IP do socket 1 do equipamento está disponível nas variáveis de
   sistema F146 e F147. A chamada seguinte obtém as duas variáveis e compõe o
   endereço IP, retornando um valor de 32 bits. *)

DEST_IP := HILS.GET_DSYSVAR(ADDR := 146); (* retorna o endereço IP destino do socket 1 *)

HILS.IP_TO_STR(
  DEST_IP,  (* IP [UDINT] = Valor numérico do IP (Host-LittleEndian) *)
  IP_STR    (* IP_STR [STRING] = Retorna string no formato a.b.c.d *)
  );

(* ... *)