STRIP_STRING

Avalia a STRING informada e a redimensiona até o primeiro caractere nulo encontrado, descartando os bytes nulos remanescentes. É uma função (não mantém estado entre scans).

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

Função

           STRIP_STRING
          +-------------+
STRING ---|STR -------- |---
          +-------------+

A string é passada por STR (parâmetro de entrada/saída) e ajustada no próprio local. Útil quando um buffer foi convertido em STRING pela função BUF_TO_STRING: a string resultante pode conter vários caracteres de valor zero, pois na chamada de BUF_TO_STRING apenas o tamanho máximo é especificado. STRIP_STRING reduz a string ao conteúdo útil, até o primeiro caractere nulo.

Parâmetros

Nome	Direção	Tipo	Dimensão	Faixa / Unidade	Descrição
STR	IN_OUT	STRING	:*	—	String a ser avaliada e redimensionada até o primeiro caractere nulo.

Retorno / Saídas

A função não possui valor de retorno; o resultado é entregue na própria STR.

Ver também

BUF_TO_STRING

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    len    : UINT := 30;                       (* Nro de bytes a serem copiados *)
    my_buf : ARRAY [0..29] OF SINT := [72,73]; (* Buffer a ser copiado iniciado com o valor HI *)
    my_str : STRING;                           (* String a receber BUF *)
    ret    : INT;                              (* Retorno da função *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
ret := HILS.BUF_TO_STRING(len, my_buf, my_str);
// Recebe uma string com HI0x0(* ... *)0x0 (O texto HI mais 28 caracteres zero)
IF (ret <> -1) THEN
    HILS.STRIP_STRING(my_str);
    // Recebe uma string com HI (remove os caracteres zero no fim da string)
ELSE
    // Trata erro na conversão. Tamanho inválido.
END_IF;

(* ... *)