# Obter tamanho da string

Obtém o número de caracteres da string em [Source Data] e armazena o valor em [Destination Data].

##### Bloco

##### Texto

TARGET = length(EXPRESSION);
1 2

# | Descrição
1 | [Destination Data] Defina o destino onde deseja armazenar o comprimento da string. O comprimento da string é armazenado como um valor inteiro.
2 | [Source Data] Defina os dados de origem onde a string é armazenada. Se utilizar uma variável externa, a string é codificada na configuração [Codificação de strings] no equipamento associado. Caso contrário, a string é codificada em UTF-8.

(Exemplo)

##### Bloco

##### Texto

Var1 = length(Var3);

## Exemplo de operação

Variável em [Source Data] | Variável em [Destination Data] | Comentários
String | Número máximo de bytes | Tipo de dados | Número de caracteres obtidos
ABCDE | 5 | INT | 5 | -
AB | 5 | INT | 2 | -
Aあ | 5 | INT | 2 | O número de caracteres da string é armazenado.
AA | [Tamanho da variável] habilitado na janela de propriedade da variável | INT | 2 | -
Aあ | [Tamanho da variável] habilitado na janela de propriedade da variável | INT | 2 | O número de caracteres da string é armazenado.
A(0x00)CDE | 5 | INT | 1 | Se houver um NULO (0x00), a string será encerrada lá.
(0x00) | 5 | INT | 0 | Se houver um NULO (0x00), a string será encerrada lá.
A(0x0A)CD | 5 | INT | 4 | O código de alimentação de linha (0x0A) é considerado como um caractere.
A(0x0D)CD | 5 | INT | 4 | O código de retorno (0x0D) é considerado como um caractere.