DELETE

Deleta L caracteres da STRING IN a partir da posição P.

Nota

Caso a string IN seja inválida 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.

Caso o valor de L seja menor que zero 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.

Caso o valor de P seja menor que L 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.

Caso a operação resulte em uma string maior que a capacidade da string de saída o processo será cancelado e o tipo de erro gerado pode ser obtido através da função GET_SYSTEM_ERR.

Bloco

                  DELETE
              +-------------+
ANY_STRING ---|IN           |--- ANY_STRING
              |             |
   ANY_INT ---|L            |
              |             |
   ANY_INT ---|P            |
              +-------------+

Parâmetro

Nome

Classe

Tipo

Descrição

IN

Entrada

ANY_STRING

String de entrada

L

Entrada

ANY_INT

Nro de carateres a serem removidos

P

Entrada

ANY_INT

Posição inicial de remoção

Retorno

Tipo Dado

Descrição

ANY_STRING

String resultante da operação.

Exemplo

Declaração de Variáveis

Nome

Tipo

Descrição

value_in1

STRING

valor do operando de entrada 1

value_out

STRING

valor resultante da operação

value_l

INT

tamanho a ser removido

value_p

INT

posição de inserção

Clique aqui para baixar a tabela de variáveis

Código ST

(* Exemplo de ativação da função dentro da POU *)
(* ... *)
value_in1 := 'ABCDEF';  (* Valor a ser fornecido *)
value_l   := 2;  (* Valor a ser fornecido *)
value_p   := 3;  (* Valor a ser fornecido *)
value_out := DELETE(IN := value_in1, L := value_l, P := value_p);
    (* resultado value_out = 'ABEF' *)
(* ... *)