LEFT

Retorna uma string com os L primeiros caracteres da string IN. É uma função pura (sem estado; retorna o resultado diretamente).

Biblioteca: IEC_STD · Namespace: IEC · Tipo: função

Função

                    LEFT
               +-------------+
ANY_STRING ----|IN           |---- ANY_STRING
               |             |
   ANY_INT ----|L            |
               +-------------+

Esta função retorna os L caracteres mais à esquerda da string informada em IN. O tipo de retorno é sempre o mesmo do tipo de entrada.

Nota

Caso o valor de L seja menor que zero ou maior que o tamanho da string IN a string de saída não será alterada e o tipo de erro gerado pode ser obtido através da função GET_SYSTEM_ERR.

Parâmetros

Nome	Direção	Tipo	Padrão	Faixa / Unidade	Descrição
IN	IN	ANY_STRING	—	—	String de entrada.
L	IN	ANY_INT	—	—	Número de caracteres da string de saída.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
ANY_STRING	—	String resultante da operação, com os L primeiros caracteres de IN. O tipo é idêntico ao de entrada.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR
    value_in  : STRING; (* valor do operando de entrada *)
    value_l   : INT;    (* tamanho da string a ser obtida *)
    value_out : STRING; (* valor resultante da operação *)
END_VAR

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
value_in := 'ABC';  (* String a ser fornecido *)
value_l  := 2;
value_out := LEFT(IN := value_in, L := value_l);
    (* resultado value_out = 'AB' *)
(* ... *)