Latest web development tutorials

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

nota A função de prefixo namespace padrão para fn:

nota 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.
  • fn: base-uri ()
  • fn: base-uri (nó)
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
  • fn: erro ()
  • fn: erro (erro)
  • fn: erro (o erro, descrição)
  • fn: erro (o erro, descrição, erro de objeto)

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.
  • fn: compare (comp1, comp2)
  • fn: compare (comp1, comp2, agrupamento)

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: ''

  • fn: substring (seq_caracte, início, len)
  • fn: substring (seq_caracte, início)

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'

  • fn: string-length (string)
  • fn: string-length ()

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

  • fn: normalize-space (string)
  • fn: normalize-space ()

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
  • fn: nome ()
  • fn: nome (nodeset)
Retorna o nome do nó atual ou especificar o primeiro nó do cluster.
  • fn: local,-name ()
  • fn: local,-name (nodeset)
Retorna o primeiro do nome do nó atual ou especificar um nó no cluster - sem prefixo de namespace.
  • fn: namespace-uri ()
  • fn: namespace-uri (nodeset)
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>

  • fn: root ()
  • fn: root (nó)
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.
  • fn: coleção ()
  • fn: coleção (string)

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.