IBM Lotus Symphony


Instrução ReDim [Runtime]

Declara uma variável ou uma matriz.

Sintaxe:

[ReDim]Dim VarName [(start To end)] [As VarType][, VarName2 [(start To end)] [As VarType][,...]]

Opcionalmente, pode adicionar a palavra-chave Preserve como um parâmetro, para preservar o conteúdo da matriz que é redimensionada.

Parâmetros:

VarName: Qualquer variável ou nome de matriz.

Start, End: Valores numéricos ou constantes que definem o número de elementos (NumberElements=(end-start)+1) e o intervalo do índice.

Start e End podem ser expressões numéricas se ReDim for utilizada no nível de procedimento.

VarType: Palavra-chave que declara o tipo de dados de uma variável.

Keyword: Tipo de variável

Bool: Variável booleana (True, False)

Date: Variável da data

Double: Variável de dupla vírgula flutuante (1.79769313486232x10E308 - 4.94065645841247x10E-324)

Integer: Variável de números inteiros (-32768 - 32767)

Long: Variável de números inteiros longos (-2,147,483,648 - 2,147,483,647)

Object: Variável de objecto (só pode ser definida ulteriormente em Set!)

[Single]: Variável de vírgula única flutuante (3.402823x10E38 - 1.401298x10E-45). Se não houver uma palavra-chave especificada, uma variável é definida como Single, a menos que seja utilizada uma instrução de DefBool a DefVar.

String: Variável de cadeia que contém um máximo de 64.000 caracteres ASCII.

Variant: Tipo de variável variante (pode conter todos os tipos e corresponde à predefinição).

No Lotus® Symphony™ Basic, não é necessário declarar as variáveis explicitamente. No entanto, é necessário que defina uma matriz antes de as poder utilizar. É possível definir uma variável através da instrução Dim, utilizando vírgulas para separar múltiplas declarações. Para declarar um tipo de variável, introduza um carácter de declaração de tipo a seguir ao nome ou utilize uma palavra-chave correspondente.

O Lotus Symphony Basic suporta matrizes uni ou multi-dimensionais definidas por um tipo de variável especificado. As matrizes são úteis caso o programa contenha listas ou tabelas que pretende editar. A vantagem das matrizes é que tornam possível endereçar elementos individuais de acordo com os índices, que podem ser formulados como expressões numéricas ou variáveis.

Há duas formas de definir o intervalo dos índices para as matrizes definidas através da instrução Dim:

DIM text(20) As String REM 21 elementos numerados de 0 a 20

DIM text(5 to 25) As String REM 21 elementos numerados de 5 a 25

DIM text$(-15 to 5) As String REM 21 elementos (0 inclusive),

rem numerada de -15 a 5

Os campos de variáveis, independentemente do tipo, podem ser tornados dinâmicos, caso sejam dimensionados por ReDim no nível de procedimento em subrotinas ou funções. Normalmente, só é possível definir uma vez o intervalo de uma matriz e não é possível modificá-lo. Num procedimento, é possível definir uma matriz utilizando a instrução ReDim com expressões numéricas para definir o intervalo do tamanho dos campos.

Exemplo:

Sub ExampleRedim

Dim iVar() As Integer, iCount As Integer

ReDim iVar(5) As integer

For iCount = 1 To 5

iVar(iCount) = iCount

Next iCount

ReDim iVar(10) As integer

For iCount = 1 To 10

iVar(iCount) = iCount

Next iCount

end sub


Comentários sobre o produto | Documentação adicional | Marcas comerciais