XPath, XQuery e funções XSLT
O manual de referência a seguir define as funções XPath 2.0, XQuery 1.0 e XSLT 2.0.
Função Manual de Referência
A função de prefixo namespace padrão para fn:
Função namespace URI é: http://www.w3.org/2005/xpath-functions
função de acesso
nome | explicação |
---|---|
fn: node-name (nó) | Retorna o nó do nome do parâmetro de nó. |
fn: nilled (nó) | Retorna se a rejeitar o valor booleano nó argumento. |
fn: data (item.item, ...) | Aceitar a sequência do projeto e retorna a seqüência de valores atômicos. |
| Retorna o valor do atributo base-uri corrente especifica o nó ou nós. |
fn: document-uri (nó) | Retorna o valor da propriedade documento-uri nó especificado. |
Erros e funções de rastreamento
nome | explicação |
---|---|
| Exemplos: erro (fn: QName ( "http://example.com/test ',' err: toohigh '),' Erro: O preço é alto demais ') Resultados: Devoluções http://example.com/test#toohigh~~number=plural e corda para o ambiente de processamento externo "Erro: O preço é muito alto". |
fn: trace (valor, rótulo) | Ele é usado para consultar depuração. |
valores funções relacionadas
nome | explicação |
---|---|
fn: número (arg) | Retorna o valor do parâmetro. Parâmetro é um valor, corda, ou conjunto de nós booleana. Exemplos: número ( '100') Resultados: 100 |
fn: abs (num) | Devolve o valor absoluto do parâmetro. Exemplos: abs (3,14) Resultados: 3,14 Exemplos: abs (-3.14) Resultados: 3,14 |
fn: Teto (num) | Retorna o menor inteiro maior que o parâmetro num. Exemplos: Teto (3,14) Resultados: 4 |
fn: floor (num) | Retorna o maior inteiro não maior que o parâmetro num. Exemplos: andar (3,14) Resultados: 3 |
fn: round (num) | O argumento num arredondado para o número inteiro mais próximo. Exemplos: round (3,14) Resultados: 3 |
fn: round-meia-a-par () | Exemplos:-to round-meia-even (0,5) Resultados: 0 Exemplos:-to round-meia-even (1,5) Resultados: 2 Exemplos:-to round-meia-even (2,5) Resultados: 2 |
Funções cerca de cordas
nome | explicação |
---|---|
fn: string (arg) | Retorna o valor string do parâmetro. Os argumentos podem ser números, valores lógicos, ou conjunto de nós. Exemplos: string (314) Resultado: O "314" |
fn: codepoints-to-string (int, int, ...) | De acordo com a sequência de ponto de código retorna um string. Exemplos: codepoints-to-string (84, 104, 233, 114, 232, 115, 101) Resultados: 'Teresa' |
fn: string-to-codepoints (string) | De acordo com a sequência de ponto de código seqüência de retorno. Exemplos: string-to-codepoints ( "Therese") Resultado: 84, 104, 233, 114, 232, 115, 101 |
fn: codepoint-igual (comp1, comp2) | De acordo com a comparação de ponto de código Unicode, se o valor for igual ao valor comp2 comp1 Retorna verdadeiro. (Http://www.w3.org/2005/02/xpath-functions/collation/codepoint), caso contrário, retorna false. |
| Se comp1 menos de comp2, -1 é retornado. Se comp1 igual comp2, 0 é retornado. Se Comp1 maior que comp2, 1 é retornado. (De acordo com as regras usadas pelo controle). Exemplo: comparar ( "ghi ',' ghi ') Resultados: 0 |
fn: concat (String, String, ...) | Retorna a concatenação. Exemplos: concat ( 'XPath', 'é', 'FUN!') Resultados: 'XPath é FUN!' |
fn: string-join ((string, string, ...), setembro) | Use setembro como o argumento delimitador para retornar a string parâmetro de cadeia depois de costura. Exemplos: string-join ( '! Fun' ( 'Nós', 'são', 'ter',), '') Resultados: 'Nós estamos tendo o divertimento! " Exemplos: string-join ( '! Fun' ( 'Nós', 'são', 'ter',)) Resultados: 'Wearehavingfun!' Exemplos: string-join ((), 'setembro') Resultados: '' |
| Retorna a subsequência da posição inicial do começo do comprimento especificado. Índice do primeiro caractere é 1. Se você omitir o argumento len da posição inicial ao final de uma string é retornado. Exemplos: substring ( 'Beatles', 1,4) Resultados: 'Beat' Exemplos: substring ( 'Beatles', 2) Resultados: 'eatles' |
| Retorna o comprimento da corda. Se não houver nenhum argumento string, o comprimento do valor de cadeia do nó atual é retornado. Exemplos: cadeia de comprimento ( 'Beatles') Resultados: 7 |
| Remover o início eo fim da seqüência especificada em branco, em branco e todos substituídos por uma série de interna e retorna o resultado. Se não houver um argumento de cadeia, o processo do nó actual. Exemplos: normalize-space ( 'The XML') Resultados: 'O XML' |
fn: normalize-unicode () | Implementação de Unicode de normalização. |
fn: maiúsculas (string) | O argumento de cadeia para maiúsculas. Exemplos: maiúsculas ( 'The XML') Resultados: 'O XML' |
fn: lower-case (string) | O argumento de cadeia convertido para minúsculas. Exemplos: minúsculas ( 'The XML') Resultados: 'xml' |
fn: translate (string1, string2, string3) | O string1 em string2 substituído string3. Exemplos: translate ('12: 30 ',' 30 ',' 45 ') Resultados: '12: 45 ' Exemplos: translate ('12: 30 ',' 03 ',' 54 ') Resultados: '12: 45 ' Exemplos: translate ('12: 30 ',' 0123 ',' ABCD ') Resultados: 'BC: da' |
fn: escapar-uri (stringURI, ESC-res) | Exemplos: escapar-uri ( "http://example.com/test#car", true ()) Resultados: "http% 3A% 2F% 2Fexample.com% 2Ftest # carro" Exemplos: escapar-uri ( "http://example.com/test#car", false ()) Resultado: "http://example.com/test#car" Exemplos: escapar-uri ( "http://example.com/~bebe", false ()) Resultado: "http://example.com/~b%C3%A9b%C3%A9" |
fn: contains (string1, string2) | Se string1 contém string2, ele retorna true, caso contrário, retorna false. Exemplos: contém ( 'XML', 'XM') Resultados: true |
fn: inicia-com (string1, string2) | Se string1 começa com string2, ele retorna true, caso contrário, retorna false. Exemplos: começa-com ( 'XML', 'X') Resultados: true |
fn: termina-com (string1, string2) | Se string1 com final string2 retorna verdadeiro, caso contrário, retorna false. Exemplos: fins-de-com ( 'XML', 'X') Resultados: falsos |
fn: substring-before (string1, string2) | Retorna uma subseqüência de string1 string2 aparecer antes. Exemplos:-subcadeia antes ('12 / 10 ',' / ') Resultados: '12 ' |
fn: substring-after (string1, string2) | Retorna uma subseqüência de string1 String2 aparecer mais tarde. Exemplos: subcadeia-depois ('12 / 10 ',' / ') Resultados: '10 ' |
fn: partidas (string, padrão) | Se a string corresponde ao padrão especificado, ele retorna true, caso contrário, retorna false. Exemplos: jogos ( "Merano", "correu") Resultados: true |
fn: substituir (string, teste padrão, substituir) | O modo especificado é substituído substituir parâmetro e retorna o resultado. Exemplos: substituir ( "Bella Italia", "l", "*") Resultados: 'Seja ** um Ita * ia' Exemplos: substituir ( "Bella Italia", "l", "") Resultados: 'Bea Itaia' |
fn: tokenize (string, padrão) | Exemplos: tokenize ( "XPath é divertido", "\ s +") Resultados :( "XPath", "é", "divertimento") |
função anyURI para
nome | explicação |
---|---|
fn: resolve-uri (relativa, base) |
Funções de valores booleanos
nome | explicação |
---|---|
fn: boolean (arg) | Retorna um valor numérico, string, ou conjunto de nós booleana. |
fn: não (arg) | Em primeiro lugar, a função booleana () para restaurar os parâmetros de um valor booleano. Se o valor booleano é falso, ele retorna true, caso contrário, ele retorna true. Exemplo: não (true ()) Resultados: falsos |
fn: true () | Retorna um valor booleano verdadeiro. Exemplos: true () Resultados: true |
fn: false () | Retorna um falso valor booleano. Exemplos: false () Resultados: falsos |
Funções relacionadas com a duração, a data e a hora
Data, hora, duração da função de componentes de extracção
nome | explicação |
---|---|
fn: dateTime (data, hora) | Os argumentos para data e hora. |
fn: anos-de-duração (datetimedur) | A parte inteira do Ano do valor de retorno de uma notação padrão para representar palavras. |
fn: meses longe de duração (datetimedur) | Retorna a parte inteira dos valores dos parâmetros do mês, uma notação padrão para representar palavras. |
fn: dias-de-duração (datetimedur) | Retorna a parte inteira dos valores dos parâmetros do dia, uma notação padrão para representar palavras. |
fn: horas-de-duração (datetimedur) | Retorna a parte inteira dos valores dos parâmetros da hora, a notação padrão para representar palavras. |
fn: minutos-de-duração (datetimedur) | Retorna a parte inteira da ata os valores dos parâmetros, a notação padrão para representar palavras. |
fn: segundos-de-duração (datetimedur) | Retorna a parte decimal do número de minutos de valores de parâmetros, uma notação padrão para representar palavras. |
fn: ano-dateTime (data e hora) | Retorna os valores de parâmetro inteiro na seção local. Exemplos: ano de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10")) Resultados: 2005 |
fn: mês de-dateTime (data e hora) | Retorna a parte inteira de os valores dos parâmetros locais mensais. Exemplos: mês de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10")) Resultados: 01 |
fn: dia de-dateTime (data e hora) | Retorna a parte inteira dos valores dos parâmetros locais dia. Exemplos: dia de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10")) Resultados: 10 |
fn: horas-de-dateTime (data e hora) | Retorna a parte inteira de as horas de parâmetro valores locais. Exemplos: horas-from-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10")) Resultados: 12 |
fn: minutos-de-dateTime (data e hora) | Retorna a parte inteira de os parâmetros do valor local minutos. Exemplos: minutos-de-dateTime (xs: dateTime ( "2005-01-10T12: 30-04: 10")) Resultados: 30 |
fn: segundos-de-dateTime (data e hora) | Retorna a parte decimal do segundo valores de parâmetros locais. Exemplos: segundos de-dateTime (xs: dateTime ( "2005-01-10T12: 30: 00-04: 10")) Resultados: 0 |
fn: fuso horário de-dateTime (data e hora) | Retorna a parte de região, se presente. |
fn: year-de-date (data) | Em valores inteiros de retorno que representam os parâmetros locais. Exemplos: ano-from-date (xs: date ( "2005-04-23")) Resultados: 2005 |
fn: mês da data (data) | mês inteiro Retorna o valor local do parâmetro indicado. Exemplos: mês da data (xs: date ( "2005-04-23")) Resultados: 4 |
fn: Dia-de-date (data) | Dia retornar um valor inteiro representa o parâmetro local. Exemplos: dia-from-date (xs: date ( "2005-04-23")) Resultados: 23 |
fn: fuso horário-de-date (data) | Retorna a parte de região, se presente. |
fn: horas-de-time (tempo) | Retorna as horas porção inteira valores de parâmetros locais representados. Exemplos: horas-de-time (xs: tempo ( "10:22:00")) Resultados: 10 |
fn: minutos-de-time (tempo) | Retorna a parte inteira dos parâmetros do valor do minuto local representa. Exemplos: minutos-de-time (xs: tempo ( "10:22:00")) Resultados: 22 |
fn: segundos-de-time (tempo) | A parte inteira do segundo valor de parâmetro de retorno indica o local. Exemplos: segundos-de-time (xs: tempo ( "10:22:00")) Resultados: 0 |
fn: fuso horário-de-time (tempo) | Retorna a parte de região, se presente. |
fn: ajustar-dateTime-se fuso horário (data e hora, fuso horário) | Se o argumento do fuso horário é vazio, ele retorna nenhum fuso horário dateTime. Caso contrário, ele retorna dateTime com fuso horário. |
fn: ajustar-data-to-fuso horário (data, fuso horário) | Se o argumento do fuso horário é vazio, ele retorna nenhum fuso horário data. Caso contrário, ele retorna atualizado com o fuso horário. |
fn: ajustar-time-to-fuso horário (hora, fuso horário) | Se o argumento do fuso horário é vazio, ele retorna nenhum fuso horário tempo. Caso contrário, com o tempo de fuso horário. |
E QNames funções relacionadas
nome | explicação |
---|---|
fn: QName () | |
fn: local,-name-from-QName () | |
fn: namespace-uri-from-QName () | |
fn: namespace-uri-de-prefixo () | |
fn: no escopo-prefixos () | |
fn: resolve-QName () |
Uma função do nó
nome | explicação |
---|---|
| Retorna o nome do nó atual ou especificar o primeiro nó do cluster. |
| Retorna o primeiro do nome do nó atual ou especificar um nó no cluster - sem prefixo de namespace. |
| Retorna o nó especificado ou os nós do cluster atual namespace URI do primeiro nó. |
fn: lang (lang) | Se o idioma do nó atual corresponde ao idioma especificado, ele retorna true. Exemplos: Lang ( "en") é verdadeiro para <p xml: lang = "PT"> ... </ p> Exemplos: Lang ( "de") é falsa para <p xml: lang = "PT"> ... </ p> |
| Retorna o nó raiz da árvore ou o nó atual nó especificado pertence. Normalmente, um nó de documento. |
sequências de funções relacionadas
função geral
nome | explicação |
---|---|
fn: index-de ((item, item, ...), searchitem) | Voltar no projeto igual aos parâmetros searchitem posição sequência. Exemplos: índice-de ((15, 40, 25, 40, 10), 40) Resultados: (2, 4) Exemplos: índice-de (( "um", "cão", "e", "uma", "pato"), "uma") O resultado (1, 4) Exemplos: índice-de ((15, 40, 25, 40, 10), 18) Resultados :() |
fn: remove ((item, item, ...), posição) | Ele retorna uma nova seqüência de configuração do item parâmetro - excluir parâmetro posição especifica o projeto. Exemplos: remove (( "ab", "cd", "ef"), 0) Resultados :( "ab", "cd", "ef") Exemplos: remove (( "ab", "cd", "ef"), 1) Resultados :( "cd", "ef") Exemplos: remove (( "ab", "cd", "ef"), 4) Resultados :( "ab", "cd", "ef") |
fn: vazio (item, item, ...) | Se o valor do parâmetro é uma seqüência vazia, ele retorna true, caso contrário, retorna false. Exemplos: vazio (remover (( "ab", "cd"), 1)) Resultados: falsos |
fn: existe (item, item, ...) | Se o valor do parâmetro não é uma seqüência vazia, ele retorna true, caso contrário, retorna false. Exemplos: existe (remove (( "ab"), 1)) Resultados: falsos |
fn: valores distintos ((item, item, ...), agrupamento) | A única retornar valores diferentes. Exemplos: valores distintos ((1, 2, 3, 1, 2)) Resultados: (1, 2, 3) |
fn: inserir-antes ((item, item, ...), pos, pastilhas) | Devolve uma nova sequência construída pelo parâmetro produto - parâmetro especifica a localização da inserção insere o valor do parâmetro de POS. Exemplos: inserir-antes (( "ab", "cd"), 0, "gh") Resultados :( "gh", "ab", "cd") Exemplos: inserir-antes (( "ab", "cd"), 1, "gh") Resultados :( "gh", "ab", "cd") Exemplos: inserir-antes (( "ab", "cd"), 2, "gh") Resultados :( "ab", "gh", "cd") Exemplos: inserir-antes (( "ab", "cd"), 5, "gh") Resultados :( "ab", "cd", "gh") |
fn: inversa ((item, item, ...)) | Devoluções inverter a ordem dos itens especificados. Exemplos: reverse (( "ab", "cd", "ef")) Resultados :( "ef", "cd", "ab") Exemplos: inversa (( "AB")) Resultados :( "ab") |
fn: subsequência ((item, item, ...), começar, len) | Retorna o parâmetro inicial especifica a localização do projeto para retornar o comprimento da sequência, sequência especificada pelo parâmetro len. Localização do primeiro projeto é 1. Exemplos: subsequência (($ item1, item2 $, $ item3, ...), 3) Resultados: ($ item3, ...) Exemplos: subsequência (($ item1, item2 $, $ item3, ...), 2, 2) Resultados: ($ item2, $ item3) |
fn: não ordenada ((item, item, ...)) | De acordo com a ordem de execução de decisões para retornar para o projecto. |
função de sequência de teste de capacidade
nome | explicação |
---|---|
fn: Zero-ou-um (item, item, ...) | Se um parâmetro contém zero ou um item, em seguida, retornar parâmetros, caso contrário, será gerado um erro. |
fn: um-ou-mais (item, item, ...) | Se um parâmetro contém um ou mais itens, em seguida, retornar parâmetros, caso contrário, será gerado um erro. |
fn: exatamente-one (item, item, ...) | Se um parâmetro contém um item, em seguida, retornar parâmetros, caso contrário, será gerado um erro. |
É igual, União, interseção e Exceto
nome | explicação |
---|---|
fn: deep-igual (param1, param2, agrupamento) | Se param1 e param2 e iguais entre si (deep-iguais), retorna true, caso contrário, retorna false. |
função de agregação
nome | explicação |
---|---|
fn: count ((item, item, ...)) | Retorna o número de nós. |
fn: avg ((arg, arg, ...)) | Os valores médios dos parâmetros de retorno. Exemplos: avg ((1,2,3)) Resultado: 2 |
fn: max ((arg, arg, ...)) | Retorna o parâmetro é maior do que os outros parâmetros. Exemplos: max ((1,2,3)) Resultados: Exemplos 3: max (( 'a', 'k')) resulta: 'k' |
fn: min ((arg, arg, ...)) | Voltar menor do que os outros parâmetros dos parâmetros. Exemplos: min ((1,2,3)) Resultados: Exemplos 1: min (( 'a', 'k')) Resultados: 'a' |
fn: sum (arg, arg, ...) | Retorna o nó especificado definir o valor da soma de cada nó. |
função de geração de sequência
nome | explicação |
---|---|
fn: id ((string, string, ...), o nó) | Retorna uma seqüência de nós de elementos que têm um valor de ID igual ao valor de um ou mais dos valores especificados no argumento de cadeia |
fn: idref ((string, string, ...), o nó) | Retorna uma seqüência de elemento ou atributo nós que têm um valor IDREF igual ao valor de um ou mais dos valores especificados no argumento de cadeia |
fn: doc (URI) | |
fn: doc-disponível (URI) | Se a função doc () retorna o nó de documento, ele retorna true, caso contrário, retorna false. |
|
funções de contexto
nome | explicação |
---|---|
fn: position () | Ele retorna a posição de índice do nó que está sendo processado. Exemplos: // livro [position () <= 3] Resultados: Selecione os três primeiros elementos do livro |
fn: last () | Ele retorna o número de itens na lista de nós que está sendo processado. Exemplos: // livro [last ()] Resultados: Selecione o último elemento de um livro |
fn: current-dateTime () | Ele retorna a data e hora atual (com fuso horário). |
fn: current-date () | Retorna a data atual (com fuso horário). |
fn: current-time () | Ele retorna a hora atual (com fuso horário). |
fn: implícito-fuso horário () | valor de retorno de fuso horário implícito. |
fn: default-agrupamento () | Controle retorna para o valor padrão. |
fn: static-base-uri () | O valor de retorno da base-uri. |