LEFT

Retorna uma string com os L primeiros caracteres da string IN.

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.

Bloco

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

Parâmetro

Nome	Classe	Tipo	Descrição
IN	Entrada	ANY_STRING	String de entrada
L	Entrada	ANY_INT	Nro de caracteres da string de saída

Retorno

Tipo Dado	Descrição
STRING	String resultante da operação.

Exemplo

Declaração de Variáveis

Nome	Tipo	Descrição
value_in	STRING	valor do operando de entrada
value_l	INT	tamanho da string a ser obtida
value_out	INT	valor resultante da operação

Clique aqui para baixar a tabela de variáveis

Código ST

(* 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' *)
(* ... *)