Ayuda:Funciones
Esta página es un manual sobre el trabajo con algunas de las funciones utilizadas en la programación wiki y que son están presentes en el software MediaWiki. Todas las funciones tienen la forma:
- {{ #functionname: argumento 1 | argumento 2 | argumento 3 ... }}
Sumario
#expr:
| Tipo | Operadores |
|---|---|
| Agrupadores (paréntesis) | ( ) |
| Números | 1234.. 2.56.. 2.4E5 e (2.718) pi (3.142) |
| Lógicos | or, and, not |
| = , != (or <>) , > , < , <= , >= | |
| Redondeo | round , ceil , floor , abs |
| Binarios | + , - , mod |
| * , / (or div) | |
| ^ | |
| Otros | trunc , ln , sin , cos , tan , acos , asin , atan |
Esta función, evalúa una expresión matemática, y devuelve el resultado.
Los operadores disponibles están listados a continuación, en orden de preferencia. Para más información sobre la sintaxis y uso de cada operador, se puede consultar la documentación Ayuda:Operaciones de Cálculo. La exactitud y el formato del resultado devuelto, depende del sistema operativo del servidor que ejecuta la wiki, y el formáto numérico que use el servidor.
Los números se dan en decimales desde el punto decimal "."
Los operadores booleanos (verdadero/falso) consideran el 0 como falso (false) y cualquier otro (positivo o negativo) como verdadero (true).
- {{#expr: 1 and -1 }} → 1
Un valor vacío en la <expresion>, devuelve un valor vacío; una <expresion> incorrecta o con sintaxis mal formada, devolverá un error que puede ser evaluado con la función #iferror::
- {{#expr: }} →
- {{#expr: 1+ }} → Error en la expresión: falta un operando para +.
- {{#expr: 1 foo 2 }} → Error en la expresión: no se reconoce la palabra «foo».
#if
#ifeq
#ifexpr
#iferror
#ifexist
#rel2abs
#switch
#time
#titleparts
Esta función separa el título de una página –pasada la ruta como parámetro–, lo divide en segmentos según los slashes –barras (|)– que tenga, y devuelve el segmento o segmentos que se le pida.
Si no se especifica el numero de <segmentos a devolver>, el valor por defecto es 0, es decir, que se devuelven todos los segmentos.
Si no se especifica el <primer segmento> devuelto, o se especifica como 0, el valor por defecto es 1:
- {{#titleparts: Discusión:Foo/bar/baz/quok }} → Discusión:Foo/bar/baz/quok
- {{#titleparts: Discusión:Foo/bar/baz/quok | 1 }} → Discusión:Foo
- {{#titleparts: Discusión:Foo/bar/baz/quok | 2 }} → Discusión:Foo/bar
- {{#titleparts: Discusión:Foo/bar/baz/quok | | 2 }} → bar/baz/quok
- {{#titleparts: Discusión:Foo/bar/baz/quok | 2 | 2 }} → bar/baz
Se aceptan valores negativos para ambos parámetros.
Un número negativo en <segmentos a devolver>, se entiende como cuántas partes se eliminarán, contando desde el final.
Un número negativo como <primer segmento>, lo toma contando desde la derecha.
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | -1 | -3 }} → foo2/foo3
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | -2 | 3}} → baz/quok/foo1/foo2
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | 2 | -3 }} → foo2/foo3
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | 2 | 3}} → baz/quok
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | | -3 }} → foo2/foo3/foo4
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | | 3 }} → baz/quok/foo1/foo2/foo3/foo4
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | -2 }} → Discusión:Foo/bar/baz/quok/foo1/foo2
- {{#titleparts: Discusión:Foo/bar/baz/quok/foo1/foo2/foo3/foo4 | 2 }} → Discusión:Foo/bar
Advertencias
Sustitución
Una función del analizador sintáctico puede ser sustituida por su valor, de manera automática cuando se guarda la página, añadiendo el prefijo subst: al nombre de la función.
Esta "sustitución" hace que una vez que la página ha sido guardada, la parser function dejará de actuar como tal, para pasar a tener de manera definitiva, el valor que tenía en el momento exacto del guardado:
- {{#time:j/M/Y(H:i)}} → 26/abr/2024(19:27) La parser function, hace que cada vez que alguien ve esa página, se muestre la fecha/hora de la wiki local en ese momento concreto.
- {{subst:#time:j/M/Y(H:i)}} → 19/May/2009(11:27) Guarda la fecha/hora en que se guardó la página, y así queda para futuras visitas.
Tablas
Las funciones pueden arruinar la sintaxis de las wikitablas, tomando todos los caracteres de una celda, como parámetros de la función (en tanto que se usa el mismo caracter para separar celdas, que para separar parámetros «|» dentro de una parser function).
Hay dos maneras de evitar este inconveniente:
- Para evitar esto, la mayoría de las wikis disponen de la plantilla {{Plantilla:!}}, cuyo contenido es el caracter en cuestión «|». Esto, oculta el caracter problemático para el analizador de MediaWiki, asegurando que no se tenga encuenta el mismo, hasta que todas las plantillas, variables y funciones, hayan sido expandidas.
- También se puede usar la sintaxis de tablas propia del HTML.
Caracteres en blanco
Los caracteres en blanco, tabulaciones, espacios o saltos de línea son eliminados al principio y el final de todos los parámetros de estas parser function. Si se desea conservar estos caracteres especiales, se puede usar algún caracter especial del HTML, o codificación Unicode antes o después de los caracteres en blanco, tabulaciones, espacios o saltos de línea que se quieran mantener como parámetros.
- {{#ifeq: foo | foo | igual | distinto }} → igual
- {{#ifeq: foo  |  foo | igual | distinto }} → distinto
