C119 - Apéndice D. Evaluador de formulas

1. Tipos de datos

Nada Tipo nulo

Número Un número de coma flotante de doble precisión. Ejemplo: 12777,45, 0,000056, 1E18

Texto Una cadena de texto de hasta 255 caracteres. Ejemplo: "hola", 'sin comentarios'

Lógico Los valores 'cierto' y 'falso'. Ejemplo: cierto, falso, a < b

Bloque Un bloque de código. Ejemplo: {a=1;b=2;c=3}

Variable Una variable, de cualquiera de los tipos indicados Ejemplo: &a (siendo a una variable)

Lista Una lista (array) de elementos, de cualquiera de los tipos indicados. Ejemplo: #("uno"; "dos"; "tres")

Tipo Un tipo de dato, cualquiera de los tipos indicados. Ejemplo: tipo("uno")

Item Un elemento de una lista (array)

Objeto Un objeto.

2. Operadores de cálculo

+ (más) - Suma de dos números Ejemplo: 3 + 4 devuelve 7 - Concatenación de dos textos Ejemplo: "uno" + "dos" devuelve "unodos"

- (menos) - Resta de dos números Ejemplo: 3 - 4 devuelve -1 - Cambio de signo de un número Ejemplo: -(3 + 4) devuelve -7

* (asterisco) Multiplicación de dos números Ejemplo: 3 * 4 devuelve 12

/ (barra de división) División de dos números Ejemplo: 3 / 4 devuelve 0,75

modulo Resto de la división entera de dos números Ejemplo 7 modulo 4 devuelve 3

no negación de un valor lógico Ejemplo: no (3 > 4) devuelve cierto

y Combina dos valores lógicos con el operador lógico AND Ejemplo: (1 > 2) y (3 < 4) devuelve falso

o Combina dos valores lógicos con el operador lógico OR Ejemplo: (1 > 2) o (3 < 4) devuelve cierto

3. Operador de asignación

= (igual) Asigna un valor (y un tipo) a una variable, definiéndola si no existe Ejemplo: a = 7 Nota: No utilizar este operador para comparar dos elementos (un error bastante frecuente)

4. Operadores de comparación

== (doble igual) Devuelve cierto si los dos elementos comparados son iguales. Es aplicable a todos los tipos, pero si los elementos son de diferente tipo, se produce un "error de tipo". Ejemplo: 3 == 4 devuelve falso

<> (menor-mayor) Devuelve cierto si los dos elementos comparados son diferentes. Es aplicable a todos los tipos, pero si los elementos son de diferente tipo, se produce un "error de tipo". Ejemplo: 3 <> 4 devuelve cierto

>, >=, <, <= (mayor, mayor-igual, menor, menor-igual) - Si los operandos son números, evalúa las comparaciones según el valor numérico de los operandos Ejemplo: 3 > 4 devuelve falso - Si los operandos son textos, evalúa las comparaciones según el orden alfabético de los operandos, sin tener en cuenta las mayúsculas / minúsculas Ejemplo: "abeja" < "mosca" devuelve cierto - Si los operandos son lógicos, se considera que cierto es mayor a falso Ejemplo: cierto > falso devuelve cierto - Si los operandos son de diferente tipo entre sí, o de cualquier otro tipo que los arriba indicados, se produce un "error de tipo"

5. Otros operadores

() (paréntesis) - Agrupan operaciones, alterando su precedencia. Se permiten ilimitados niveles Ejemplo: (a + b)*(c + (d - e) / 2) - Indican los argumentos o parámetros de las funciones Ejemplo: EnLetras(a) - Precedidos por el símbolo #, definen una lista de elementos Ejemplo: #("uno";"dos";"tres")

[ ] (corchetes) - Permiten obtener un caracter de un texto Ejemplo: a = "distrito-k"; a[3] devuelve "s" - Permiten obtener un elemento de una lista (array) Ejemplo: a = #("uno";"dos";"tres"); a[2] devuelve "dos" - Evalúan una función predefinida (depende de la aplicación) Ejemplo (sólo en SQL CONTA): [s '430'] devuelve el saldo de la cuenta 430

{ } (llaves) Delimitan un bloque de código Ejemplo: si a == b entonces {a = a + 1} sino {a = a - 1}

@ (arroba) Permite obtener el valor de una variable cuyo nombre se obtiene a partir de una expresión Ejemplo: a = 25; nombre = "a"; @nombre devuelve 25

& (ampersand) Permite obtener la variable cuyo nombre se obtiene a partir de una expresión Ejemplo: a = 25; &a devuelve la variable a, no el valor 25

; (punto y coma) - Permite separar los elementos de una lista (array) Ejemplo: a = #("uno";"dos";"tres") - Permite separar los argumentos o parámetros de una función Ejemplo: Min(a; b) - Permite ejecutar más de una orden, separándolas entre sí. El valor devuelto por el conjunto de órdenes es el último evaluado. Ejemplo: a = 3; b = 4; a + b; Se ejecutan las tres órdenes, y devuelve 7

6. Estructuras de lenguaje

funciones Para llamar a una función, debe indicarse su nombre, y si desean indicarse argumentos o parámetros, deben indicarse a continuación entre paréntesis, separados entre sí por ";" Ejemplo de llamada a una función sin argumentos: Pi Ejemplo de llamada a una función con argumentos: Max(a;b)

si entonces Si devuelve cierto, ejecuta Ejemplo: si a < b entonces {"a es muy pequeño"}

si entonces sino Si devuelve cierto, ejecuta pero si devuelve falso, ejecuta Ejemplo: si a < b entonces {"a es muy pequeño"} sino {"a está bien"}

mientras haz Si devuelve cierto, ejecuta , y vuelve a ejecutar la orden Ejemplo: mientras a < 5 haz {a = a + 1}

haz mientras Ejecuta , y si devuelve cierto, vuelve a ejecutar la orden Ejemplo: haz {a = a + 1} mientras a < 5 Nota: La diferencia con la orden anterior es que se ejecuta al menos una vez.

7. Constantes predefinidas

Constante Tipo Descripción

Nada Nada El valor nulo Cierto Lógico El valor lógico cierto Falso Lógico El valor lógico falso TNada Tipo El tipo Nada TNumero Tipo El tipo Número TTexto Tipo El tipo Texto TLogico Tipo El tipo Lógico TBloque Tipo El tipo Bloque TVariable Tipo El tipo Variable TLista Tipo El tipo Lista TTipo Tipo El tipo Tipo

8. Funciones matemáticas

Función Resultado Descripción

Pi Número El número Pi (3,1415...)

Abs() Número El valor absoluto (sin signo) de

Redondeo() Número El entero más cercano a

Defecto() Número El entero inmediatamente inferior a

Exceso() Número El entero inmediatamente superior a

Entero() Número La parte entera de

Decimal() Número La parte decimal de

Positivo() Número Si es positivo, ; sino, 0

Negativo() Número Si es negativo, ; sino, 0

RedondeoDec(;) Número redondeado a decimales

RedondeoFactor(;) Número redondeado a un múltiplo de

LogXY(;) Número Logaritmo de en base

Potencia(;) Número elevado a

Min(;) Número El menor valor de y

Max(;) Número El mayor valor de y

9. Funciones de manipulación de textos

Función Resultado Descripción

TxRellenaDer(;;) Texto Devuelve completado con el caracter por la derecha hasta caracteres

TxSustituye(;;) Texto Sustituye en todas las apariciones del caracter por el caracter

TxLimpiaDer(;) Texto Devuelve sin los caracteres que pudiera tener por la derecha

TxPosicion(;) Número Devuelve la posición que ocupa en . Si no aparece en , devuelve -1

TxTrozo(;;) Texto Devuelve un trozo de que comienza en , y tiene caracteres de longitud

TxBorra(;;) Texto Devuelve , luego de quitarle caracteres a partir de

Intro Texto Devuelve un retorno de carro

10. Funciones de conversión

Función Resultado Descripción

EnTexto() Texto Convierte a texto

EnNumero() Número Convierte a número, si es posible

EnLetra() Texto expresado en letras

Formatea() Texto Convierte a texto

Formatea(;) Texto Convierte a texto usando la máscara

11. Funciones de manipulación de listas (arrays)

Función Resultado Descripción

LCrea Lista Crea y devuelve una lista vacía

LBorra() Nada Elimina todos los items de

LTamaño() Número Devuelve el número de items de

LQuita(;) Nada Quita el item de índice de

LAplica(;) Nada Itera , asignando a la variable "params" el item actual, y ejecutando .

LCarga(;) Nada Lee del fichero de nombre , una lista, y la asigna a

LGraba(,) Nada Escribe el contenido de en el fichero de

nombre

TipoLista() Lista Devuelve una lista con los tipos de

ChequeaTipoItem(;) Nada Verifica que todos los items de sean del tipo de , o del tipo

12. Funciones de manipulación de variables

Función Resultado Descripción

VerVars(; ) Nada Muestra un cuadro de diálogo con el título , que permite ver el valor de la lista de variables indicadas en , separadas por ";", y aceptando el uso del comodín "*". Si no se especifica , todas las variables.

EditarVars(; ) Nada Muestra un cuadro de diálogo con el título , que permite ver y modificar el valor de la lista de variables indicadas en , separadas por ";", y aceptando el uso del comodín "*". Si no se especifica , todas las variables.

DuplicarVars(;) Nada Duplica, agregándoles el prefijo , la lista de variables indicadas en , separadas por ";", y aceptando el uso del comodín "*"

BorrarVars() Nada Borra la lista de variables indicadas en , separadas por ";", y aceptando el uso del comodín "*"

RenombrarVars(;) Nada Renombra las variables indicadas en , asignándoles los nombres indicados en

SustituirVars(;) Nada Sustituye los valores de las variables indicadas

SustituirVars(;;) Nada Sustituye los valores de las variables indicadas, y las renombra

SetVariablePrefix() Nada Fija como prefijo por defecto para las nuevas variables

GetVariablePrefix Texto Devuelve el prefijo por defecto para las nuevas variables

Tipo() Tipo Devuelve el tipo de

13. Funciones varias

Función Resultado Descripción

Mensaje() Nada Muestra un cuadro de diálogo informativo, con el mensaje , y un botón "Aceptar"

Pregunta(;) Texto Muestra un cuadro de diálogo solicitando un texto, con el mensaje , y los botones "Aceptar" y "Cancelar". Si se especifica , éste se mostrará como texto por defecto. Si se selecciona "Aceptar", la función devuelve el texto introducido. Si se selecciona "Cancelar", interrumpe el proceso.

Confirma() Lógico Muestra un cuadro de diálogo de confirnación, con el mensaje , y los botones "Sí", "No" y "Cancelar". Si se selecciona "Sí", la función devuelve Cierto. Si se selecciona "No", la función devuelve Falso. Si se selecciona "Cancelar", interrumpe el proceso.

Error() Nada Muestra un cuadro de diálogo de error, con el

mensaje , y el botón "Aceptar". Interrumpe el proceso.

FechaHoy Texto Devuelve la fecha actual

14. Formato de máscaras para números

Una máscara es un texto que indica la forma de presentar un número, y puede estar formada por los siguientes especificadores:

"0" Indica la posición de un dígito. Si el valor que se está formateando tiene un dígito en la posición donde el "0" aparece en la máscara, entonces se muestra ese dígito. Si no, se muestra un "0" en esa posición.

"#" Indica la posición de un dígito. Si el valor que se está formateando tiene un dígito en la posición donde el "0" aparece en la máscara, entonces se muestra ese dígito. Si no, no se muestra nada en esa posición.

"." Separador decimal. El primer caracter "." en la máscara determina la posición del separador decimal en el valor presentado. Cualquier "." adicional se ignora.

"," Separador de miles. Si la máscara contiene algún caracter ",", el valor presentado tendrá separadores de miles cada tres dígitos a la izquierda del separador decimal. La ubicación y la cantidad de "," en la máscara no afecta al resultado.

"e+" Notación científica. Si cualquiera de los textos "e+", "e-" aparecen en la máscara, el número es presentado utilizando notación científica. Puede agregarse a estos símbolos un grupo de hasta cuatro "0", para indicar el mínimo número de dígitos del exponente. El especificador "e+" muestra siempre el signo del exponente, ya sea positivo o negativo, pero el especificador "e-" sólo muestra el signo si es negativo.

'xx' ó "xx" Los caracteres encerrados por comillas simples o dobles se muestran tal como se indican, y no afectan al formato. Lo mismo ocurre si utilizamos cualquier caracter que no sea un especificador de la presente lista.

";" Separa las secciones para números positivos, negativos o ceros en la máscara.

Notas

• El número se presenta siempre redondeado a la máxima cantidad de decimales indicados por los "0" ó "#" a la derecha del separador decimal. Si la máscara no contiene el separador decimal, el número se redondeará al entero más cercano.

• Si el número tuviera más dígitos que los indicados en la máscara, estos dígitos se presentarán a la izquierda del primer "0" ó "#".

• Para permitir diferentes máscaras para valores positivos, negativos y ceros, la máscara puede contener entre una y tres secciones separadas por ";". - Una sección: La máscara se aplica a todos los valores - Dos secciones: La primera se aplica a valores positivos y ceros, y la segunda a negativos - Tres secciones: La primera se aplica a valores positivos, la segunda a negativos, y la tercera a ceros

• Si la máscara está vacía, o no se especifica máscara, el valor se presenta utilizando la siguiente máscara por defecto: ",0.#####". Es decir, con separador de miles, y con hasta cinco decimales, presentando siempre el cero pava valores menores a uno.

• En cualquier caso, si hubiera más de 18 dígitos a la izquierda del separador decimal, se presentará el número en notación científica, aunque no se haya especificado.

  Ejemplos

Valores 1234 -1234 0,5 0

"" 1234 -1234 0,5 0

"0" 1234 -1234 1 0

"0.00" 1234,00 -1234,00 0,50 0,00

"#.##" 1234 -1234,5

"#,##0.00" 1.234,00 -1.234,00 0,50 0,00

"#,##0.00;(#,##0.00)" 1.234,00 (1.234,00) 0,50 0,00

"#,##0.00;;Cero" 1.234,00 -1.234,00 0,50 Cero

"0.000E+00" 1,234E+03 -1,234E+03 5,000E-01 0,000E+00

"#.###E-0" 1,234E3 -1,234E3 5E-1 0E0

Funciones específicas de SQL CONTA

Función Resultado Descripción

PreguntaMeses Texto Muestra un cuadro de diálogo solicitando los períodos, y devuelve una lista de períodos, que puede utilizarse en la función [ ] (ver más abajo)

DatoEmpresa() Varía Devuelve el valor del campo de la tabla de configuración de la empresa

Formula() Varía Localiza la fórmula con el código en la tabla de fórmulas, y la evalúa

Formula() Varía Localiza la fórmula con el nombre en la tabla de fórmulas, y la evalúa

[ ] Número Saldo de la lista de cuentas

[ D|H|S

] Número Debe, haber o saldo de la lista de cuentas en la lista de períodos

. Si no se especifica

, se asume el total del ejercicio

[ N ] Texto Nombre de la cuenta

[ C ] Número Valor de la lista de casillas (en impresos)

Listas de cuentas

Los elementos que conforman una lista de cuentas, son los siguientes: Cuenta Ejemplo: "400" - Rango de cuentas Ejemplo: "400-430"

Puede anteponerse a una cuenta o rango uno de los siguientes modificadores: - Devuelve el resultado, cambiado de signo P Devuelve el resultado, sólo si es positivo N Devuelve el resultado, sólo si es negativo La lista de cuentas estará formada por una o más cuentas o rangos, separados por ";".

Ejemplos

"430" Cuenta 430 "400-430" Cuentas de la 400 a la 430 "400-430;-472" Cuentas de la 400 a la 430, más la cuenta 472 cambiada de signo "P400-430;472" Cuentas de la 400 a la 430 sólo si son positivas, más la cuenta 472

Listas de períodos

Los elementos que conforman una lista de períodos, son los siguientes:
ANT: Resultado del ejercicio anterior
AP: Asiento de apertura 1 a 12: Meses del año, 1=Enero, 2=Febrero,..., 12=Diciembre
REX: Asiento de regularización de existencias
REG: Asiento de regularización
CIE: Asiento de cierre La lista de períodos puede estar formada por uno o más elementos, separados por ";", o por un rango de elementos, separados por "-".

Ejemplos

"AP;1;3": Asiento de apertura, enero, marzo "AP-REG": Desde asiento de apertura hasta regularización "": Todos los períodos ";": Ningún período