Salva en 20:12 28 jul 2013

2013-07-28T20:12:25Z

Página nueva

{{Menu|cat=Basic|subcat=Las variables en OpenOffice Basic|Titulo=Declaración de variables|vers=4.0.x}}
<seo title="Declaración de variables - Apache OpenOffice Basic"
metakeywords="macro,declara,variable,dim,private,global,public,static,basic,starbasic,manual,curso,tutorial,open,office,openoffice,apache openoffice,libreoffice"
metadescription="OpenOffice.org Basic, también conocido como OOo Basic o StarBasic, es el nombre de uno de los cuatro lenguajes de macros incluidos en la suites Apache OpenOffice y LibreOffice"/>

== Declaración implícita de variables ==
OpenOffice Basic admite la declaración implícita de variables. Esta afirmación significa que se permite la creación de variables simplemente incluyéndolas en el código.

Por ejemplo:

<syntaxhighlight lang="oobas">
Sub Main
Variable = 25
MsgBox Variable
End Sub
</syntaxhighlight>

Este código crea la variable de nombre ''Variable'' y le asigna el valor ''25''; posteriormente es utilizado por el comando ''MsgBox'', mostrando una ventana con el número 25.

[[Image:OpenOffice.Basic.Macros.014.png|center|link=]]

Esta práctica no es aconsejable, pues puede dar como resultado la creación de nuevas variables por un simple error tipográfico, en lugar de generar un error detectable, y en consecuencia, resultará más difícil encontrar posibles errores en el código.

Por ejemplo:

<syntaxhighlight lang="oobas">
Sub Main
Variable = 25
MsgBox Variabe
End Sub
</syntaxhighlight>

Este código crea la variable de nombre ''Variable'' y le asigna el valor ''25''; posteriormente se crea una nueva variable denominada ''Variabe'', que se ha escrito con un simple error tipográfico. Ésta es utilizada por el comando ''MsgBox'', mostrando una ventana vacía, pues la nueva variable no contiene ningún valor.

[[Image:OpenOffice.Basic.Macros.015.png|center|link=]]

== Declaración explícita de variables ==
Para evitar los errores debidos a la declaración implícita de variables, OpenOffice Basic proporciona una instrucción que se debe insertar al inicio de cada módulo, forzando con ello la declaración explícita de las variables.

Esta instrucción es:
<syntaxhighlight lang="oobas">
Option Explicit
</syntaxhighlight>

Tras incluir esta instrucción al inicio de un módulo, las variables deberán ser declaradas con una instrucción '''Dim'''. Cualquier variable no declarada será identificada por un error como el siguiente:

[[Image:OpenOffice.Basic.Macros.013.png|center|link=]]

Mediante este sencillo procedimiento evitaremos errores en nuestro código y facilitaremos la localización de los mismos.

Las variables se pueden declarar de forma explícita de los siguientes modos:

<big>
:* [[#Declaración de variables a nivel de módulo|Al principio de un módulo]]
:* [[#Declaración de variables a nivel de subrutina o función|Dentro de una subrutina o una función]]
:* [[#Declaración de variables como argumento|Como argumentos de una subrutina o una función]]
</big>

Las variables se declaran con la sentencia

{{fosfi|centrar=si|Dim <NombreDeVariable>[ As <TipoDeVariable>]}}

Si no se define el tipo de variable, se asigna el tipo '''''Variant'''''.

<syntaxhighlight lang="oobas">
Dim Textos as String
Dim NumerosEnteros as Integer
Dim EnterosGrandes as Long
Dim NumerosConDecimales as Single
Dim NumerosGrandesConDecimales as Double
Dim Fecha as Date
Dim Hora as Date
Dim Verdadero as Boolean
Dim Importe as Currency
Dim miObjeto as Object
Dim CualquierCosa as Variant
Dim CualquierOtraCosa
</syntaxhighlight>

=== Usar sufijos para declarar el tipo de variable ===
También se pueden declarar y definir su tipo utilizando los sufijos que se relacionan en la [[Tipos_de_variables_en_OpenOffice_Basic|tabla de tipos de variables]].

<syntaxhighlight lang="oobas">
Dim Textos$
Dim NumerosEnteros%
Dim EnterosGrandes&
Dim NumerosConDecimales!
Dim NumerosGrandesConDecimales#
Dim Importe@
</syntaxhighlight>

Se pueden declarar varias variables en una sóla línea tras una única sentencia '''''Dim''''' siguiendo este modelo:

<syntaxhighlight lang="oobas">
Dim Fecha as Date, Texto as String, Contador as Integer
Dim Precio as Currency, Descuento as single
Dim CualquierCosa, Importe as Currency, Total as Currency
</syntaxhighlight>

La variable '''''CualquierCosa''''' del ejemplo será declarada como '''''Variant''''', al no especificar el tipo de variable en la declaración.

Un tercer modo de declarar el tipo de variable lo puedes encontrar en [[Opciones_y_directivas_del_compilador#Directiva Def|Directiva Def]]

== Declaración de variables a nivel de módulo ==
Podemos declarar variables a nivel de módulo, declarando éstas después de las [[#Opciones y directivas del compilador|opciones de compilador]] y antes de cualquier función o subrutina.

<syntaxhighlight lang="oobas">
REM ***** BASIC *****
Option Explicit

Dim Fecha as date, Hora as Date, Empresa as string
Dim Guardar as boolean

Sub MiSubrutina() as string

End Sub
</syntaxhighlight>

Cualquier variable declarada a nivel de módulo será visible por todas las funciones y subrutinas de ese módulo.
Solo será visible en ese módulo (salvo que se declare como pública).

== Declaración de variables a nivel de subrutina o función ==
Podemos declarar variables a nivel de subrutina o función, declarando éstas después de la declaración de la subrutina o función, y antes de su finalización con '''''End Sub''''' o '''''End Function''''', según corresponda, y siempre antes de utilizar la variable, por lo que es recomendable situarlas al principio, justo tras la declaración de la subrutina o función.

<syntaxhighlight lang="oobas">
REM ***** BASIC *****
Option Explicit

Dim Fecha as date, Hora as Date, Empresa as string
Dim Guardar as boolean

Sub MiSubrutina() as string
Dim miFecha as date, miHora as date, Guardar as boolean

End Sub
</syntaxhighlight>

Cualquier variable declarada a nivel de función o subrutina será visible sólo dentro de la misma (salvo que se declare como pública). Si el nombre coincide con una variable declarada a nivel de módulo, o pública, la variable de la función o subrutina '''eclipsará''' a las anteriores, por lo que no podremos acceder a ellas.

== Declaración de variables como argumento ==
Al declarar los argumentos de una subrutina o función, estamos declarando variables, que podemos tipificar.

<syntaxhighlight lang="oobas">
REM ***** BASIC *****
Option Explicit

Dim Fecha as date, Hora as Date, Empresa as string
Dim Guardar as boolean

Sub MiSubrutina( Importe as Currency, Descuento as single ) as string
Dim miFecha as date, miHora as date, Guardar as boolean

End Sub
</syntaxhighlight>

Las variables argumento se comportan exactamente igual que las variables declaradas a nivel de función o subrutina: serán visibles sólo dentro de la misma. Si el nombre coincide con una variable declarada a nivel de módulo, o pública, la variable argumento '''eclipsará''' a las anteriores, por lo que no podremos acceder a ellas.
No pueden coexistir variables de argumento y variables a nivel de función o subrutina con el mismo nombre.

{{Pie|Visibilidad -alcance- de las variables en OpenOffice Basic|Larga=7}}
[[Category:Ver.3.4.x]][[Category:Ver.3.3.x]][[Category:Ver.3.2.x]][[Category:Ver.3.1.x]]

Declaracion de variables en OpenOffice Basic - Historial de revisiones

Salva en 20:12 28 jul 2013