Funciones XPath/XQuery: numéricas

www.altova.com Expandir/Contraer todos Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Anexos > Funciones XSTL y XPath/XQuery > Funciones de extensión de Altova >

Funciones XPath/XQuery: numéricas

Las funciones de extensión numéricas de Altova pueden utilizarse en expresiones XPath y XQuery y ofrecen funciones adicionales para el procesamiento de datos.

 

Nota sobre el nombre de las funciones y lenguajes

Puede utilizar todas las funciones de extensión de Altova en sus expresiones XPath/XQuery. Con ellas conseguirá funciones adicionales no disponibles en la biblioteca de funciones estándar de XPath, XQuery y XSLT.

En esta documentación el nombre de las funciones de extensión de Altova siempre termina con el sufijo [altova:] para evitar confundirlas con funciones de la biblioteca estándar. Por ejemplo: add-years-to-date [altova:].
Sin embargo, cuando las utilice en sus expresiones XPath/XQuery, no incluya ningún prefijo o sufijo en el nombre de la función. Por ejemplo: add-years-to-date(xs:date("2014-01-15"), 10).

 

Funciones XPath

(en expresiones XPath en XSLT):

XP1 XP2 XP3.1

Funciones XSLT

(en expresiones XPath en XSLT):

Xslt1 XSLT2 XSLT3

Funciones XQuery

(en expresiones XQuery en XQuery):

XQ1 XQ3.1

 

 

 

Funciones de numeración automática

Haga clic para expandir/contraergenerate-auto-number [altova:]

generate-auto-number(ID como xs:string, EmpiezaPor como xs:double, Incremento como xs:double, RestaurarAlCambiar como xs:string) como xs:integer   XP1 XP2 XQ1 XP3.1 XQ3.1

Genera un número cada vez que se llama a la función. El primer número, que se genera cuando se llama a la función por primera vez, viene dado por el argumento EmpiezaPor. Cada llamada posterior genera un número nuevo, que se incrementa en función del valor especificado en el argumento Incremento. De hecho, la función generate-auto-number crea un contador llamado como indique el argumento ID y este contador se incrementa cada vez que se llama a la función. Si el valor del argumento RestaurarAlCambiar cambia con respecto al valor que tenía en la llamada anterior, entonces el valor del número que se debe generar se restablece con el valor de EmpiezaPor. También puede restablecer la numeración automática con la función reset-auto-number.

 

generate-auto-number("ChapterNumber", 1, 1, "SomeString")

Devuelve un número cada vez que se llama a la función, empezando por 1 y con un incremento de 1 con cada llamada a función. Si el cuarto argumento continúa siendo "SomeString" en las llamadas posteriores, el incremento continuará. Cuando cambie el valor del cuarto argumento, se restaura el valor 1 del contador (llamado ChapterNumber). El valor de ChapterNumber también se puede restaurar llamando a la función reset-auto-number("ChapterNumber").

 

 

Haga clic para expandir/contraerreset-auto-number [altova:]

reset-auto-number(ID como xs:string)   XP1 XP2 XQ1 XP3.1 XQ3.1

Esta función restaura el número del contador de numeración automática especificado en el argumento ID. El número se reemplaza con el número indicado en el argumento EmpiezaPor de la función generate-auto-number que creó el contador especificado en el argumento ID.

 

reset-auto-number("ChapterNumber") restablece el número del contador de numeración automática llamado ChapterNumber que se creó con la función generate-auto-number. El número se reemplaza con el valor del argumento EmpiezaPor de la función generate-auto-number que creó ChapterNumber.

 

 

[ Subir ]

 

Funciones numéricas

Haga clic para expandir/contraerhex-string-to-integer [altova:]

hex-string-to-integer(CadenaHex as xs:string) como xs:integer     XP3.1 XQ3.1

Toma un argumento de cadena que es el equivalente Base-16 de un entero del sistema decimal (Base-10) y devuelve un entero decimal.

hex-string-to-integer('1') devuelve 1
hex-string-to-integer('9') devuelve 9
hex-string-to-integer('A') devuelve 10
hex-string-to-integer('B') devuelve 11
hex-string-to-integer('F') devuelve 15
hex-string-to-integer('G') devuelve un error
hex-string-to-integer('10') devuelve 16
hex-string-to-integer('01') devuelve 1
hex-string-to-integer('20') devuelve 32
hex-string-to-integer('21') devuelve 33
hex-string-to-integer('5A') devuelve 90  
hex-string-to-integer('USA') devuelve un error

 

 

Haga clic para expandir/contraerinteger-to-hex-string [altova:]

integer-to-hex-string(Entero as xs:integer) como xs:string     XP3.1 XQ3.1

Toma el argumento Entero y devuelve su equivalente Base-16 en forma de cadena.

hmtoggle_plus1 Ejemplos

integer-to-hex-string(1) devuelve '1'
integer-to-hex-string(9) devuelve '9'
integer-to-hex-string(10) devuelve 'A'
integer-to-hex-string(11) devuelve 'B'
integer-to-hex-string(15) devuelve 'F'
integer-to-hex-string(16) devuelve '10'
integer-to-hex-string(32) devuelve '20'
integer-to-hex-string(33) devuelve '21'
integer-to-hex-string(90) devuelve '5A'  

 

 

[ Subir ]

 

Funciones de formato numérico

Clic para expandir/contraermt-format-number [altova:]

mt-format-number(Número como xs:numericCadenaImagen como xs:string) como xs:string     XP3.1 XQ3.1

Toma un número como primer argumento, le aplica formato en función del segundo argumento (CadenaImagen) y devuelve el número con formato en forma de cadena. Esto es muy práctico a la hora de aplicar un formato menos complicado a números que se leen con dificultad. La cadena de imagen también puede contener caracteres (como símbolos de divisas, por ejemplo) y también se puede usar para insertar caracteres en el resultado con el nuevo formato. Si desea insertar un cero en la posición de un dígito cuando el dígito no existe en esa posición del número de entrada, utilice un cero en esa posición en la cadena de imagen (ver ejemplos más abajo). Si no desea forzar un cero (o cualquier otro carácter), utilice el símbolo #.

 

Los dígitos que preceden al separador decimal nunca se acortan. La parte decimal de un número (situada a la derecha del separador decimal), así como el dígito de unidades (el primer dígito que aparece a la izquierda del separador decimal) se redondean si la cadena de imagen de la parte decimal es menor que el número de posiciones decimales del número de entrada.

 

Nota: el separador de grupos y de decimales del resultado con el nuevo formato en el dispositivo móvil serán lo del idioma utilizado en el dispositivo.

mt-format-number(12.3, '$#0.00') devuelve $12.30
mt-format-number(12.3, '$00.00') devuelve $12.30
mt-format-number(12.3, '$0,000.00') devuelve $0,012.30
mt-format-number(12.3, '$#,000.00') devuelve $012.30
mt-format-number(1234.5, '$#,##0.00') devuelve $1,234.50
mt-format-number(1234.5, '$#0.00') devuelve $1234.50
mt-format-number(123.4, '$0') devuelve $123
mt-format-number(1234.5, '$0') devuelve $1235
mt-format-number(1234.54, '$0.0') devuelve $1234.5
mt-format-number(1234.55, '$0.0') devuelve $1234.6

 

 

Haga clic para expandir/contraergenerate-auto-number [altova:]

generate-auto-number(ID como xs:string, EmpiezaPor como xs:double, Incremento como xs:double, RestaurarAlCambiar como xs:string) como xs:integer   XP1 XP2 XQ1 XP3.1 XQ3.1

Genera un número cada vez que se llama a la función. El primer número, que se genera cuando se llama a la función por primera vez, viene dado por el argumento EmpiezaPor. Cada llamada posterior genera un número nuevo, que se incrementa en función del valor especificado en el argumento Incremento. De hecho, la función generate-auto-number crea un contador llamado como indique el argumento ID y este contador se incrementa cada vez que se llama a la función. Si el valor del argumento RestaurarAlCambiar cambia con respecto al valor que tenía en la llamada anterior, entonces el valor del número que se debe generar se restablece con el valor de EmpiezaPor. También puede restablecer la numeración automática con la función reset-auto-number.

 

generate-auto-number("ChapterNumber", 1, 1, "SomeString")

Devuelve un número cada vez que se llama a la función, empezando por 1 y con un incremento de 1 con cada llamada a función. Si el cuarto argumento continúa siendo "SomeString" en las llamadas posteriores, el incremento continuará. Cuando cambie el valor del cuarto argumento, se restaura el valor 1 del contador (llamado ChapterNumber). El valor de ChapterNumber también se puede restaurar llamando a la función reset-auto-number("ChapterNumber").

 

 

[ Subir ]

 


© 2019 Altova GmbH