UPPER_BOUND

Retorna o limite superior do array informado em ARR, na dimensão indicada por DIM. É uma função pura (sem estado; retorna o resultado diretamente).

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

Função

             UPPER_BOUND
           +-------------+
  ARRAY ---|ARR          |--- ANY_INT
           |             |
ANY_INT ---|DIM          |
           +-------------+

Nota

Esta função aceita na entrada ARR qualquer array de qualquer número de dimensões e de qualquer tipo.

Esta função aceita na entrada DIM qualquer um dos parâmetros do tipo ANY_INT como dimensão a ser consultada. Consulte os Grupos de tipos de dados para identificar quais os tipos suportados pela função.

Parâmetros

Nome	Direção	Tipo	Faixa / Unidade	Descrição
ARR	IN	ARRAY	—	Array a ser consultado.
DIM	IN	ANY_INT	dimensão do array, começando em 1	Dimensão a ser consultada.

Retorno / Saídas

Tipo	Faixa / Unidade	Descrição
ANY_INT	—	Limite superior do array informado em ARR, na dimensão indicada em DIM.

Exemplo

Clique aqui para baixar a tabela de variáveis

Código ST

VAR_INPUT
    values : ARRAY [*] OF INT; (* Array de valores *)
END_VAR
VAR
    sum    : INT := 0;         (* Somatória dos valores *)
    I      : INT;              (* Index *)
END_VAR

(* Exemplo de somatória de array de tamanho variável *)
(* ... *)
FOR I := LOWER_BOUND(values, 1) TO UPPER_BOUND(values, 1) DO
    sum := sum + values[I];
END_FOR;
(* A variável sum contém a soma dos números no array *)
(* ... *)