Funciones integradas
Las 27 funciones matemáticas con aridad, dominios y ejemplos, además de sintaxis de llamada, anidamiento y separadores de argumentos.
Numlex incluye exactamente 27 funciones integradas: todas escalares y todas estrictas. No
hay e ni pi integradas, las llamadas no distinguen mayúsculas y una llamada mal escrita
o con el número de argumentos equivocado es un error visible en lugar de un cero.
Esta página enumera las reglas de llamada, el comportamiento de los separadores de
argumentos según el formato regional (round(1.25, 0) frente a round(1,25; 0)) y una
tabla completa de las 27 funciones con sus dominios y ejemplos.
Sintaxis de llamada
Escribe name(arg1, arg2, …). Los nombres de función no distinguen mayúsculas
(SQRT(9) = sqrt(9)) y se permite un espacio antes de (.
Las llamadas son estrictas. Un nombre desconocido, un número de argumentos incorrecto, una coma de más o de menos, un paréntesis sin cerrar o un valor fuera del dominio de la función son un error, nunca una suposición. Una línea con forma de llamada sigue las reglas estrictas descritas en Lenguaje de hojas: un nombre de función desconocido es un error, no un grupo entre paréntesis.
En posición de llamada, una función integrada tiene prioridad sobre una variable con el
mismo nombre: sum = 5 no impide sum(1, 2). En cualquier otra posición, sum es un
identificador normal.
Las funciones son escalares (no toman ni devuelven unidades) y se permiten llamadas
anidadas: sqrt(abs(-16)) → 4.
Sin constantes integradas
No hay constantes e ni pi integradas. ln(e) no se evalúa a menos que e se haya
declarado antes (e = 2.71828…). Lo mismo vale para pi: declárala como valor con nombre
o constante de Ajustes si la necesitas.
Separadores de argumentos y comas
El separador depende del formato regional:
- Formatos con punto decimal (North America, System con punto): el separador de
argumentos es
,—round(1.25, 0). - Formatos con coma decimal (Western Europe, Eastern Europe, System con coma): el
separador decimal es una coma y el de argumentos es
;—round(1,25; 0)= 1.
Las comas dentro de una llamada se leen por su forma:
| Entrada | Interpretación |
|---|---|
sum(1,234) | un número (1234) — una coma de agrupación necesita exactamente tres dígitos después y una parte entera antes |
sum(1, 234) | dos argumentos |
sum(1,2,3) | tres argumentos |
1,234,567 | un número (fuera de llamadas) |
Las 27 funciones
| Función | Args | Significado | Dominio | Ejemplo |
|---|---|---|---|---|
sqrt | 1 | raíz cuadrada | x ≥ 0 | sqrt(16) → 4 |
abs | 1 | valor absoluto | cualquiera | abs(-3) → 3 |
round | 1–2 | redondeo (alejándose de cero); el 2.º argumento es un número entero de dígitos −15…15 | dígitos enteros | round(2.5) → 3, round(2.345, 2) → 2.35 |
min | ≥1 | mínimo | — | min(3, 1, 2) → 1 |
max | ≥1 | máximo | — | max(1, 2) → 2 |
sum | ≥1 | suma | — | sum(1, 2, 3) → 6 |
average | ≥1 | media | — | average(1, 2, 3) → 2 |
pow | 2 | potencia (mismo contrato que ^) | resultado finito | pow(2, 10) → 1024 |
ln | 1 | logaritmo natural | x > 0 | ln(1) → 0 |
log | 1–2 | logaritmo: 1 argumento — base 10; 2 argumentos — base b | x > 0; b > 0, b ≠ 1 | log(100) → 2, log(8, 2) → 3 |
log10 | 1 | logaritmo en base 10 | x > 0 | log10(1000) → 3 |
sin | 1 | seno | radianes | sin(0) → 0 |
cos | 1 | coseno | radianes | cos(0) → 1 |
tan | 1 | tangente | radianes | tan(0) → 0 |
asin | 1 | arcoseno | |x| ≤ 1, radianes | asin(1) → π/2 |
acos | 1 | arcocoseno | |x| ≤ 1, radianes | acos(0) → π/2 |
atan | 1 | arcotangente | cualquiera, radianes | atan(1) → π/4 |
radians | 1 | grados → radianes | — | radians(180) → π |
degrees | 1 | radianes → grados | — | degrees(atan(1)) → 45 |
int | 1 | entero (base decimal) | entero exacto | int(45) → 45 |
bin | 1 | entero en base binaria | entero exacto | bin(5) → 0b101 |
oct | 1 | entero en base octal | entero exacto | oct(8) → 0o10 |
hex | 1 | entero en base hexadecimal | entero exacto | hex(255) → 0xFF |
count | ≥1 | número de argumentos | — | count(1, 2, 3) → 3 |
median | ≥1 | mediana | — | median(1, 2, 3, 4) → 2.5 |
stdev | ≥2 | desviación estándar muestral (n−1) | resultado finito | stdev(2,4,4,4,5,5,7,9) → ≈2.13809 |
rand | 2 | entero uniforme en low...high, inclusive (entropía del sistema) | enteros exactos, low ≤ high | rand(1, 6) |
Estadísticas, etiquetas y subtotales
Las últimas cuatro funciones — count, median, stdev y rand — pertenecen a
las etiquetas, los subtotales y la estadística: filas etiquetadas, secciones ---, subtotales, totales generales,
agregados por etiqueta, frases estadísticas naturales y la estadística de pie configurable.
Su comportamiento (elegibilidad, consultas por etiqueta solo hacia arriba, el valor dinámico de
rand y el menú del pie) se describe en
Etiquetas, subtotales y estadística; esta página cubre solo su
sintaxis de llamada.
rand(low, high) es un entero uniforme inclusivo extraído de la entropía del sistema. Se
mantiene estable hasta que edites la hoja o pulses ⌘R (Recalculate Dynamic Values); nunca es
tokenizable y nunca forma parte de la cadena
Previous Answer; la exportación a PDF congela el valor actual.
Funciones enteras con bases
int, bin, oct y hex devuelven un entero exacto con la representación de base
solicitada cuando el valor es un entero exacto (hex(255) → 0xFF); en caso contrario
devuelven un valor entero estricto.
Las reglas de los enteros exactos — cómo entran las expresiones, su precedencia y su comportamiento ante desbordamiento — están en Operadores y lógica y Números y bases enteras.
Relacionado
- Etiquetas, subtotales y estadística — el funcional completo de
etiquetas y estadística tras
count,median,stdevyrand. - Variables y funciones — la guía práctica de nombres y llamadas.
- Porcentajes — patrones de frase estrictos.
- Números y bases enteras — literales de base y reglas de presentación.