Help:Extension:ParserFunctions/gl

The extension provides eleven additional parser functions to supplement the "magic words", which are already present in MediaWiki. (It may be configured to provide additional parser functions for string handling; these string functions are documented .) All the parser functions provided by this extension take the form:

#expr
Esta función calcula a expresión matemática e devolve o seu resultado. This function is also available in Scribunto via the  function.



Os operadores dispoñibles son clasificados á dereita, en orde de precedencia. Véxase para máis detalles da función de cada operador. A precisión e o formato do resultado devolto cambiará a depender do sistema operativo do servidor correndo a wiki, e o formato de número da linguaxe do sitio.

Cando avaliar usando álxebra booleana, o valor cero é avaliado coma  (falso) e calquera valor distinto de cero, positivo ou negativo, é avaliado coma   (verdadeiro):



Unha expresión de entrada baleira retorna un valor string baleiro. Expresións inválidas retornan unha das varias mensaxes de erro, que poden ser capturadas usando a función :



A orde de operandos de adición e subtracción antes ou despois de un número é significativa, podendo este ser tratado coma un valor positivo ou negativo en lugar dun operando cunha entrada errónea:



Note, if using the output of magic words, you must raw format them in order to remove commas, and translate the numerals. For example results in, where we want 0, which can be obtained using. This is especially important in some languages, where numerals are translated. For example, in Bengali, produces ৩০,০৬১.



Arredondamento
Redondea o número á esquerda a un múltiple de 1/10 elevado a unha potencia, co expoñente igual ó valor truncado do número á dereita.

Para redondear para cima ou para baixo débese usar os operadores unarios ou , respectivamente.

#if
Esta función avalía un string de test e determina se está baleiro ou non. Considérase que un string de test que posúe soamente espazo en branco está baleiro.





Esta función primeiro proba se o primeiro parámetro non está baleiro. Se tal non está baleiro, a función mostra o segundo. Se o primeiro parámetro está baleiro ou contén soamente caracteres en branco (espazos, quebra de liña etc.), móstrase o terceiro.



String de test é sempre interpretado coma texto puro, así expresións matemáticas non son analizadas:



The last parameter (false) may be omitted:



The function may be nested. To do so, nest the inner #if function in its full form in place of a parameter of the enclosing #if function. A depth of at least seven levels of nesting is possible, although that may depend on the wiki or a memory limit.
 * Example:

You can also use a parameter as the test string in your #if statement. You need to ensure you add the | (pipe symbol) after the name of the variable.


 * Example

Véxase Help:Parser functions in templates para máis exemplos desta función.

#ifeq
Esta función compara dous strings e determina se son idénticos.



Se ambos os dous strings son valores numéricos válidos, son comparadas numericamente:



En caso contrario, a comparación é feita coma texto; esta comparación é sensible a letras maiúsculas:


 * →  (compare con exemplo similar arriba, sen comiñas)
 * →  (compare con exemplo similar arriba, con  )
 * →  (compare con exemplo similar arriba, sen comiñas)
 * →  (compare con exemplo similar arriba, con  )

Como un exemplo práctico, dado un modelo existente  usado para establecer tamaños estándares de curtos e longos, definido como:

resulta no seguinte:


 * → 20
 * → 40
 * → 40

#iferror
This function takes an input string and returns one of two results; the function evaluates to  if the input string contains an HTML object with , as generated by other parser functions such as  ,   and  , template errors such as loops and recursions, and other "failsoft" parser errors.



Un ou ambos os strings de retorno poden ser omitidos. Se o string  é omitido, o   é devolto se non estiver errado. Se o string  é tamén omitido, un string baleiro é devolto nun erro:


 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;
 * → &zwnj;

#ifexpr
Esta función avalía unha expresión matemática e devolve un de dous strings, dependendo do valor binario do resultado:



A entrada de  é avaliada exactamente como está por   arriba, cos mesmos operadores que están dispoñibles. A saída é entón avaliada como sendo unha expresión binaria.

Unha expresión de entrada baleira avalía cara :



Como mencionado arriba, cero avalía cara  e calquera valor non cero avalía cara , así esta función é equivalente a unha utilizando soamente   e  :



agás unha expresión de entrada baleira ou equivocada (unha mensaxe de erro é tratada coma string baleiro; non é igual a cero, así poñemos ).

comparando

Calquera ou ambos os valores de retorno poden ser omitidos; ningunha saída é dada cando o sitio apropiado é deixado baleiro:



#ifexist
Esta función toma un string de entrada, interprétao coma un título de páxina, e devolve un de dous valores, dependendo se páxina existe na wiki local ou non.



A función avalía coma  (verdadeiro) se a páxina existe, se contén contido, está visiblemente baleiro (contén meta-datos como ligazóns de categoría ou palabras máxicas, pero ningún contido visible), está baleira, ou é unha redirección. Soamente páxinas que son ligazóns vermellas avalían cara falso, incluíndo se a páxina existía mais foi borrada.



A función trata coma  (verdadeiro) para mensaxes de sistema que foron personalizadas, e para páxinas especiais que son definidas polo software.



Se unha páxina comproba un destino utilizando, entón tal páxina aparecerá na lista  para a páxina de destino. Así se o código  foi incluído en tempo de execución nesta páxina, /Foo listará.

En wikis que utilizan un repositorio compartido de medias,  pode ser utilizada para comprobar se un arquivo foi cargado ó repositorio, pero non á wiki de per se:

Se unha páxina de descrición local foi creada para o arquivo, o resultado é existe para tódolos ítens arriba.

non funciona con ligazóns de interwiki.

Limites de ifexist
Cando este límite é superado, calquera outra función #ifexist: automaticamente devolve falso, se a páxina de destino existe ou non, e a páxina é clasificada en Category:. O nome da tracking category pode variar dependendo da lingua do contido da wiki.

Nalgúns casos de é posíbel emular o efecto de ifexist con CSS, usando os selectores  (para seleccionar as ligazóns das páxinas inexistentes) ou   (para seleccionar as ligazóns páxinas existentes). Ademais, porque a cantidade de funcións sintácticas custosas que poden ser utilizadas nunha soa páxina é controlada por, pódese aumentar este límite en LocalSettings.php, se for preciso.

#rel2abs
Esta función converte un camiño de arquivo relativo nun absoluto.



Dentro da entrada de, a sintaxe s seguir é válida:
 * → o nivel actual
 * → "suba un nivel"
 * → "vai cara un nivel abaixo no subdirectorio /foo"

Se o  non é especificado, o nome completo da páxina nela será utilizado en seu lugar:



Sintaxe errónea, coma  ou , é ignorada. Vez que non máis que dous puntos consecutivos son permitidos, secuencias coma estas poden ser utilizadas para separar declaracións sucesivas:



#switch
Esta función proba un valor de entrada contra varios casos de test, devolvendo unha cadea asociada se unha correspondencia é atopada.

Exemplos:




 * 1) switch with partial transclusion tags can effect a configuration file that enables an editor unfamiliar with template coding to view and edit configurable elements.

Estándar
O  é devolto se ningún string dos   combina có  :



Nesta sintaxe, o resultado estándar debe ser o último parámetro e non debe conter un sinal de igual puro.



Alternativamente, o resultado estándar pode ser explicitamente declarado cun string de  para " ".

Un resultado estándar declarado desta forma pode ser posto en calquera sitio dentro da función:



Se o parámetro  (estándar) é omitido e ningunha correspondencia é atopada, ningún   (resultado) é devolto:



Agrupando resultados
É posible ter valores 'malogrados', cando varias strings de  devolven a mesma cadea de   (resultado). Isto minimiza duplicación.

Here cases 2, 3 and 4 all return ; cases 6 and 7 both return

Comportamento de comparación
Tal como con, a comparación é feita numericamente se tanto o string de comparación coma o string de caso so proba son numéricas; ou como string sensible a letras maiúsculas doutra forma:





O string de  pode ser baleiro:

Unha vez unha correspondencia é atopada, os  (casos) seguintes son ignorados:

Sinais de igual puros
Strings de "caso" non poden conter sinais de igual puros. Para contornar isto, débese crear un modelo = contendo un sinal de igual simple:.

Exemplo:



For a simple real life example of the use of this function, check Template:NBA color. Two complex examples can be found at and Template:BOTREQ.

Substituíndo #ifeq
pode ser utilizado reducir profundidade de expansión.

Por exemplo: é equivalente a i.e.

#time
Esta función sintáctica toma unha data e/ou hora (no calendario gregoriano) e formata conforme a sintaxe dada. Un obxecto de data/hora pode ser especificado; o estándar é o valor da palabra máxica  – é dicir, a hora na que a páxina foi por último traducída en HTML.



A lista de códigos de formato aceptados é dada na táboa á dereita. Calquera carácter na texto so formato que non é recoñecida é pasado completamente inalterado; isto aplícase para tamén borrar espazos (o sistema non os necesita para interpretar os códigos). Hai tamén dúas formas de escaparse de carácteres dentro do texto formato: Ademais, o dígrafo  é interpretado como un só carácter "x".
 * 1) Unha barra invertida seguido por un carácter é interpretado exactamente coma un único carácter
 * 2) Caracteres entre comiñas son considerados caracteres literais, e as comiñas son sacadas.



The  can be in any format accepted by PHP's strtotime function. Both absolute (eg ) and relative (eg  ) times are accepted.

→ '''

→ '''

→ '''

O código da lingua en ISO 639-3 (?) permite mostrar o texto na lingua escollida → '''

→ '''

→  

Se xa se calculou un data e hora en Unix, pódese utilizar esta forma de cálculo en operacións con data preto coa anteposición do símbolo.

→ '''

→ '''

Datas absolutas completas ou non poden ser especificadas; a función "completará" as partes da data que non son dadas, utilizándose dos valores actuais:



Coa Revisión MediaWiki r86805, un número de catro díxitos será interpretado coma un ano, endexamais coma hora e minutos:

→ '''

Un número de seis díxitos é interpretado coma horas, minutos e segundos, se posíbel, pero, por outra banda, coma un erro (non, por exemplo, un ano e un mes):

→ ''' A entrada é tida coma unha hora máis do que un código de ano+mes.

→ ''' Aínda que 19:60:09 non sexa unha hora válida, 196009 non é interpretado coma setembro de 1960.

A función realiza un certo número de operacións con data:



The total length of the format strings of the calls of  is limited to 6000 characters.

Choiando con fusos horarios
There is a bug in this #time parser function (more specifically in PHP DateTime) that does not allow the passing-in of non-integers as relative time zone offsets. This issue does not apply when using an on-the-hour time zone, such as EDT. For example:

However, Venezuela is on a -4.5 hours time offset from UTC, and thus using its time zone will not normally allow the correct calculation of a relative time zone offset. Here's what happens: Para contornar esta situación, pódese converter o tempo en minutos ou segundos, así:

(Tim Starling, o desenvolvedor desta función, forneceu a sintaxe exacta para esta solución.)

#timel
This function is identical to, except that it uses the local time of the wiki (as set in ) when no date is given.



#titleparts
This function separates a page title into segments based on slashes, then returns some of those segments as output.



If the number of segments to return parameter is not specified, it defaults to "0", which returns all the segments from the first segment to return (included). If the first segment to return parameter is not specified or is "0", it defaults to "1":


 * →  See also.
 * →  See also.

Negative values are accepted for both values. Negative values for the number of segments to return parameter effectively 'strips' segments from the end of the string. Negative values for the first segment to return translates to "start with this segment counting from the right":


 * →  Elimina un segmento do fin do string. Véxase tamén.
 * →   Elimina os 4 segmentos do fin do string
 * →   Elimina 5 segmentos do fin do string (máis do que existen)
 * →   Devolve o último segmento. Véxase tamén.
 * →   Elimina un segmento do fin do string, entón devolve do segundo segmento en diante
 * →   Empeza a copiar no segundo último elemento; extrae un segmento do fin do string

Before processing, the pagename parameter is HTML-decoded: if it contains some standard HTML character entities, they will be converted to plain characters (internally encoded with UTF-8, i.e. the same encoding as in the MediaWiki source page using this parser function).


 * For example, any occurence of,  , or   in pagename will be replaced by.
 * No other conversion from HTML to plain text is performed, so HTML tags are left intact at this initial step even if they are invalid in page titles.

Then the decoded pagename is canonicalized into a standard page title supported by MediaWiki, as much as possible:


 * 1) All underscores are automatically replaced with spaces:
 * →  Not bah_boo, despite the underscore in the original.
 * 1) O texto de entrata posúe o límite de 25 cortes; as barras a máis son ignoradas e o 25º elemento conterá o resto do texto. O texto é tamén limitado a 255 caracteres, e é tratado como un título de páxina:
 * Se por calquera razón necesítase forzar esta función ó seu límite, aínda que moi improbable, é posible contornar o límite de 25 cortes agrupándose unha función dentro doutra:
 * 1) The list of substrings is not cleaned up hierarchically (unlike with the   and   relative path segments are left intact by #titleparts):
 * 2) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
 * 1) The list of substrings is not cleaned up hierarchically (unlike with the   and   relative path segments are left intact by #titleparts):
 * 2) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
 * 1) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).
 * 1) Finally the first substring is capitalized according to the capitalization settings of the local wiki (if that substring also starts by a local namespace name, that namespace name is also normalized).

{{ | 1 = Certain characters that are illegal in a page title will cause #titleparts to not parse the string:


 * → {{#titleparts: {one/two} | 1 | 1 }}. Non retorna o resultado esperado: {one
 * → {{#titleparts: page/123 | 1 | 2 }}. Does not work because brackets are illegal in page titles and this parser function does not process links embedded in its input pagename parameter, even when they use the MediaWiki syntax, or any other HTML or MediaWiki tags.
 * → "{{#titleparts: red/#00FF00/blue| 1 | 3 }}". Does not work because "#" is also illegal in page titles.

}}

{{ {{TNTN|Warning}}| 1 = Esta función non se degrada ordinariamente se a súa entrada supera 255 carácteres. Se o texto for maior que 256 caracteres, esta función sinxelamente retornará o mesmo texto. }}

Substitución
As funcións sintácticas poden ser substituídas engadindose o termo  antes do carácter #;


 * → o código   será engadido no texto wiki se a páxina existir.

Substitution does not work within, you can use &hellip;  for this purpose.

Redireccións
Especially   could be handy in redirects to pages including dates, but this does not work.

Elidindo o carácter de barra vertical en táboas
As funcións sintácticas estragarán as sintaxe de táboas wiki e caracteres de barra vertical, tratando tódolas barras verticais coma divisores de parámetros. Para evitar isto, a maior parte wikis crean un modelo    :! cos seus contidos soamente un carácter puro de barra vertical  ou usan a  palabra máxica   que está dispoñible dende a versión MW 1.24. Isto 'esconde' a barra vertical da sintaxe MediaWiki, asegurando que non será considerado ata que despois de todo os modelos e variables sobre unha páxina sexan expandidos. Será entón interpretado coma unha liña de táboa ou divisor de columna. Alternativamente, o código de táboa en HTML puro pode ser utilizado, aínda que isto sexa menos intuitivo e máis propenso de erro.

Pódese tamén escaparse do carácter de barra vertical, para mostralo coma un carácter simple non interpretado, utilizando unha entidade de carácter HTML:.

Eliminación de espazos en branco
Espazos en branco, incluíndose os caracteres de liña nova, tabuladores e espazo, son elididos antes e despois de cada un dos parámetros das funcións sintácticas. Para impedir que tal suceda, as comparacións de texto poden ser feitas engadindo comiñas.



For preventing trimming then- and else-parts, see m:Template:If. Some people use also &lt; nowiki &gt; &lt; /nowiki &gt; instead of spaces.


 * → foofoo
 * → foofoo

But this method allows the rendering of only one whitespace, since the parser reduce multiple spaces to a single one.


 * →  foofoo 

Neste exemplo, o estilo  é utilizado para formar con que os espazos en branco sexan preservados polo navegador, aínda así os espazos non son mostrados. Isto sucede porque os espazos son eliminados polo software, antes de envialos ó explorador.

É posíbel contornar este comportamento cambiando espazos en branco por  (carácter de espazo, ou espazo crebadizo) ou   (espazo sen quebra, ou espazo ríxido), pois non son modificados polo software:


 * →  foofoo 
 * → foofoo

Véxase tamén

 * Help:Calculation (on Meta)
 * on Meta
 * on Meta
 * Module:String obsoleting Extension:StringFunctions
 * Module:String obsoleting Extension:StringFunctions
 * Module:String obsoleting Extension:StringFunctions