CONCAT

Realiza a concatenação (junção) das strings IN0 e IN1. Esta função é extensível aceitando um número variável de parâmetros de entrada (no mínimo 2).

Nota

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.

Importante

A string de saída que irá receber o valor concatenado não pode ser nenhuma string da lista fornecida, exceto a primeira string. Ou seja:

S1 := CONCAT(S1, S2, S3);

Irá ser executada corretamente. Entretanto:

S2 := CONCAT(S1, S2, S3);

Irá retornar um resultado incorreto.

Bloco

                  CONCAT
              +-------------+
ANY_STRING ---|IN0          |--- ANY_STRING
              |             |
ANY_STRING ---|IN1          |
              |             |
              | :           |
ANY_STRING ---|INn          |
              +-------------+

Nota

Esta função aceita como parâmetros de entrada qualquer um dos tipos de dados do grupo ANY_STRING. Consulte os Grupos de tipos de dados para identificar quais os tipos de dados suportados pela função.

Note que, todos os parâmetros de entrada e o valor de retorno devem ser do mesmo tipo.

Parâmetro

Nome	Classe	Descrição
IN0	Entrada	String 1
IN1	Entrada	String 2

Retorno

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

Exemplo

Declaração de Variáveis

Nome	Tipo	Valor Inicial	Descrição
value_in1	STRING	‘A’	valor do operando de entrada 1
value_in2	STRING	‘BC’	valor do operando de entrada 2
value_in3	STRING	‘DEF’	valor do operando de entrada 3
value_in4	STRING	‘XZ’	valor do operando de entrada 4
value_out	STRING		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_out  := CONCAT(value_in1, value_in2, value_in3, value_in4);
    (* resultado value_out = 'ABCDEFXZ' *)
(* ... *)