IBM Lotus Symphony


Instrução Dim [Tempo de Execução]

Declara uma variável ou uma matriz.

Se as variáveis forem separadas por vírgulas (por exemplo, DIM sPar1, sPar2, sPar3 AS STRING), apenas as variáveis Variant poderão ser definidas. Use uma linha de definição separada para cada variável.

DIM sPar1 AS STRING

DIM sPar2 AS STRING

DIM sPar3 AS STRING

Dim declara as variáveis locais dentro das sub-rotinas. As variáveis globais são declaradas com a instrução PUBLIC ou PRIVATE.

Sintaxe:

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

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 de índice.

Start e End podem ser expressões numéricas se ReDim é aplicado 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)

Currency: Variável de moeda (Currency com 4 casas decimais)

Date: Variável de data

Double: Variável de ponto flutuante de precisão dupla (1.79769313486232Ã' xÃ' 10E308 - 4.94065645841247 x 10E-324)

Inteiro: Variável de inteiro (-32768 - 32767)

Long: Variável de inteiro longo (-2.147.483.648 - 2.147.483.647)

Object: Variável de objeto (Nota: essa variável pode ser somente subsequencialmente definida com Set!)

Single: Variável de ponto flutuante de precisão única (3,402823 x 10E38 - 1,401298 x 10E-45).

String: Variável de sequência que consiste em no máximo 64.000 caracteres ASCII.

[Variant]: Tipo de variável Variante (contém todos os tipos, especificados pela definição). Se uma palavra-chave não for especificada, as variáveis serão definidas automaticamente como Tipo Variante, a não ser que uma instrução de DefBool a DefVar seja especificada.

No Lotus® Symphony™ Basic, não é necessário declarar variáveis explicitamente. No entanto, é necessário declarar uma matriz para poder usá-la. É possível declarar uma variável com a instrução Dim, usando vírgulas para separar várias declarações. Para declarar um tipo de variável, insira um caractere de declaração de tipo seguindo o nome ou use uma palavra-chave correspondente.

O Lotus Symphony Basic suporta matrizes de uni ou multidimensionais que são definidas por um tipo de variável especificado. As matrizes serão adequadas se o programa contiver listas ou tabelas que você deseja editar. A vantagem das matrizes é a possibilidade de fornecer elementos individuais de acordo com os índices, os quais podem ser formulados como expressões numéricas ou variáveis.

As matrizes são declaradas com a instrução Dim. Existem dois métodos para definir o intervalo de índice:

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 (inclusive 0)

REM numerado de -15 a 5

Falha nos dados bidimensionais

DIM text(20,2) as String REM 63 elementos; de 0 a 20 nível 1, de 0 a 20 nível 2 e de 0 a 20 nível 3.

É possível declarar um tipo de matriz como dinâmico, se uma instrução ReDim definir o número de dimensões na sub-rotina ou na função que contenha a matriz. Geralmente, é possível definir a dimensão de uma matriz somente uma vez e não pode modificá-la. Dentro de uma sub-rotina, é possível declarar uma matriz com ReDim. As dimensões podem ser definidas somente com expressões numéricas. Isso assegura que os campos sejam somente tão grandes quanto necessários.

Exemplo:

Sub ExampleDim1

Dim sVar As String

Dim iVar As Integer

sVar = "Lotus Symphony"

End Sub

Sub ExampleDim2

REM Campo de dados bidimensional

Dim stext(20,2) as String

Const sDim as String = " Dimension:"

for i = 0 to 20

for ii = 0 to 2

stext(i,ii) = str(i) & sDim & str(ii)

next ii

next i

for i = 0 to 20

for ii = 0 to 2

msgbox stext(i,ii)

next ii

next i

End Sub


Feedback do Produto | Documentação Adicional | Marcas Registradas