STRING_TO_BUF

Copia o conteúdo de uma string para um vetor de qualquer tipo de dado. Retorna o nro de bytes (caracteres) copiados para o buffer ou -1 se o tamanho do buffer é menor que a string a ser copiada.

Bloco

            STRING_TO_BUF
           +-------------+
STRING ----|STR -------- |----
           |             |
   ANY ----|BUF -------- |---- ANY
           +-------------+

Parâmetros

Nome	Parâmetro	Tipo Dado	V. Ini.	Descrição
STR	Entrada/Saída	STRING		String a ser copiada para o buffer
BUF	Entrada/Saída	ANY		Vetor de dados a receber a string

Retorno

Tipo Dado	Descrição
INT	Nro. de caracteres (bytes) transferidos para o buffer ou -1 se o buffer não possui espaço suficiente.

Exemplo

Declaração de Variáveis

Nome	Tipo	Dimensão	Valor Inicial	Descrição
my_str	STRING		‘HIstudio’	String a ser copiada
my_buf	SINT	[0..29]		Buffer a receber a string
count	INT			Contador de bytes da string

Clique aqui para baixar a tabela de variáveis

Código ST

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

count := HILS.STRING_TO_BUF(my_str, my_buf);
IF (count = -1) THEN
  // Trata erro na conversão. Buffer não possui espaço suficiente
END_IF;

(* ... *)