GET_STR_CHAR

Obtém de uma string o valor (código) do caractere no índice especificado, retornando 0 quando o índice é inválido. É uma função.

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

Função

           GET_STR_CHAR
          +-------------+
  UINT ---|INDEX        |--- USINT
          |             |
STRING ---|TEXT ------- |---
          +-------------+

Recebe o texto em TEXT e o índice em INDEX (base 1, ou seja, o primeiro caractere está no índice 1) e devolve o código do caractere naquela posição. Se o índice estiver fora dos limites da string, a função retorna 0.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
INDEX	IN	UINT	—	= 1	Índice do caractere no texto. Inicia em 1.
TEXT	IN_OUT	STRING	—	—	Texto a ser pesquisado.

Retorno / Saídas

Retorna um USINT com o valor (código) do caractere presente na string no índice especificado. Retorna 0 se o índice for inválido.

Observações

• O índice é baseado em 1 (o primeiro caractere corresponde a INDEX = 1).

• Um retorno 0 indica índice fora dos limites da string.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    my_index : UINT := 2;            (* Índice do caractere no texto *)
    my_str   : STRING := 'HIstudio'; (* Texto a ser pesquisado *)
    ret      : USINT;                (* Valor do caractere no índice especificado *)
END_VAR

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

ret := HILS.GET_STR_CHAR(my_index, my_str); // retorna valor 73 (caractere 'I')
IF (ret = 0) THEN
  // Trata condição de índice inválido
END_IF;

(* ... *)