IBM Lotus Symphony
|
O texto que se segue descreve a utilização básica das variáveis do Lotus® Symphony™ Basic.
O nome de uma variável pode ter um máximo de 255 caracteres. O primeiro carácter do nome de uma variável terá de ser uma letra de A-Z ou a-z. Também se podem utilizar números no nome de uma variável, mas os sinais de pontuação não são permitidos, à excepção do traço de sublinhado ("_"). No Lotus Symphony Basic, os identificadores de variáveis não são sensíveis a maiúsculas e minúsculas. Os nomes das variáveis podem conter espaços mas, caso contenham, têm de estar entre parênteses rectos.
Exemplo | Descrição |
---|---|
MyNumber=5 | Correcto |
MyNumber5=15 | Correcto |
MyNumber_5=20 | Correcto |
My Number=20 | O nome não é válido, a variável com espaço tem de estar entre parênteses rectos |
[My Number]=12 | Correcto |
DéjàVu=25 | O nome não é válido, os caracteres especiais não são permitidos |
5MyNumber=12 | O nome não é válido, a variável não pode começar com um número |
Number,Mine=12 | O nome não é válido, os sinais de pontuação não são permitidos |
No Lotus Symphony Basic não é necessário declarar variáveis de forma explícita. A declaração de uma variável pode ser executada com a declaração Dim. Pode declarar mais do que uma variável de cada vez separando os nomes com uma vírgula. Para definir o tipo de variável, utilize um sinal de declaração de tipo depois do nome ou a palavra-chave adequada.
Exemplo | Descrição |
---|---|
DIM a$ | Define a variável "a" como String |
DIM a As String | Define a variável "a" como String |
DIM a$, b As Integer | Define uma variável como String e outra como Integer |
DIM c As Boolean | Declara que c corresponde a uma variável booleana que pode ser TRUE ou FALSE |
Quando se declara variáveis é muito importante que se utilize sempre o carácter de declaração de tipo, mesmo se tiver sido utilizado na declaração no lugar de uma palavra-chave. Assim, as seguintes instruções não são válidas:
Exemplo | Descrição |
---|---|
DIM a$ | Define "a" como String |
a="TestString" | Declaração de tipo ausente: "a$=" |
![]() |
Após ter declarado uma variável como de um determinado tipo, não é possível declarar a variável com o mesmo nome como um tipo diferente! |
Para forçar a declaração de variáveis, utilize o seguinte comando:
OPTION EXPLICIT
A instrução Option Explicit terá de ser a primeira linha do módulo, antes da primeira SUB. Normalmente, só as matrizes precisam de ser declaradas de forma explícita. Todas as restantes variáveis são declaradas de acordo com o carácter de declaração de tipo ou, caso esteja omisso, com o tipo predefinido Single.
O Lotus Symphony Basic suporta quatro classes de variáveis:
As variáveis Numeric podem contar valores numéricos. Algumas variáveis são utilizadas para armazenar grandes ou pequenos números, enquanto que outras são utilizadas para vírgula flutuante ou números fraccionais.
As variáveis String contêm sequências de caracteres.
As variáveis Booleanas contêm ou valor TRUE ou FALSE.
As variáveis Object podem armazenar objectos de diversos tipos, tais como tabelas e documentos dentro de um documento.
As variáveis de números inteiros vão desde -32768 até 32767. Se atribuir um valor de vírgula flutuante a uma variável de números inteiros, as casas decimais são arredondadas de acordo com o próximo número inteiro. As variáveis de números inteiros são rapidamente calculadas através de procedimentos e são apropriadas para contagem de variáveis em ciclos. Uma variável de números inteiros só necessita de dois bytes de memória. "%" é o carácter de declaração de tipo.
Dim Variable%
Dim Variable As Integer
As variáveis de números inteiros longos vão desde -2147483648 até 2147483647. Se atribuir um valor de vírgula flutuante a uma variável de números inteiros longos, as casas decimais são arredondadas de acordo com o próximo número inteiro. As variáveis de números inteiros relativos longos são rapidamente calculadas através de procedimentos e são apropriadas para a contagem de variáveis em ciclos para valores elevados. Uma variável de números inteiros relativos longos necessita de 4 bytes de memória. "&" é o carácter de declaração de tipo.
Dim Variable&
Dim Variable as Long
As variáveis decimais podem assumir números positivos, negativos ou zero. A precisão é de até 29 dígitos.
Pode utilizar os sinais de mais (+) ou menos (-) como prefixos para números decimais (com ou sem espaços).
Se um número decimal for atribuído a uma variável inteira, o Lotus Symphony Basic arredonda o número por excesso ou defeito.
As variáveis únicas podem obter valores positivos ou negativos, entre 3.402823 x 10E38 e 1.401298 x 10E-45. As variáveis únicas são variáveis de vírgula flutuante, nas quais a precisão decimal diminui à medida que a parte não decimal do número aumenta. As variáveis únicas são adequadas para cálculos matemáticos de média precisão. Os cálculos necessitam de mais tempo do que as variáveis Integer mas são mais rápidos do que os cálculos com variáveis duplas. Uma variável Single necessita de 4 bytes de memória. O carácter de declaração de tipo é "!".
Dim Variable!
Dim Variable as Single
As variáveis duplas podem ter valores positivos ou negativos que vão desde 1.79769313486232 x 10E308 até 4.94065645841247 x 10E-324. As variáveis duplas são variáveis de vírgula flutuante, nas quais a precisão decimal diminui à medida que a parte não decimal do número aumenta. As variáveis duplas são adequadas para cálculos precisos. Os cálculos são mais demorados do que nas variáveis únicas. Uma variável dupla necessita de 8 bytes de memória. O carácter de declaração de tipo é "#".
Dim Variable#
Dim Variable As Double
As variáveis de moeda são armazenadas internamente como números de 64-bit (8 Bytes) e apresentadas como um número decimal fixo com 15 casas não decimais e 4 decimais. Os valores vão desde -922337203685477.5808 até +922337203685477.5807. As variáveis de moeda são utilizadas para calcular os valores de moeda com grande precisão. O carácter de declaração de tipo é "@".
Dim Variable@
Dim Variable As Currency
As variáveis de cadeia podem possuir sequências de caracteres com um número máximo de 65.535. Todos os caracteres são guardados de acordo com o valor Unicode correspondente. As variáveis de cadeia são adequadas para processamento de texto dentro de programas e para armazenar temporariamente algum carácter que não possa ser impresso até um máximo de 64 Kbytes. A memória necessária para armazenar variáveis de cadeia depende do número de caracteres na variável. O carácter da declaração de tipo é "$".
Dim Variable$
Dim Variable As String
As variáveis booleanas só armazenam um de dois valores: TRUE ou FALSE. Um número 0 equivale a FALSE, enquanto que todos os restantes valores equivalem a TRUE.
Dim Variable As Boolean
As variáveis de data só podem conter valores de data e hora num formato interno. Os valores atribuídos a variáveis de Data com Dateserial , Datevalue , Timeserial ou Timevalue são automaticamente convertidos no formato interno. As variáveis de Data são convertidas em números normais, utilizando as funções Day , Month , Year , Hour , Minute ou Second . O formato interno permite comparar os valores de data e hora calculando a diferença entre dois números. Estas variáveis podem apenas ser definidas através da palavra-chave Data.
Dim Variable As Date
Assim que a variável for definida, fica automaticamente definida com o valor "Null". Atenção às seguintes convenções:
As variáveis numéricas recebem automaticamente o valor "0" assim que são definidas.
Às variáveis de Data é atribuído o valor de 0 internamente; equivalente à conversão do valor em "0" através das funções Day , Month , Year , Hour , Minute ou Second .
As variáveis de cadeia recebem uma cadeia vazia ("") quando são definidas.
O Lotus Symphony Basic reconhece matrizes unidimensionais ou multidimensionais, definidas por um tipo de variável especificado. As matrizes são adequadas para editar listas e tabelas em programas. É possível aceder aos elementos individuais de uma matriz através de um índice numérico.
As matrizes têm de ser declaradas com a instrução Dim.
Exemplo | Descrição |
---|---|
DIM text$(20) | 21 elementos numerados de 0 a 20 |
DIM text$(5,4) | 30 elementos (uma matriz de 6 x 5 elementos) |
DIM text$(5 to 25) | 21 elementos numerados de 5 a 25 |
DIM text$(-15 to 5) | 21 elementos (incluindo o 0), numerados de -15 a 5 |
O intervalo do índice pode incluir tanto números positivos como negativos.
As constantes têm um valor fixo. Só são definidas quando estiverem no programa e não podem ser redefinidas mais tarde:
CONST ConstName=Expression