Utilizar variáveis

O texto seguinte descreve a utilização básica de variáveis no LibreOfficeDev Basic.

Convenções de nomenclatura para identificadores de variáveis

O nome de uma variável pode ter, no máximo, 255 caracteres. O primeiro carácter do nome de uma variável tem que ser uma letra de A-Z ou a-z. Também pode utilizar números no nome de uma variável, mas sinais de pontuação e caracteres especiais não são permitidos, à exceção do traço de sublinhado ("_"). No LibreOfficeDev Basic, os identificadores de variáveis não diferenciam maiúsculas de minúsculas. Os nomes das variáveis podem conter espaços mas, nesse caso, têm que estar entre parênteses retos.

Exemplos de identificadores de variáveis:

    MyNumber=5      'Correto'
    MyNumber5=15    'Correto'
    MyNumber_5=20   'Correto'
    O meu número = 20    'Não é válido; as variáveis com espaços devem ser colocadas entre parênteses retos'
    [O meu número]=12  'Correto'
    DéjàVu=25       'Inválido, não são permitidos caracteres especiais'
    5MyNumber=12    'Não é válido, a variável não pode começar por um número'
    Número,Mina=12  'Não é válido, não são permitidos sinais de pontuação'

Declarar variáveis

No LibreOfficeDev Basic não precisa declarar variáveis explicitamente. Uma declaração de variável pode ser executada com a instrução Dim. Pode declarar mais do que uma variável por 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 uma palavra-chave adequada.

Exemplos de declarações de variáveis:

    Dim a$               'Declara a variável "a" como uma String'
    Dim a As String      'Declara a variável "a" como um tipo String'
    Dim a$, b As Integer 'Declara uma variável como String e outra como Integer'
    Dim c As Boolean     'Declara c como uma variável booleana que pode assumir os valores TRUE ou FALSE'

Assim que tiver declarado uma variável como um certo tipo, não pode declará-la novamente com o mesmo nome e um tipo diferente!

Quando se declaram várias variáveis numa única linha de código, é necessário especificar o tipo de cada variável. Se o tipo de uma variável não for explicitamente especificado, o Basic assumirá que a variável é do tipo Variant.

  ' Ambas as variáveis «a» e «b» são do tipo inteiro
  Dim a As Integer, b As Integer
  A variável «c» é do tipo Variant e «d» é do tipo Integer
  Dim c, d As Integer
  Uma variável também pode ser declarada explicitamente como um Variant
  Dim e As Variant, f As Double

O tipo Variant é um tipo de dados especial que pode armazenar qualquer tipo de valor. Para saber mais, consulte a secção O tipo Variant abaixo.

Forçar declarações de variáveis

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 este esteja omisso, como o tipo Simples.

Tipos de variáveis

O LibreOfficeDev Basic possui suporte a quatro classes de variáveis:

• As variáveis Numéricas podem contar valores numéricos. Algumas variáveis são utilizadas para armazenar números grandes ou pequenos, enquanto que outras são utilizadas para vírgula flutuante ou números fracionários.

• As variáveis String contêm cadeias de caracteres.

• As variáveis Booleanas contêm o valor VERDADEIRO ou FALSO.

• As variáveis deObjeto podem armazenar objetos de diversos tipos, tais como tabelas e documentos dentro de um documento.

Variáveis de números inteiros

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 para 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

Variáveis de números inteiros longos

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 para o próximo número inteiro. As variáveis de números inteiros longos são rapidamente calculadas em procedimentos e são apropriadas para contagem de variáveis em ciclos para grandes valores. Uma variável de números inteiros longos necessita de 4 bytes de memória. "&" é o carácter de declaração de tipo.

Dim Variable&
Dim Variable As Long

Variáveis decimais

As variáveis decimais podem ter números positivos, negativos ou zero. A precisão é até um máximo de 29 dígitos.

Pode utilizar o sinal de soma (+) ou o sinal de subtração (-) como prefixo de números decimais (com ou sem espaços).

Se um número decimal for atribuído a uma variável inteira, o LibreOfficeDev Basic arredonda o número por excesso ou por defeito.

Variáveis únicas

As variáveis Single podem assumir valores positivos ou negativos que variam entre 3,402823 × 10³⁸ e 1,401298 × 10⁻⁴⁵. As variáveis Single são variáveis de ponto flutuante, nas quais a precisão decimal diminui à medida que a parte inteira do número aumenta. As variáveis Single são adequadas para cálculos matemáticos de precisão média. Os cálculos requerem mais tempo do que para variáveis inteiras, mas são mais rápidos do que os cálculos com variáveis duplas. Uma variável simples requer 4 bytes de memória. O caractere de declaração do tipo é «!».

Dim Variable!
Dim Variable As Single

Variáveis duplas

As variáveis do tipo Double podem assumir valores positivos ou negativos que variam entre 1,79769313486232 × 10³⁰⁸ e 4,94065645841247 × 10⁻³²⁴. As variáveis do tipo Double são variáveis de ponto flutuante, nas quais a precisão decimal diminui à medida que a parte inteira do número aumenta. As variáveis do tipo Double são adequadas para cálculos precisos. Os cálculos requerem mais tempo do que no caso das variáveis Single. Uma variável Double requer 8 bytes de memória. O caractere de declaração de tipo é «#».

Variável de intensidade#
Dim Variable As Double

Variáveis monetárias

As variáveis monetárias são armazenadas internamente como números de 64 bits (8 Bytes) e mostradas 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 monetárias são utilizadas para calcular os valores com grande precisão. O carácter de declaração de tipo é "@".

Dim Variable@
Dim Variable As Currency

Literais para números inteiros

Os números podem ser codificados utilizando os sistemas octal e hexadecimal.

  xi = &o13 '    8 + 3
  ci = &h65 ' 6*16 + 5
  MAX_Integer =  &o77777 '  32767 = &h7FFF
  MIN_Integer = &o100000 ' -32768 = &h8000
  MAX_Long = &h7fffffff '  2147483647 = &o17777777777
  MIN_Long = &h80000000 ' -2147483648 = &o20000000000

Variáveis de cadeia

As variáveis de cadeia de caracteres podem conter cadeias de caracteres com até 2 147 483 648 caracteres. Cada caractere é armazenado como o valor Unicode correspondente. As variáveis de cadeia de caracteres são adequadas para o processamento de texto em programas e para o armazenamento temporário de qualquer caractere não imprimível, até um comprimento máximo de 2 GB. A memória necessária para armazenar variáveis de cadeia de caracteres depende do número de caracteres na variável. O caractere de declaração do tipo é «$».

Nas funções de cadeia de caracteres do BASIC, o primeiro caractere da cadeia tem o índice 1.

Dim Variable$
Dim Variable As String

Variáveis booleanas

As variáveis booleanas só guardam um de dois valores: VERDADEIRO ou FALSO. Um número 0 é avaliado como FALSO, enquanto que qualquer outro valor é avaliado como VERDADEIRO.

Dim Variable As Boolean

Variáveis de data

As variáveis de data só podem conter valores de data e hora num formato interno. Os valores atribuídos às variáveis de data com Dateserial, Datevalue, Timeserial ou Timevalue são automaticamente convertidos para o formato interno. As variáveis de data são convertidas em números normais utilizando a função Dia, Mês, Ano ou a função de Hora, Minuto, Segundo. O formato interno permite comparar os valores de data e hora calculando a diferença entre dois números. Estas variáveis só podem ser declaradas com a palavra-chave Data.

Dim Variable As Date

Literais de data

Os literais de data permitem especificar variáveis de data inequívocas que são independentes do idioma atual. Os literais são colocados entre os símbolos de cerquilha #. Os formatos possíveis são:

• #yyyy-mm-dd#

• #mm/dd/yyyy#

  start_date = #1899-12-30# ' = 0
  dob = #2010-09-28#

O tipo Variant

As variáveis declaradas como Variant podem aceitar qualquer tipo de dados. Isto significa que o tipo de dados efetivo é definido durante a execução, à medida que um valor é atribuído à variável.

Existem três formas principais de criar uma variável Variant, conforme mostrado abaixo:

  Dim varA            ' O tipo não está especificado, pelo que a variável é do tipo Variant
  Dim varB As Variant ' A variável é declarada explicitamente como um Variant
  varC = "abc"        ' As variáveis não declaradas anteriormente são tratadas como Variants

O exemplo abaixo utiliza a função TypeName para mostrar como o tipo de uma variável Variant se altera após a atribuição.

  Dim myVar As Variant
  MsgBox TypeName(myVar) ' Empty
  myVar = "Hello!"
  MsgBox TypeName(myVar) ' String
  myVar = 10
  MsgBox TypeName(myVar) ' Integer

Uma variável Variant é inicializada com o tipo de dados especial Empty. Pode utilizar a função IsEmpty para verificar se uma variável é uma Variant vazia.

Também pode utilizar a palavra-chave Any para declarar uma variável como Variant. No entanto, Any está obsoleta e está disponível apenas por motivos de compatibilidade com versões anteriores.

Os argumentos com o tipo Variant ou Any passados nas chamadas de função não são verificados quanto ao seu tipo.

  Dim myVar As Any ' A variável "myVar" é do tipo Variant

Valores de variáveis iniciais

Assim que a variável for definida, fica automaticamente definida com o valor "Nulo". Atenção às seguintes convenções:

As variáveis numéricas recebem automaticamente o valor "0" assim que são definidas.

As variáveis de data recebem o valor 0 internamente; o que é equivalente a converter o valor para "0" com a função Dia, Mês, Ano ou Hora, Minuto, Segundo.

Quando declaradas, as variáveis de cadeia recebem uma cadeia vazia ("").

Matrizes

O LibreOfficeDev 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. Pode aceder aos elementos de uma matriz através de um índice numérico.

As matrizes têm de ser declaradas com a instrução Dim. Há diversas formas de definir o intervalo de um índice numa matriz:

    Dim Text$(20)       '21 elements numbered from 0 to 20'
    Dim Text$(5,4)      '30 elements (a matrix of 6 x 5 elements)'
    Dim Text$(5 To 25)  '21 elements numbered from 5 to 25'
    Dim Text$(-15 To 5) '21 elements (including 0), numbered from -15 to 5'

O intervalo do índice pode incluir números positivos e números negativos.

Constantes

As constantes têm um valor fixo. Apenas são definidas uma vez no programa e não podem ser redefinidas mais tarde:

Const ConstName=Expression