BUF_TO_STRING

Copia o nro. de bytes (caracteres) especificado do buffer BUF para a strin STR Retorna SUCCESS (0) ou -1 se o tamanho da string não suporta o conteúdo especificado.

Bloco

            BUF_TO_STRING
           +-------------+
  UINT ----|LEN          |
           |             |
   ANY ----|BUF          |
           |             |
STRING ----|STR -------- |----
           +-------------+

Parâmetros

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
LEN	Entrada	UINT		Nro de bytes a serem copiados para a string
BUF	Entrada	ANY		Vetor de dados a ser transferido para a string
STR	Entrada/Saída	STRING		String a receber o conteudo de BUF

Retorno

Tipo Dado	Descrição
INT	SUCCESS (0) se operação realizada com sucesso. -1 se string é menor que o tamanho a ser copiado.

Exemplo

Declaração de Variáveis

Nome	Tipo	Dimensão	Valor Inicial	Descrição
len	UINT		30	Nro de bytes a serem copiados
my_buf	SINT	[0..29]		Buffer a ser copiado
my_str	STRING			String a receber BUF
ret	INT			Retorno da função

Clique aqui para baixar a tabela de variáveis

Código ST

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
ret := HILS.BUF_TO_STRING(len, my_buf, my_str);
IF (ret = -1) THEN
  // Trata erro na conversão. Tamanho inválido.
END_IF;

(* ... *)