Manual de referência XML

Manual de referência XML

Tipo do nó

A tabela a seguir lista os diferentes tipos de nós W3C e os elementos que eles podem ter:

Tipo do nó 描述 Elemento filho
Documento Representa o documento inteiro (nó raiz da árvore DOM)
  • Elemento (máximo um)
  • ProcessingInstruction
  • Comentário
  • DocumentType
DocumentFragment Representa um objeto Document leve, que contém parte do documento.
  • ProcessingInstruction
  • Comentário
  • Text
  • CDATASection
  • Referência de entidade
DocumentType Fornece uma interface para a entidade definida para o documento. Nenhum
ProcessingInstruction Representa a instrução de processamento. Nenhum
Referência de entidade Representa o elemento de referência de entidade.
  • ProcessingInstruction
  • Comentário
  • Text
  • CDATASection
  • Referência de entidade
Elemento Representa o elemento (elemento) element.
  • Text
  • Comentário
  • ProcessingInstruction
  • CDATASection
  • Referência de entidade
Attr Representa o atributo.
  • Text
  • Referência de entidade
Text Representa o conteúdo de texto de um elemento ou atributo. Nenhum
CDATASection Representa o segmento CDATA do documento (o texto não é analisado pelo analisador). Nenhum
Comentário Representa o comentário. Nenhum
Entidade Representa a entidade.
  • ProcessingInstruction
  • Comentário
  • Text
  • CDATASection
  • Referência de entidade
Notação Representa o símbolo declarado no DTD. Nenhum

Tipo do nó - valor retornado

A tabela a seguir lista os valores que as propriedades nodeName e nodeValue podem retornar para cada tipo de nó:

Tipo do nó Retorno do valor de nodeName Retorno do valor de nodeValue
Documento #documento null
DocumentFragment #fragmento de documento null
DocumentType Nome do doctype null
Referência de entidade Nome da referência de entidade null
Elemento Nome do elemento null
Attr Nome do atributo Valor do atributo
ProcessingInstruction target Conteúdo do nó
Comentário #comment Texto de comentário
Text #text Conteúdo do Nó
CDATASection #cdata-section Conteúdo do Nó
Entidade Nome da Entidade null
Notação Nome do Símbolo null

NodeTypes - Constantes Nomes

NodeType Constante Nomeada
1 ELEMENT_NODE
2 ATTRIBUTE_NODE
3 TEXT_NODE
4 CDATA_SECTION_NODE
5 ENTITY_REFERENCE_NODE
6 ENTITY_NODE
7 PROCESSING_INSTRUCTION_NODE
8 COMMENT_NODE
9 DOCUMENT_NODE
10 DOCUMENT_TYPE_NODE
11 DOCUMENT_FRAGMENT_NODE
12 NOTATION_NODE

Topo

Objeto Node do XML DOM

Atributos do objeto Node

Property 描述
attributes NamedNodeMap contendo os atributos deste nó (se este nó for um elemento).
baseURI Retorna o URI de base absoluto deste nó.
childNodes Retorna o NodeList de nós filhos do nó.
firstChild Retorna o primeiro nó filho do nó.
lastChild Retorna o último nó filho do nó.
nextSibling Retorna o nó同级 que segue o nó.
nodeName Retorne o nome do nó, dependendo do tipo.
nodeType Retorne o tipo do nó.
nodeValue Defina ou retorne o valor do nó, dependendo do tipo.
ownerDocument Retorna o elemento raiz do nó (objeto document).
parentNode Retorna o nó pai do nó.
prefix Definir ou retornar o prefixo de namespace do nó.
previousSibling Retorna o nó同级 que precede o nó.
textContent Definir ou retornar o conteúdo de texto do nó e seus descendentes.

Métodos do objeto Node

Método 描述
appendChild() Adiciona um novo nó filho ao final da lista de nós filhos do nó.
cloneNode() Clonar nó.
compareDocumentPosition() Comparar a posição de dois nós no DOM hierárquico (documento).
getFeature()feature,version) Retorna o objeto DOM que implementa a API específica para o recurso e a versão especificados.
getUserData()key)

Retorna o objeto associado à chave do nó.

Deve primeiro configurar o objeto neste nó, usando o mesmo chave para chamar setUserData.

hasAttributes() Retorna true se o nó especificado tiver qualquer atributo, caso contrário retorna false.
hasChildNodes() Retorna true se o nó especificado tiver nós filhos, caso contrário retorna false.
insertBefore() Insere um novo nó filho antes do nó filho especificado.
isDefaultNamespace(URI) Retorna se o URI de namespace especificado é o padrão.
isEqualNode() Verificar se dois nós são iguais.
isSameNode() Verifica se dois nós são o mesmo nó.
lookupNamespaceURI() Retorna o URI de namespace associado ao prefixo dado.
lookupPrefix() Retorna o prefixo associado ao URI de namespace dado.
normalize() Mesclar nós de texto adjacentes e excluir nós de texto vazios.
removeChild() Excluir (e retornar) o nó filho especificado do nó atual.
replaceChild() Substituir o nó filho por um novo nó.
setUserData(key,data,handler) Associar o objeto ao chave do nó.

Topo

Objeto NodeList do XML DOM

Atributos do objeto NodeList

Property 描述
length Retorna o número de nós na lista NodeList.

Métodos do objeto NodeList

Método 描述
item() Retorna o nó na posição especificada da lista de nós.

Topo

Objeto NamedNodeMap do XML DOM

Atributos do objeto NamedNodeMap

Property 描述
length Retorne o número de nós na lista.

Métodos do objeto NamedNodeMap

Método 描述
getNamedItem() Retorne o nó com nome específico.
getNamedItemNS() Retorne o nó com nome e espaço de nomes específicos.
item() Retorne o nó no índice específico.
removeNamedItem() Remova o nó com nome específico.
removeNamedItemNS() Remova o nó com nome e espaço de nomes específicos.
setNamedItem() Defina o nó específico (por nome).
setNamedItemNS() Defina o nó específico (por nome e espaço de nomes).

Topo

Objeto Document do XML DOM

Atributos do objeto Document

Property 描述
childNodes Retorne a NodeList de nós filhos do documento.
doctype Retorne a declaração de tipo de documento associada ao documento.
documentElement Retorne o nó raiz do documento.
documentURI Defina ou retorne a posição do documento.
domConfig Retorne a configuração usada ao chamar normalizeDocument().
firstChild Retorne o primeiro nó filho do documento.
implementation Retorne o objeto DOMImplementation que processa este documento.
inputEncoding Retorne o modo de codificação usado pelo documento (ao analisar).
lastChild Retorne o último nó filho do documento.
nodeName Retorne o nome do nó (dependendo do seu tipo).
nodeType Retorne o tipo de nó do nó.
nodeValue Defina ou retorne o valor do nó (dependendo do seu tipo).
xmlEncoding Retorne o modo de codificação XML do documento.
xmlStandalone Defina ou retorne se o documento é independente.
xmlVersion Defina ou retorne a versão XML do documento.

Métodos do objeto Document

Método 描述
adoptNode() Adote um nó de outro documento para este documento e retorne o nó adotado.
createAttribute() Crie um nó de atributo com nome especificado e retorne o novo objeto Attr.
createAttributeNS() Crie um nó de atributo com nome e espaço de nomes especificados e retorne o novo objeto Attr.
createCDATASection() Crie um nó de seção CDATA.
createComment() Crie um nó de comentário.
createDocumentFragment() Crie um objeto DocumentFragment vazio e retorne-o.
createElement() Cria um nó de elemento.
createElementNS() Cria um nó de elemento com o espaço de nomes especificado.
createEntityReference() Cria um objeto EntityReference e retorna este objeto.
createProcessingInstruction() Cria um objeto ProcessingInstruction e retorna este objeto.
createTextNode() Cria um nó de texto.
getElementById() Retorna o elemento que possui a propriedade id com o valor especificado.
getElementsByTagName() Retorna NodeList de todos os elementos que possuem o nome especificado.
getElementsByTagNameNS() Retorna NodeList de todos os elementos que possuem o nome e o espaço de nomes especificados.
importNode() Importa um nó de outro documento para este documento.
normalizeDocument()
renameNode() Renomeia o nó de elemento ou nó de atributo.

Propriedades do objeto DocumentType

Cada documento tem uma propriedade DOCTYPE, cujo valor é null ou um objeto DocumentType.

O objeto DocumentType fornece a interface para entidades definidas para o documento XML.

Property 描述
name Retorna o nome do DTD.
publicId Retorna o identificador público do DTD.
systemId Retorna o identificador de sistema do DTD externo.

Métodos do objeto DocumentImplementation

O objeto DOMImplementation executa operações específicas de instância independentes do modelo de objeto do documento.

Método 描述
createDocument() Cria um novo objeto DOM Document do tipo documento especificado.
createDocumentType() Cria um nó DocumentType vazio.
getFeature() Retorna o objeto API que implementa a característica e a versão especificada (se houver).
hasFeature() Verifica se a implementação DOM implementou características específicas e versões.

Propriedades do objeto ProcessingInstruction

O objeto ProcessingInstruction representa a instrução de processamento.

As instruções de processamento são usadas como método para manter informações específicas do processador no texto do documento XML.

Property 描述
data Define ou retorna o conteúdo da instrução de processamento.
target Retorna o alvo da instrução de processamento.

Topo

Objeto Element do XML DOM

Propriedades do objeto Element.

Property 描述
attributes Retorna o NamedNodeMap da propriedade do elemento.
baseURI Retorna o URI de referência absoluta do elemento.
childNodes Retorna NodeList que contém nós filhos do elemento.
firstChild Retorna o primeiro nó filho do elemento.
lastChild Retorna o último nó filho do elemento.
localName Retorna a parte local do nome do elemento.
namespaceURI Retorna o URI de espaço de nomes do elemento.
nextSibling Retorna o nó imediatamente após o elemento.
nodeName Retorna o nome do nó, dependendo do tipo.
nodeType Retorne o tipo do nó.
ownerDocument Retorna o elemento raiz (objeto documento).
parentNode Retorna o nó pai do elemento.
prefix Definir ou retornar o prefixo de espaço de nomes do elemento.
previousSibling Retorna o nó imediatamente antes do elemento.
schemaTypeInfo Retorna as informações de tipo associadas ao elemento.
tagName Retorna o nome do elemento.
textContent Definir ou retornar o conteúdo de texto do elemento e seus descendentes.

Métodos do objeto Elemento

Método 描述
appendChild() Adicionar novo nó filho ao final da lista de nós filhos do nó.
cloneNode() Clonar nó.
compareDocumentPosition() Comparar a posição do documento de dois nós.
getAttribute() Retorna o valor do atributo.
getAttributeNS() Retorna o valor do atributo (com espaço de nomes).
getAttributeNode() Retorna nó de atributo como objeto Attribute.
getAttributeNodeNS() Retorna nó de atributo (com espaço de nomes) como objeto Attribute.
getElementsByTagName() Retorna NodeList que contém nós de elementos que correspondem ao nó de elemento especificado e seus nós filhos.
getElementsByTagNameNS() Retorna NodeList que contém nós de elementos que correspondem ao nó de elemento especificado (com espaço de nomes) e seus nós filhos.
getFeature()feature,version) Retorna o objeto DOM que implementa a API específica para o recurso e a versão especificados.
getUserData()key) Retorna o objeto associado à chave no nó. Deve primeiro configurar o objeto neste nó, usando o mesmo chave para chamar setUserData.
hasAttribute() Retorna se o elemento possui um atributo que correspondente ao nome especificado.
hasAttributeNS() Retorna se o elemento possui um atributo que correspondente ao nome e ao espaço de nomes especificados.
hasAttributes() Retorna se o elemento possui atributos.
hasChildNodes() Retorna se o elemento tem nós filhos.
insertBefore() Inserir um novo nó filho antes do nó filho existente.
isDefaultNamespace(URI) Retorna se o specified namespaceURI é o padrão.
isEqualNode() Verificar se dois nós são iguais.
lookupNamespaceURI() Retorna o URI de namespace que coincide com o prefixo especificado.
lookupPrefix() Retorna o prefixo que coincide com o URI de namespace especificado.
normalize()

O método normalize() remove os nós de texto vazios e conecta os nós de texto adjacentes.

Normaliza todos os nós de texto sob o elemento (inclusive atributos), onde apenas a estrutura (por exemplo, elementos, comentários, instruções de processamento, partes CDATA e referências de entidade) separa os nós de texto.

Ou seja, não existem nós de texto adjacentes nem nós de texto vazios.

removeAttribute() Remover o atributo especificado.
removeAttributeNS() Remover o atributo especificado (com namespace).
removeAttributeNode() Remover o nó de atributo especificado.
removeChild() Remover nó filho.
replaceChild() Substituir o nó filho.
setUserData(key,data,handler) Associar o objeto com a chave no elemento.
setAttribute() Adiciona um novo atributo.
setAttributeNS() Adiciona um novo atributo (com namespace).
setAttributeNode() Adiciona um novo nó de atributo.
setAttributeNodeNS(attrnode) Adiciona um novo nó de atributo (com namespace).
setIdAttribute(name,isId) Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado como atributo ID determinado pelo usuário.
setIdAttributeNS(uri,name,isId) Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado (com namespace) como atributo ID determinado pelo usuário.
setIdAttributeNode(idAttr,isId) Se o atributo isId do objeto Attribute for true, este método declara o atributo especificado como atributo ID determinado pelo usuário.

Topo

Atributos do objeto Attr

Property 描述
baseURI Retorna o URI de base absoluto do atributo.
isId Se o atributo é do tipo id, retorna true, caso contrário, retorna false.
localName Retorna a parte local do nome do atributo.
name Retorna o nome do atributo.
namespaceURI Retorna o URI de namespace do atributo.
nodeName Retorne o nome do nó, dependendo do tipo.
nodeType Retorne o tipo do nó.
nodeValue Defina ou retorne o valor do nó, dependendo do tipo.
ownerDocument Retorne o elemento raiz (objeto documento) do atributo.
ownerElement Retorne o nó de elemento ao qual o atributo está anexado.
prefix Defina ou retorne o prefixo do espaço de nomes do atributo.
schemaTypeInfo Retorne as informações do tipo associadas ao atributo.
specified

Se o valor do atributo for configurado no documento, retorne true;

Se o valor do atributo for o valor padrão DTD/Schema, retorne false.

textContent Defina ou retorne o conteúdo de texto do atributo.
value Defina ou retorne o valor do atributo.

Topo

Objeto Text do XML DOM

Atributo do objeto Text

Property 描述
data Defina ou retorne o texto do elemento ou atributo.
isElementContentWhitespace Verifique se o nó de texto contém conteúdo de caracteres em branco.
length Retorne o comprimento do texto do elemento ou atributo.
wholeText Retorne todos os textos adjacentes ao nó, conectados em ordem de documento.

Métodos do objeto Text

Método 描述
appendData() Adicione dados ao nó.
deleteData() Exclua dados do nó.
insertData() Insira dados no nó.
replaceData() Substitui os dados do nó.
replaceWholeText(text) Substitua o texto do nó e de todos os nós de texto adjacentes com o texto especificado.
splitText() Divida um nó Text em dois.
substringData() Extrai dados do nó.

Topo

Objeto CDATASection do XML DOM

Atributos do objeto CDATASection

Property 描述
data Defina ou retorne o texto do nó.
length Retorne o comprimento da parte CDATA.

Métodos do objeto CDATASection

Método 描述
appendData() Adicione dados ao nó.
deleteData() Exclua dados do nó.
insertData() Insira dados no nó.
replaceData() Substitui os dados do nó.
splitText() Divida o nó CDATA em dois nós.
substringData() Extrai dados do nó.

Topo

Objeto Comment do XML DOM

Atributos do objeto Comment

Property 描述
data Defina ou retorne o texto do nó.
length Retorne o comprimento do texto do nó.

Métodos do objeto Comment

Método 描述
appendData() Adicione dados ao nó.
deleteData() Exclua dados do nó.
insertData() Insira dados no nó.
replaceData() Substitui os dados do nó.
substringData() Extrai dados do nó.

Topo

Objeto XMLHttpRequest do XML DOM

Métodos do objeto XMLHttpRequest

Método 描述
abort() Cancela a solicitação atual.
getAllResponseHeaders() Retorne as informações de cabeçalho.
getResponseHeader() Retorne o valor do cabeçalho HTTP especificado.
open(method,url,async,uname,pswd)

Especifique o tipo de solicitação, URL, se a solicitação deve ser processada de forma assíncrona e outras propriedades opcionais da solicitação.

  • method: Request type: GET or POST
  • url: The location of the file on the server
  • async: true (asynchronous) or false (synchronous)
send(string)

Send the request to the server.

string: Only used for POST requests

setRequestHeader() Add a label/value pair to the headers to be sent.

XMLHttpRequest object properties

Property 描述
onreadystatechange Store the function (or function name) that is automatically called when the readyState attribute changes.
readyState

Save the state of XMLHttpRequest. Changes from 0 to 4:

  • 0: Request not initialized
  • 1: Server connection established
  • 2: Request received
  • 3: Request in progress
  • 4: Request completed, response ready
responseText Return response data as a string.
responseXML Return response data as XML data.
status Return status code (for example, "404" for "Not Found", or "200" for "OK").
statusText Return status text (for example, "Not Found" or "OK").

Topo

XSD elements

elemento XSLT Explain
all Specify that child elements can appear in any order, and each child element can appear zero or once.
annotation The annotation element is a top-level element that specifies schema annotations.
any Allow creators to extend XML documents by using elements not specified by the schema.
anyAttribute Allow creators to extend XML documents by using attributes not specified by the schema.
appInfo Specify the information that the application should use in the annotation element.
Aplicar um template ao elemento atual ou a seus subelementos. Define an attribute.
attributeGroup Define an attribute group used in the complex type definition.
choice Allow only one element to appear within the containing elements in a <choice> declaration.
complexContent Define extensions or restrictions on complex types (including mixed content or elements only).
complexType Define complex types.
documentation Define text annotations in the schema.
element Define an element.
extension Expand existing simpleType or complexType elements.
field Specify an XPath expression that defines the value used to define the identification constraint.
group Define the element group used in the definition of complex types.
import Add multiple schemas with different target namespaces to a document.
include Add multiple schemas with the same target namespace to a document.
key Specify that the value of an attribute or element (or a set of values) must be a key within a specified range.
keyref Specify that the value of an attribute or element (or a set of values) corresponds to the value of a specified key or unique element.
list Define a simple type as a list of values of a specified data type.
notation Describe the format of non-XML data in an XML document.
redefine Redefine simple and complex types, groups, and attribute groups obtained from an external schema file.
restriction Define constraints on simpleType, simpleContent, or complexContent.
schema Define the root element of the schema.
selector Specify an XPath expression that selects a set of elements for the identification constraint.
sequence The child elements must appear in order. Each child element can appear 0 to any number of times.
simpleContent Contains extensions or restrictions of the complexType element and does not contain any elements.
simpleType Define a simple type, specifying constraints and information about the values of attributes or elements that contain only text.
union Define a collection defined by multiple simpleType definitions.
unique Specify that the value of an attribute or element (or a combination of attribute or element values) must be unique within a specified range.

XSD constraints for data types

See XSD constraints / Facets

Limit 描述
enumeration Define a list of acceptable values
fractionDigits Define the maximum number of decimal places allowed. It must be greater than or equal to 0.
length Define the exact number of allowed characters or list items. It must be greater than or equal to 0.
maxExclusive Define the upper limit of a number. The allowed values must be less than this value.
maxInclusive Define the upper limit of a number. The allowed values must be less than or equal to this value.
maxLength Define the maximum number of allowed characters or list items. It must be greater than or equal to 0.
minExclusive Define the lower limit of a number. The allowed values must be greater than this value.
minInclusive Define the lower limit of a number. The allowed values must be greater than or equal to this value.
minLength Definir o número mínimo de caracteres permitidos ou itens da lista. Deve ser maior ou igual a 0.
Definir o número mínimo de caracteres permitidos ou itens da lista. Deve ser maior ou igual a 0. pattern
Definir a sequência exata de caracteres aceitáveis. totalDigits
Definir o número exato de dígitos de números árabes permitidos. Deve ser maior que 0. whiteSpace

Topo

Definir o tratamento de caracteres de espaço em branco (quebras de linha, enter, espaços e tabulações).

elemento XSLT 描述
element apply-imports
Aplicar regras de template vindas de uma folha de estilo importada. apply-templates
Aplicar um template ao elemento atual ou a seus subelementos. Adicionar atributos ao elemento.
attribute-set Criar um conjunto de atributos nomeados.
call-template Chamar um template específico.
choose Usado em conjunto com <when> e <otherwise> para expressar testes de condições múltiplas.
comment Criar um nó de comentário no árvore de resultados.
copy Criar uma cópia do nó atual (sem subnós e atributos).
copy-of Criar uma cópia do nó atual (com subnós e atributos).
decimal-format Definir os caracteres e símbolos a serem usados ao converter números em strings usando a função format-number().
element Criar um nó de elemento no documento de saída.
fallback Se o processador não suportar um elemento XSLT, especificar um código alternativo para executar.
for-each Iterar sobre cada nó em um conjunto de nós especificado.
if Incluir um template, aplicando-o apenas se uma condição específica for verdadeira.
import Usado para injetar o conteúdo de uma folha de estilo em outra folha de estilo.
include Incluir o conteúdo de uma folha de estilo em outra folha de estilo.
key Declarar uma chave nomeada.
message Escrever uma mensagem na saída (usada para relatórios de erro).
namespace-alias Substituir o espaço de nomes do estilo de folha de estilo por um espaço de nomes diferente na saída.
number Determinar a posição inteira do nó atual e formatar o número.
otherwise Especificar a ação padrão do elemento <choose>.
output Definir o formato do documento de saída.
param Declarar um parâmetro local ou global.
preserve-space Usado para definir elementos que devem preservar espaços em branco.
processing-instruction Gerar um nó de instrução de processamento.
sort Ordenar os resultados.
strip-space Definir o elemento que deve remover caracteres de espaço em branco.
stylesheet define o elemento raiz do estilo.
template regras aplicadas quando o nó especificado é correspondido.
text gera nós de texto através do estilo.
transform define o elemento raiz do estilo.
value-of extrai o valor do nó selecionado.
variable declara variáveis locais ou globais.
when especifica a ação do elemento <choose>.
with-param especifica o valor do parâmetro a ser传入某个模板.

Topo

Funções de XSLT, XPath e XQuery no CodeW3C.com

funções de acesso

名称 Description
fn:node-name(node) retorna o nome do nó do parâmetro.
fn:nilled(node) retorna um valor booleano indicando se o nó do parâmetro foi recusado.
fn:data(item.item,...) aceita uma sequência de itens e retorna uma sequência de valores atômicos.
  • fn:base-uri()
  • fn:base-uri(node)
retorna o valor da propriedade base-uri do nó atual ou do nó especificado.
fn:document-uri(node) retorna o valor da propriedade document-uri do nó especificado.

funções de erro e rastreamento

名称 Description
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

exemplo: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Erro: Preço é muito alto')

resultado: retorna ao ambiente de processamento externo http://example.com/test#toohigh e a string "Erro: Preço é muito alto".

fn:trace(value,label) usado para debugar consultas.

funções numéricas

名称 Description
fn:number(arg)

retorna o valor numérico do parâmetro. O parâmetro pode ser um valor booleano, uma string ou um conjunto de nós.

exemplo: number('100')

resultado: 100

fn:abs(num)

retorna o valor absoluto do parâmetro.

exemplo: abs(3.14)

resultado: 3.14

exemplo: abs(-3.14)

resultado: 3.14

fn:teto(num)

retorna o menor inteiro maior que o parâmetro num.

exemplo: teto(3.14)

Resultado: 4

fn:floor(num)

Retorna o maior inteiro não superior ao parâmetro num.

Exemplo: floor(3.14)

Result: 3

fn:round(num)

Arredonda o parâmetro num para o inteiro mais próximo.

Exemplo: round(3.14)

Result: 3

fn:round-half-to-even()

Exemplo: round-half-to-even(0.5)

Resultado: 0

Exemplo: round-half-to-even(1.5)

Result: 2

Exemplo: round-half-to-even(2.5)

Result: 2

Funções de string

名称 Description
fn:string(arg)

Retorna o valor de string do argumento. O argumento pode ser um número, um valor lógico ou um conjunto de nós.

Exemplo: string(314)

Resultado: "314"

fn:codepoints-to-string(int,int,...)

Retorna uma string de uma sequência de código-pontos.

Exemplo: codepoints-to-string(84, 104, 233, 114, 232, 115, 101)

Resultado: 'Thérèse'

fn:string-to-codepoints(string)

Retorna uma sequência de código-pontos de uma string.

Exemplo: string-to-codepoints("Thérèse")

Resultado: 84, 104, 233, 114, 232, 115, 101

fn:codepoint-equal(comp1,comp2) De acordo com a comparação de código-ponto Unicode, se o valor de comp1 for igual ao valor de comp2, retorna true. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), caso contrário, retorna false.
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

Se comp1 for menor que comp2, retorna -1. Se comp1 for igual a comp2, retorna 0. Se comp1 for maior que comp2, retorna 1. (De acordo com as regras de comparação utilizadas).

Exemplo: compare('ghi', 'ghi')

Resultado: 0

fn:concat(string,string,...)

Retorna a concatenação de strings.

Exemplo: concat('XPath ','é ','DIVERTIDO!')

Resultado: 'XPath é DIVERTIDO!'

fn:join(string,string,...,sep)

Usa o parâmetro sep como separador para retornar a string concatenada dos parâmetros string.

Exemplo: string-join(('We', 'are', 'having', 'fun!'), ' ')

O resultado: ' We are having fun! '

Exemplo: string-join(('We', 'are', 'having', 'fun!'))

O resultado: 'Wearehavingfun!'

Exemplo: string-join((), 'sep')

O resultado: ''

  • fn:substring(string,start,len)
  • fn:substring(string,start)

Retorna a substring de comprimento especificado a partir da posição start. O índice do primeiro caractere é 1. Se o parâmetro len for omitido, retorna a substring da posição start até o final da string.

Exemplo: substring('Beatles',1,4)

O resultado: 'Beat'

Exemplo: substring('Beatles',2)

O resultado: 'eatles'

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

Retorna o comprimento da string especificada. Se não houver parâmetro string, retorna o comprimento do valor de string do nó atual.

Exemplo: string-length('Beatles')

O resultado: 7

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

Remove os espaços em branco no início e no final da string especificada, substitui todas as sequências de espaços internos por um único espaço e retorna o resultado. Se não houver parâmetro string, processa o nó atual.

Exemplo: normalize-space(' The   XML ')

O resultado: 'The XML'

fn:normalize-unicode() Executa a normalização Unicode.
fn:upper-case(string)

Converte o parâmetro string em maiúsculas.

Exemplo: upper-case('The XML')

O resultado: 'THE XML'

fn:lower-case(string)

Converte o parâmetro string em minúsculas.

Exemplo: lower-case('The XML')

O resultado: 'the xml'

fn:translate(string1,string2,string3)

Substitui string2 por string3 dentro de string1.

Exemplo: translate('12:30','30','45')

Resultado: '12:45'

Exemplo: translate('12:30','03','54')

Resultado: '12:45'

Exemplo: translate('12:30','0123','abcd')

Resultado: 'bc:da'

fn:escape-uri(stringURI,esc-res)

Exemplo: escape-uri("http://example.com/test#car", true())

Resultado: "http%3A%2F%2Fexample.com%2Ftest#car"

Exemplo: escape-uri("http://example.com/test#car", false())

Resultado: "http://example.com/test#car"

Exemplo: escape-uri ("http://example.com/~bébé", false())

Resultado: "http://example.com/~b%C3%A9b%C3%A9"

fn:contains(string1,string2)

Se string1 contiver string2, retorna true, caso contrário, retorna false.

Exemplo: contains('XML','XM')

Resultados: true

fn:starts-with(string1,string2)

Se string1 começar com string2, retorna true, caso contrário, retorna false.

Exemplo: starts-with('XML','X')

Resultados: true

fn:ends-with(string1,string2)

Se string1 terminar com string2, retorna true, caso contrário, retorna false.

Exemplo: ends-with('XML','X')

resultado: false

fn:substring-before(string1,string2)

Retorna a substring que está antes da ocorrência de string2 dentro de string1.

Exemplo: substring-before('12/10','/')

Resultado: '12'

fn:substring-after(string1,string2)

Retorna a substring que está após a ocorrência de string2 dentro de string1.

Exemplo: substring-after('12/10','/')

Resultados: '10'

fn:matches(string,pattern)

Se o parâmetro string coincidir com o padrão especificado, retorna true, caso contrário, retorna false.

Exemplo: matches("Merano", "ran")

Resultados: true

fn:replace(string,pattern,replace)

Substitui o padrão especificado pelo parâmetro replace e retorna o resultado.

Exemplo: replace("Bella Italia", "l", "*")

Resultados: 'Be**a Ita*ia'

Exemplo: replace("Bella Italia", "l", "")

Resultados: 'Bea Itaia'

fn:tokenize(string,pattern)

Exemplo: tokenize("XPath is fun", "\s+")

Resultados: ("XPath", "is", "fun")

Funções para anyURI

名称 Description
fn:resolve-uri(relative,base)  

Funções sobre valores booleanos

名称 Description
fn:boolean(arg) Retorna o valor booleano de um número, uma string ou um conjunto de nós.
fn:not(arg)

Primeiro, restaura o parâmetro a um valor booleano usando a função boolean().

Se o valor booleano for false, retorna true, caso contrário, retorna true.

Exemplo: not(true())

resultado: false

fn:true()

Retorna o valor booleano true.

Exemplo: true()

Resultados: true

fn:false()

Retorna o valor booleano false.

Exemplo: false()

resultado: false

Funções sobre duração, data e hora

Função de extração de componentes de data, hora e duração

名称 Description
fn:dateTime(date,time) Converte o parâmetro em data e hora.
fn:years-from-duration(datetimedur) Retorna o valor inteiro do ano do parâmetro, representado em termos padronizados.
fn:months-from-duration(datetimedur) Retorna o valor inteiro do mês do parâmetro, representado em termos padronizados.
fn:days-from-duration(datetimedur) Retorna o valor inteiro do dia do parâmetro, representado em termos padronizados.
fn:hours-from-duration(datetimedur) Retorna o valor inteiro da parte de horas do valor, representado em notação lexical padrão.
fn:minutes-from-duration(datetimedur) Retorna o valor inteiro da parte de minutos do valor, representado em notação lexical padrão.
fn:seconds-from-duration(datetimedur) Retorna o valor decimal da parte de minutos do valor, representado em notação lexical padrão.
fn:year-from-dateTime(datetime)

Retorna o valor inteiro da parte de anos do valor local do parâmetro.

Exemplo: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 2005

fn:month-from-dateTime(datetime)

Retorna o valor inteiro da parte de meses do valor local do parâmetro.

Exemplo: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 01

fn:day-from-dateTime(datetime)

Retorna o valor inteiro da parte de dias do valor local do parâmetro.

Exemplo: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 10

fn:hours-from-dateTime(datetime)

Retorna o valor inteiro da parte de horas do valor local do parâmetro.

Exemplo: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 12

fn:minutes-from-dateTime(datetime)

Retorna o valor inteiro da parte de minutos do valor local do parâmetro.

Exemplo: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10"))

Resultado: 30

fn:seconds-from-dateTime(datetime)

Retorna o valor decimal da parte de segundos do valor local do parâmetro.

Exemplo: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10"))

Resultado: 0

fn:timezone-from-dateTime(datetime) Retorna a parte de fuso horário do parâmetro, se existir.
fn:year-from-date(date)

Retorna o valor local do parâmetro como inteiro representando o ano.

Exemplo: year-from-date(xs:date("2005-04-23"))

Resultado: 2005

fn:month-from-date(date)

Retorna o inteiro que representa o mês no valor local do parâmetro.

Exemplo: month-from-date(xs:date("2005-04-23"))

Resultado: 4

fn:day-from-date(date)

Retorna o inteiro que representa o dia no valor local do parâmetro.

Exemplo: day-from-date(xs:date("2005-04-23"))

Resultado: 23

fn:timezone-from-date(date) Retorna a parte de fuso horário do parâmetro, se existir.
fn:hours-from-time(time)

Retorna o inteiro que representa a parte de horas no valor local do parâmetro.

Exemplo: hours-from-time(xs:time("10:22:00"))

Resultado: 10

fn:minutes-from-time(time)

Retorna o inteiro que representa a parte de minutos no valor local do parâmetro.

Exemplo: minutes-from-time(xs:time("10:22:00"))

Resultado: 22

fn:seconds-from-time(time)

Retorna o inteiro que representa a parte de segundos no valor local do parâmetro.

Exemplo: seconds-from-time(xs:time("10:22:00"))

Resultado: 0

fn:timezone-from-time(time) Retorna a parte de fuso horário do parâmetro, se existir.
fn:adjust-dateTime-to-timezone(datetime,timezone)

Se o parâmetro timezone estiver vazio, retorna a dateTime sem fuso horário.

Caso contrário, retorna a dateTime com fuso horário.

fn:adjust-date-to-timezone(date,timezone)

Se o parâmetro timezone estiver vazio, retorna a data sem fuso horário.

Caso contrário, retorna a data com fuso horário.

fn:adjust-time-to-timezone(time,timezone)

Se o parâmetro timezone estiver vazio, retorna a data sem fuso horário.

Caso contrário, retorna a data com fuso horário.

Funções relacionadas a QNames

名称 Description
fn:QName()  
fn:local-name-from-QName()  
fn:namespace-uri-from-QName()  
fn:namespace-uri-for-prefix()  
fn:in-scope-prefixes()  
fn:resolve-QName()  

Funções de nó

名称 Description
  • fn:name()
  • fn:name(nodeset)
Retorna o nome do nó atual ou do primeiro nó do conjunto de nós especificado.
  • fn:local-name()
  • fn:local-name(nodeset)
Retorna o nome do nó atual ou do primeiro nó do conjunto de nós especificado - sem prefixo de espaço de nomes.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
Retorna o URI do espaço de nomes do nó atual ou do primeiro nó do conjunto de nós especificado.
fn:lang(lang)

Se o idioma do nó atual coincidir com o idioma especificado, retorna true.

Exemplo: Lang("en") é verdadeiro para <p xml:lang="en">...</p>

Exemplo: Lang("de") é falso para <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
Retorna o nó raiz da árvore de nós do nó atual ou do nó especificado. Geralmente é o nó de documento.

Funções de sequência

Função geral

名称 Description
fn:index-of((item,item,...),searchitem)

Retorna a posição dos itens na sequência de itens igual ao parâmetro searchitem.

Exemplo: index-of ((15, 40, 25, 40, 10), 40)

Resultado: (2, 4)

Exemplo: index-of (("a", "dog", "and", "a", "duck"), "a")

Resultado (1, 4)

Exemplo: index-of ((15, 40, 25, 40, 10), 18)

Resultado: ()

fn:remove((item,item,...),position)

Retorna uma nova sequência construída pelo parâmetro item, enquanto remove o item especificado pela posição.

Exemplo: remove(("ab", "cd", "ef"), 0)

Resultado: ("ab", "cd", "ef")

Exemplo: remove(("ab", "cd", "ef"), 1)

Resultado: ("cd", "ef")

Exemplo: remove(("ab", "cd", "ef"), 4)

Resultado: ("ab", "cd", "ef")

fn:empty(item,item,...)

Se o valor do parâmetro for uma sequência vazia, retorna true, caso contrário, retorna false.

Exemplo: empty(remove(("ab", "cd"), 1))

resultado: false

fn:exists(item,item,...)

se o valor do parâmetro não for uma sequência vazia, retorna true, caso contrário, retorna false.

exemplo: exists(remove(("ab"), 1))

resultado: false

fn:distinct-values((item,item,...),collation)

retorna valores únicos diferentes.

exemplo: distinct-values((1, 2, 3, 1, 2))

resultado: (1, 2, 3)

fn:insert-before((item,item,...),pos,inserts)

retorna uma nova sequência construída pelo parâmetro item, inserindo o valor do parâmetro inserts na posição especificada pelo parâmetro pos.

exemplo: insert-before(("ab", "cd"), 0, "gh")

resultado: ("gh", "ab", "cd")

exemplo: insert-before(("ab", "cd"), 1, "gh")

resultado: ("gh", "ab", "cd")

exemplo: insert-before(("ab", "cd"), 2, "gh")

resultado: ("ab", "gh", "cd")

exemplo: insert-before(("ab", "cd"), 5, "gh")

resultado: ("ab", "cd", "gh")

fn:reverse((item,item,...))

retorna a ordem inversa dos itens especificados.

exemplo: reverse(("ab", "cd", "ef"))

resultado: ("ef", "cd", "ab")

exemplo: reverse(("ab"))

resultado: ("ab")

fn:subsequence((item,item,...),start,len)

retorna a sequência de itens especificada pelo parâmetro start, com comprimento especificado pelo parâmetro len.

a posição do primeiro item é 1.

exemplo: subsequence(($item1, $item2, $item3,...), 3)

resultado: ($item3, ...)

exemplo: subsequence(($item1, $item2, $item3, ...), 2, 2)

resultado: ($item2, $item3)

fn:unordered((item,item,...)) retorna os itens com a ordem determinada pela implementação.

função de teste de capacidade de sequência

名称 Description
fn:zero-or-one(item,item,...) If the parameter contains zero or one item, returns the parameter, otherwise generates an error.
fn:one-or-more(item,item,...) If the parameter contains one or more items, returns the parameter, otherwise generates an error.
fn:exactly-one(item,item,...) If the parameter contains an item, returns the parameter, otherwise generates an error.

Equals, Union, Intersection and Except

名称 Description
fn:deep-equal(param1,param2,collation) Returns true if param1 and param2 are equal to each other (deep-equal), otherwise returns false.

Aggregate functions

名称 Description
fn:count((item,item,...)) Returns the number of nodes.
fn:avg((arg,arg,...))

Returns the average value of the parameter values.

Example: avg((1,2,3))

Result: 2

fn:max((arg,arg,...))

Returns the parameter that is greater than the other parameters.

Example: max((1,2,3))

Result: 3

Example: max(('a', 'k'))

Result: 'k'

fn:min((arg,arg,...))

Returns the parameter that is less than the other parameters.

Example: min((1,2,3))

Result: 1

Example: min(('a', 'k'))

Result: 'a'

fn:sum(arg,arg,...) Returns the sum of the numerical values of each node in the specified node set.

Functions to generate sequences

名称 Description
fn:id((string,string,...),node) Returns a sequence of element nodes whose ID values equal one or more values specified in the string parameter.
fn:idref((string,string,...),node) Returns a sequence of element or attribute nodes whose IDREF values equal one or more values specified in the string parameter.
fn:doc(URI)  
fn:doc-available(URI) Returns true if the doc() function returns a document node, otherwise returns false.
  • fn:collection()
  • fn:collection(string)
 

Context functions

名称 Description
fn:position()

Returns the index position of the current node being processed.

Example: //book[position()<=3]

Result: Select the first three book elements

fn:last()

返回在被处理的节点列表中的项目数目。

例子://book[last()]

结果:选择最后一个 book 元素

fn:current-dateTime() 返回当前的 dateTime(带有时区)。
fn:current-date() 返回当前的日期(带有时区)。
fn:current-time() 返回当前的时间(带有时区)。
fn:implicit-timezone() 返回隐式时区的值。
fn:default-collation() 返回默认对照的值。
fn:static-base-uri() 返回 base-uri 的值。

XSLT 函数

此外,还有以下内置的 XSLT 函数:

名称 描述
current() 返回当前节点作为唯一成员的节点集。
document() 用于访问外部 XML 文档中的节点。
element-available() 检测 XSLT 处理器是否支持指定的元素。
format-number() 把数字转换为字符串。
function-available() 检测 XSLT 处理器是否支持指定的函数。
generate-id() 返回唯一标识指定节点的字符串值。
key() 检索以前使用 <xsl:key> 语句标记的元素。
node-set 将树转换为节点集。产生的节点集总是包含单个节点并且是树的根节点。
system-property() 返回系统属性的值。
unparsed-entity-uri() 返回未解析实体的 URI。

Topo

其他 XML DOM 对象

Topo