Assistente da Expressão XPath - Opções de Referência de Funções

Ao criar uma expressão XPath, você pode utilizar as opções Referência de Funções para especificar o conjunto de nós, booleano, cadeia, número, XSLT e funções definidas pelo usuário. As funções são utilizadas para tornar o XPath ainda mais poderoso.

Algumas funções precisam de informações para trabalharem. Essas informações são transmitidas na forma de parâmetros, que são inseridos entre parênteses ( ).

Para acessar as opções Referência de Funções, clique na guia Referência no assistente de expressão XPath.

Funções do Conjunto de Nós

Você pode utilizar as seguintes funções para trabalhar com os conjuntos de nós.

Função Retorna
count( )  O número de nós em um conjunto de nós.
last( ) O tamanho da (ou seja, o número de nós em) lista de nós do contexto.
position A posição do nó em um conjunto de nós, na ordem do documento. Por exemplo, position( ) = 2 retorna o segundo elemento em um conjunto de nós.
id(cadeia Um conjunto de nós que contém todos os elementos no conjunto com a cadeia especificada.
local-name(node set ) O nome do primeiro nó no conjunto de nós. Sem um argumento, retorna o nome local do nó do contexto.
namespace uri( ) O URI do espaço de nomes do nó do contexto.
name( )  O nome do nó do contexto, incluindo o prefixo de espaço de nomes.

Funções Booleanas

Você pode utilizar estas funções para matemáticas Booleanas.

Função Retorna
boolean ( )  Avalia uma expressão como true ou false.
false ( ) Sempre retorna false
true ( ) Sempre retorna true
lang ( ) Retorna true ou false dependendo da linguagem do nó do contexto, conforme especificado pelos atributos xml:lang, ser a mesma ou ser uma sub-linguagem da linguagem especificada pela cadeia de argumento.
not ( ) Nega o valor da expressão Booleana: true se a expressão for falsa, do contrário, false.

Funções da Cadeia

Você pode utilizar as seguintes funções para trabalhar com as cadeias.

Funções Retorna
concat( ) A concatenação de seus argumentos. Por exemplo, concat ('This is', ' ', 'my string') retorna "This is my string"
contains( )  Uma indicação, se uma cadeia contiver o conteúdo de uma segunda cadeia. Por exemplo, contains ("This is my string", "is my") retorna true, porque a cadeia "This is my string" contém a cadeia "is my".
normalize-space( ) A cadeia de argumento com espaço em branco normalizado, retirando o espaço em branco inicial e final e substituindo as sequências de caracteres de espaço em branco por um único espaço.
starts-with( ) Uma indicação de que uma cadeia é iniciada com o conteúdo de uma segunda cadeia. Por exemplo, starts-with ("This is my string", "This") retorna true , porque a cadeia "This is my string" é iniciada com a cadeia "This" .
string( ) Converte qualquer valor em uma cadeia.
string-length( ) O número de caracteres na cadeia, incluindo espaços.
substring( ) Retira de uma cadeia o número especificado de caracteres. Por exemplo, substring ('This is my string' ,9, 2 ) retorna my porque fomos informados para iniciar no nono caractere e tomarmos dois caracteres.
substring-after( ) Todos os caracteres após um determinado caractere. Por exemplo, substring-after ('This is my string','s' ) retorna todos os caracteres após a primeira ocorrência da letra "s", em outras palavras "is my string".
substring-before( ) Todos os caracteres antes um determinado caractere. Por exemplo, substring-before ('This is my string','s' ) retorna todos os caracteres antes da primeira ocorrência da letra "s", em outras palavras "Thi".
translate (string, to-match, replace-with ) A cadeia string com todas as ocorrências da subcadeia to-match substituída pela cadeia replace-with .

Funções de Números

Você pode utilizar estas funções para tratar dos números.

Função Retorna
ceiling ( ) O valor da expressão arredondado para cima de um valor inteiro.
floor ( ) O valor da expressão arredondado para baixo de um valor inteiro.
round ( ) O valor da expressão arredondado para o inteiro mais próximo.
number ( ) Converte o texto PCDATA em um valor numérico.
sum ( ) Agrupa todos os valores numéricos em um conjunto de nós.

Funções XSLT

O XSLT utiliza a sintaxe XPath intensamente e suporta todas as funções definidas em XPath. Além disso, define dez funções extra.

Função Retorna
current( ) Um conjunto de nós que contém um único nó, o nó atual.
document( ) Concede acesso aos documentos XML que não sejam o documento de origem principal.
element-available( )  true se o argumento identificar um elemento XSLT que o processador reconheça; do contrário, false.
format-number (number x, string pattern ) Converte number x em uma cadeia que utiliza string pattern especificado pelo segundo argumento.
function-available( ) true se o argumento identificar uma função na biblioteca de funções do processador; do contrário, false.
generate-id( ) Uma cadeia que pode ser utilizada como um valor de um atributo de tipo de ID.
key (string keyName, object value ) Um conjunto de nós que contém todos os nós no documento de origem que possui uma chave com o nome fornecido pelo primeiro argumento e o valor fornecido pelo segundo argumento.
unparsed-entity-uri( ) O URI da entidade não analisada com o nome especificado declarado no DTD do documento de origem.
system-property( ) O valor da propriedade nomeada.

Definido pelo Usuário

Será listada aqui qualquer função definida pelo usuário que você possa utilizada na expressão XPath.


Feedback