XML referenshandbok

XML referenshandbok

Nodtyp

Nedanstående tabell visar olika W3C-nodtyper och de underkomponenter de kan ha:

Nodtyp 描述 Underkomponenter
Document Repräsenterar hela dokumentet (rotnoden i DOM-trädet)
  • Element (max. ett)
  • ProcessingInstruction
  • Kommentar
  • DocumentType
DocumentFragment Repräsenterar en lättviktig Document-objekt som innehåller en del av dokumentet.
  • ProcessingInstruction
  • Kommentar
  • Text
  • CDATASection
  • EntityReference
DocumentType Ger gränssnitt för entiteter som definieras för dokumentet. Inget
ProcessingInstruction Repräsenterar instruktioner. Inget
EntityReference Repräsenterar entityreference-element.
  • ProcessingInstruction
  • Kommentar
  • Text
  • CDATASection
  • EntityReference
Element Repräsenterar element (element) element
  • Text
  • Kommentar
  • ProcessingInstruction
  • CDATASection
  • EntityReference
Attr Repräsenterar egenskaper.
  • Text
  • EntityReference
Text Repräsenterar textinnehållet i element eller egenskaper. Inget
CDATASection Repräsenterar CDATA-sektioner i dokumentet (texten kommer inte att analyseras av analyseraren) Inget
Kommentar Repräsenterar kommentarer. Inget
Entity Repräsenterar entiteter.
  • ProcessingInstruction
  • Kommentar
  • Text
  • CDATASection
  • EntityReference
Notation Repräsenterar symboler som deklarerade i DTD. Inget

Nodtyp - Returnerade värden

Nedanstående tabell visar de värden som nodeName och nodeValue-attributen kan returnera för varje nodtyp:

Nodtyp nodeName returnvärdet nodeValue returnvärdet
Document #document null
DocumentFragment #document fragment null
DocumentType doctype namn null
EntityReference EntityReference namn null
Element element namn null
Attr Egenskapsnamn Egenskapsvärde
ProcessingInstruction target Innehållet i noden
Kommentar #comment Kommentar text
Text #text Node Content
CDATASection #cdata-section Node Content
Entity Entity Name null
Notation Symbol Name null

NodeTypes - Named Constants

NodeType Named Constant
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

Toppen

XML DOM Node-objekt

Properties of Node object

Egenskap 描述
attributes NamedNodeMap containing the attributes of this node (if this node is an element).
baseURI Return the absolute base URI of the node.
childNodes Return the NodeList of child nodes of the node.
firstChild Return the first child node of the node.
lastChild Return the last child node of the node.
nextSibling Return the same-level node immediately following the node.
nodeName Returnera namnet på noden, beroende på dess typ.
nodeType Returnera nodtypen.
nodeValue Sätt eller returnera värdet för noden, beroende på dess typ.
ownerDocument Return the root element of the node (document object).
parentNode Return the parent node of the node.
prefix Set or return the namespace prefix of the node.
previousSibling Return the same-level node immediately preceding the node.
textContent Set or return the text content of the node and its descendants.

Methods of Node object

Metod 描述
appendChild() Append a new child node to the end of the node's child node list.
cloneNode() 克隆节点。
compareDocumentPosition() Compare the position of two nodes in the DOM hierarchy (document).
getFeature(feature,version) 返回 DOM 对象,该对象实现指定特性和版本的专用 API。
getUserData(key)

Return the object associated with the key on the node.

The object must be set to this node first, by calling setUserData with the same key.

hasAttributes() Return true if the specified node has any attributes, otherwise return false.
hasChildNodes() Return true if the specified node has child nodes, otherwise return false.
insertBefore() Insert a new child node before the specified child node.
isDefaultNamespace(URI) Return whether the specified namespace URI is the default.
isEqualNode() Check if two nodes are equal.
isSameNode() Check if two nodes are the same node.
lookupNamespaceURI() Return the namespace URI associated with the given prefix.
lookupPrefix() Return the prefix associated with the given namespace URI.
normalize() Merge adjacent text nodes and delete empty text nodes.
removeChild() Delete (and return) the specified child node of the current node.
replaceChild() Replace the child node with a new node.
setUserData(key,data,handler) Associate the object with the key on the node.

Toppen

XML DOM NodeList-objekt

Properties of NodeList object

Egenskap 描述
length Return the number of nodes in the NodeList.

Methods of NodeList object

Metod 描述
item() Return the node at the specified index in the NodeList.

Toppen

XML DOM NamedNodeMap-objekt

Egenskaper för NamedNodeMap-objektet

Egenskap 描述
length Returnera antalet noder i listan.

Metoder för NamedNodeMap-objektet

Metod 描述
getNamedItem() Returnera knudelementet med specifikt namn.
getNamedItemNS() Returnera knudelementet med specifikt namn och namnrymd.
item() Returnera knudelementet vid specifik index.
removeNamedItem() Ta bort knudelementet med specifikt namn.
removeNamedItemNS() Ta bort knudelementet med specifikt namn och namnrymd.
setNamedItem() Sätt det specificerade knudelementet (enligt namn).
setNamedItemNS() Sätt det specificerade knudelementet (enligt namn och namnrymd).

Toppen

XML DOM Document-objekt

Egenskaper för Document-objektet

Egenskap 描述
childNodes Returnera NodeList av dokumentets underknudelement.
doctype Returnera dokumenttypsdeklarationen som är associerad med dokumentet.
documentElement Returnera dokumentets rotknudelement.
documentURI Sätt eller returnera dokumentets position.
domConfig Returnera konfigurationen som användes vid anropet normalizeDocument().
firstChild Returnera dokumentets första undernod.
implementation Returnera DOMImplementation-objektet som hanterar detta dokument.
inputEncoding Returnera kodningen som dokumentet använder (vid tolkning).
lastChild Returnera dokumentets sista undernod.
nodeName Returnera knudelementets namn (beroende på dess typ).
nodeType Returnera knudelementets nodtyp.
nodeValue Sätt eller returnera värdet för knudelementet (beroende på dess typ).
xmlEncoding Returnera XML-kodningen för dokumentet.
xmlStandalone Sätt eller returnera om dokumentet är självständigt.
xmlVersion Sätt eller returnera XML-versionen för dokumentet.

Metoder för Document-objektet

Metod 描述
adoptNode() Anta ett knudelement från ett annat dokument till detta dokument och returnera det antagna knudelementet.
createAttribute() Skapa en egenskapsnde med specificerat namn, och returnera det nya Attr-objektet.
createAttributeNS() Skapa en egenskapsnde med specificerat namn och namnrymd, och returnera det nya Attr-objektet.
createCDATASection() Skapa en CDATA-sektionnde.
createComment() Skapa en kommentarnde.
createDocumentFragment() Skapa ett tomt DocumentFragment-objekt och returnera det.
createElement() Create an element node.
createElementNS() Create an element node with the specified namespace.
createEntityReference() Create an EntityReference object and return this object.
createProcessingInstruction() Create a ProcessingInstruction object and return this object.
createTextNode() Create a text node.
getElementById() Return the element with the id attribute having the given value.
getElementsByTagName() Return a NodeList of all elements with the specified name.
getElementsByTagNameNS() Return a NodeList of all elements with the specified name and namespace.
importNode() Import a node from another document to this document.
normalizeDocument()
renameNode() Rename an element node or an attribute node.

Properties of the DocumentType object

Each document has a DOCTYPE attribute whose value is null or a DocumentType object.

The DocumentType object provides the interface for the entities defined for the XML document.

Egenskap 描述
name Return the name of the DTD.
publicId Return the public identifier of the DTD.
systemId Return the system identifier of the external DTD.

Methods of the DocumentImplementation object

The DOMImplementation object performs operations that are independent of any specific instance of the Document Object Model.

Metod 描述
createDocument() Create a new DOM Document object of the specified document type.
createDocumentType() Create an empty DocumentType node.
getFeature() Return the object of the API that implements the specified feature and version (if any).
hasFeature() Check if the DOM implementation has implemented a specific feature and version.

Properties of the ProcessingInstruction object

The ProcessingInstruction object represents a processing instruction.

Processing instructions are used as a method to retain processor-specific information in the XML document text.

Egenskap 描述
data Set or return the content of the processing instruction.
target Return the target of the processing instruction.

Toppen

XML DOM Element-objekt

Properties of the Element object

Egenskap 描述
attributes Return the NamedNodeMap of the element's attribute.
baseURI 返回元素的绝对基准 URI。
childNodes 返回元素的子节点的 NodeList。
firstChild 返回元素的第一个子元素。
lastChild 返回元素的最后一个子元素。
localName 返回元素名称的本地部分。
namespaceURI 返回元素的命名空间 URI。
nextSibling 返回紧随该元素之后的节点。
nodeName 返回节点的名称,取决于其类型。
nodeType Returnera nodtypen.
ownerDocument 返回元素的根元素(文档对象)。
parentNode 返回元素的父节点。
prefix 设置或返回元素的命名空间前缀。
previousSibling 返回紧邻该元素之前的节点。
schemaTypeInfo 返回与元素相关联的类型信息。
tagName 返回元素的名称。
textContent 设置或返回元素及其后代的文本内容。

Element 对象的方法

Metod 描述
appendChild() 将新的子节点添加到该节点的子节点列表的末尾。
cloneNode() 克隆节点。
compareDocumentPosition() 比较两个节点的文档位置。
getAttribute() 返回属性的值。
getAttributeNS() 返回属性的值(带有命名空间)。
getAttributeNode() 返回属性节点,以 Attribute 对象。
getAttributeNodeNS() 返回属性节点(带有命名空间),以 Attribute 对象。
getElementsByTagName() 返回匹配元素节点及其子节点的 NodeList。
getElementsByTagNameNS() 返回匹配元素节点(带有命名空间)及其子节点的 NodeList。
getFeature(feature,version) 返回 DOM 对象,该对象实现指定特性和版本的专用 API。
getUserData(key) 返回与节点上的键关联的对象。必须首先将对象设置到此节点,通过使用相同的键来调用 setUserData。
hasAttribute() 返回元素是否拥有与指定名称匹配的属性。
hasAttributeNS() 返回元素是否拥有与指定名称和命名空间匹配的属性。
hasAttributes() 返回元素是否拥有属性。
hasChildNodes() 返回该元素是否有子节点。
insertBefore() Insert a new child node before the existing child nodes.
isDefaultNamespace(URI) Return whether the specified namespaceURI is the default.
isEqualNode() Check if two nodes are equal.
lookupNamespaceURI() Return the namespace URI that matches the specified prefix.
lookupPrefix() Return the prefix that matches the specified namespace URI.
normalize()

The normalize() method removes empty text nodes and connects adjacent text nodes.

Normalize all text nodes under the element (including attributes), where only structure (such as elements, comments, processing instructions, CDATA sections, and entity references) separates text nodes.

That is, there are no adjacent text nodes, nor empty text nodes.

removeAttribute() Delete the specified attribute.
removeAttributeNS() Delete the specified attribute (with namespace).
removeAttributeNode() Delete the specified attribute node.
removeChild() Delete the child node.
replaceChild() Replace the child node.
setUserData(key,data,handler) Associate the object with the key on the element.
setAttribute() Add a new attribute.
setAttributeNS() Add a new attribute (with namespace).
setAttributeNode() Add a new attribute node.
setAttributeNodeNS(attrnode) Add a new attribute node (with namespace).
setIdAttribute(name,isId) If the isId attribute of the Attribute object is true, this method declares the specified attribute as a user-defined ID attribute.
setIdAttributeNS(uri,name,isId) If the isId attribute of the Attribute object is true, this method declares the specified attribute (with namespace) as a user-defined ID attribute.
setIdAttributeNode(idAttr,isId) If the isId attribute of the Attribute object is true, this method declares the specified attribute as a user-defined ID attribute.

Toppen

Attributes of the Attr object

Egenskap 描述
baseURI Return the absolute base URI of the attribute.
isId If the attribute is of type id, return true, otherwise return false.
localName Return the local part of the attribute name.
name Return the name of the attribute.
namespaceURI Return the namespace URI of the attribute.
nodeName Returnera namnet på noden, beroende på dess typ.
nodeType Returnera nodtypen.
nodeValue Sätt eller returnera värdet för noden, beroende på dess typ.
ownerDocument Returnera rodenheten (dokumentobjektet) för egenskapen.
ownerElement Returnera elementnoden som egenskapen tillhör.
prefix Sätt eller returnera prefixet för namnrymden för egenskapen.
schemaTypeInfo Returnera typinformationen som är associerad med egenskapen.
specified

Om värdet för egenskapen har satts i dokumentet, returnera true;

Om värdet för egenskapen är standardvärdet i DTD/Schema, returnera false.

textContent Sätt eller returnera textinnehållet för egenskapen.
value Sätt eller returnera värdet för egenskapen.

Toppen

XML DOM Text-objekt

Egenskaper för Text-objektet

Egenskap 描述
data Sätt eller returnera texten för elementet eller egenskapen.
isElementContentWhitespace Kontrollera om textnoden innehåller tomrumsteckeninnehåll.
length Returnera textlängden för elementet eller egenskapen.
wholeText Returnera all text från textnoderna som är närliggande den här noden, sammankopplad i dokumentets ordning.

Metoder för Text-objektet

Metod 描述
appendData() Lägg till data till noden.
deleteData() Ta bort data från noden.
insertData() Infoga data i noden.
replaceData() Ersätt data i noden.
replaceWholeText(text) Ersätt texten för den här noden och alla närliggande textnoders text med den specificerade texten.
splitText() Dela upp en Text-nod i två.
substringData() Extrahera data från noden.

Toppen

XML DOM CDATASection-objekt

Egenskaper för CDATASection-objektet

Egenskap 描述
data Sätt eller returnera texten för den här noden.
length Returnera längden för CDATA-sektionen.

Metoder för CDATASection-objektet

Metod 描述
appendData() Lägg till data till noden.
deleteData() Ta bort data från noden.
insertData() Infoga data i noden.
replaceData() Ersätt data i noden.
splitText() Dela upp en CDATA-nod i två noder.
substringData() Extrahera data från noden.

Toppen

XML DOM Comment-objekt

Egenskaper för Comment-objektet

Egenskap 描述
data Sätt eller returnera texten för den här noden.
length Returnera textlängden för den här noden.

Metoder för Comment-objektet

Metod 描述
appendData() Lägg till data till noden.
deleteData() Ta bort data från noden.
insertData() Infoga data i noden.
replaceData() Ersätt data i noden.
substringData() Extrahera data från noden.

Toppen

XML DOM XMLHttpRequest-objekt

Metoder för XMLHttpRequest-objektet

Metod 描述
abort() Avbryt den aktuella förfrågan.
getAllResponseHeaders() Returnera huvudinformation.
getResponseHeader() Returnera värdet för den specifika HTTP-svarshuvudet.
open(method,url,async,uname,pswd)

Specificera typen för förfrågan, URL, om förfrågan ska hanteras asynkront samt andra valfria egenskaper för förfrågan.

  • method: Begäranstyp: GET eller POST
  • url: Filens plats på servern
  • async: true (asynkron) eller false (synchron)
send(string)

Skicka begäran till servern.

string: Används endast för POST-begäran

setRequestHeader() Lägg till etikett/värde-par till de huvudrubriker som ska skickas.

Egenskaper för XMLHttpRequest-objektet

Egenskap 描述
onreadystatechange Lagra funktionen (eller funktionens namn) som automatiskt anropas vid varje ändring av readyState-egenskapen.
readyState

Spara XMLHttpRequest-status. Förändringar från 0 till 4:

  • 0: Begäran är inte initialiserad
  • 1: Serveranslutningen är upprättad
  • 2: Begäran har mottagits
  • 3: Begäran behandlas
  • 4: Begäran är klar, svaret är klart
responseText Returnera responsdata som sträng.
responseXML Returnera responsdata i XML-data.
status Returnera statusnummer (t.ex. "404" betyder "Not Found", eller "200" betyder "OK").
statusText Returnera status-text (t.ex. "Not Found" eller "OK").

Toppen

XSD-element

element Förklara
all Specificera att underelement kan förekomma i valfri ordning, och att varje underelement kan förekomma noll eller en gång.
annotation Annotationselementet är en toppnivåelement som specificerar kommentarer till schema.
any Låt skaparen utöka XML-dokumentet genom att använda element som inte är definierade i schema.
anyAttribute Låt skaparen utöka XML-dokumentet genom att använda egenskaper som inte är definierade i schema.
appInfo Specificera information som applikationen ska använda i annotationselementet.
attribute Definiera en egenskap.
attributeGroup Definiera egenskapsgrupper som används i komplexa typdefinitioner.
choice Tillåt endast en element att förekomma i innehållet i en <choice>-förklaring.
complexContent Definiera utökningar eller begränsningar av komplexa typer (innehållande blandad innehåll eller endast element).
complexType Definiera komplex typ.
documentation Definiera textkommentarer i schema.
element Definiera element.
extension Utöka befintliga simpleType- eller complexType-element.
field Specificerar ett XPath-uttryck som reglerar värdet som används för att definiera identitetsbegränsningar.
group Definierar elementgrupper som används i komplexa typedefinitioner.
import Lägg till flera schema med olika målnamnrymdar till ett dokument.
include Lägg till flera schema med samma målnamnrymd till ett dokument.
key Specificerar att värdet för en egenskap eller ett element (eller en grupp värden) måste vara en nyckel inom ett specifikt intervall.
keyref Reglerar att värdet för en egenskap eller ett element (eller en grupp värden) ska motsvara värdet för en specifik nyckel eller unik element.
list Definierar en enkel typ som en lista över värden av ett specifikt dataformat.
notation Beskriver formatet för icke-XML-data i ett XML-dokument.
redefine Omskriver enkla och komplexa typer, grupper och egenskapsgrupper som hämtas från externa arkiv.
restriction Definierar begränsningar för simpleType, simpleContent eller complexContent.
schema Definierar roden till schemat.
selector Specificerar ett XPath-uttryck som väljer en grupp element för identitetsbegränsningar.
sequence Kräver att underelement måste framträda i följd. Varje underelement kan framträda 0 till okontrollerat antal gånger.
simpleContent Innehåller utökningar eller begränsningar av complexType-element utan att innehålla några element.
simpleType Definierar en enkel typ, som anger begränsningar och information om värdena för egenskaper eller element som endast innehåller text.
union Definierar en samling av flera simpleType-definitioner.
unique Specificera att värdet för en egenskap eller ett element måste vara unikt inom ett visst intervall.

Specifika XSD-begränsningar för datatyper

Se XSD-begränsningar / Facets

Begränsning 描述
enumeration Definierar en lista över acceptabla värden
fractionDigits Definierar det största tillåtna antalet decimaler. Det måste vara större än eller lika med 0.
length Definierar det exakta antalet tillåtna tecken eller listobjekt. Det måste vara större än eller lika med 0.
maxExclusive Definierar det största tillåtna värdet. De tillåtna värdena måste vara mindre än detta värde.
maxInclusive Definierar det största tillåtna värdet. De tillåtna värdena måste vara mindre än eller lika med detta värde.
maxLength Definierar det största tillåtna antalet tecken eller listobjekt. Det måste vara större än eller lika med 0.
minExclusive Definierar det minsta tillåtna värdet. De tillåtna värdena måste vara större än detta värde.
minInclusive Definierar det minsta tillåtna värdet. De tillåtna värdena måste vara större än eller lika med detta värde.
minLength Definiera den minsta antalet tecken eller listprojekt som tillåts. Måste vara större än eller lika med 0.
pattern Definiera den exakta sekvensen av tecken som accepteras.
totalDigits Definiera den exakta antalet decimaler som tillåts för arabiska siffror. Måste vara större än 0.
whiteSpace Definiera hur tomma tecken (nyckel, retur, blanksteg och tabulator) ska hanteras.

Toppen

XSLT-element

element 描述
apply-imports Applicera mallregler från en importerad stilskikt.
apply-templates Använd ett mönster på det nuvarande elementet eller dess underelement.
attribute Lägg till ett attribut till ett element.
attribute-set Skapa en namngiven attributuppsättning.
call-template Anropa ett specifikt mönster.
choose Används tillsammans med <when> och <otherwise> för att uttrycka flera villkorstester.
comment Skapa en kommentar nod i resultat trädet.
copy Skapa en kopia av den nuvarande noden (utan undernoder och egenskaper).
copy-of Skapa en kopia av den nuvarande noden (med undernoder och egenskaper).
decimal-format Definiera tecken och symboler som används när ett formatnummer-funktion konverterar ett nummer till en sträng.
element Skapa en elementnod i utdata dokumentet.
fallback Om hanteraren inte stöder en viss XSLT-element, specificera ett reservprogram att köra.
for-each Genomgå varje nod i den specificerade nodgruppen.
if Inkludera ett mönster, endast om en specifik förutsättning är uppfylld.
import Används för att skapa ett stilskikt från innehållet i ett annat stilskikt.
include Inkludera innehållet i ett stilskikt i ett annat stilskikt.
key Declarera en namngiven nyckel.
message Skriv ett meddelande till utdata (för felrapportering).
namespace-alias Erstätt namnrymden i stilskiktet med en annan namnrymd i utdata.
number Bestäm den nuvarande nodens heltalsposition och formatera numret.
otherwise Bestäm standardåtgärden för <choose>-elementet.
output Definiera formatet för utdata dokumentet.
param Declarera en lokal eller global parameter.
preserve-space Används för att definiera element som ska behålla tomma tecken.
processing-instruction Skapa en hanteringsinstruktion节点.
sort Sortera resultatet.
strip-space Definiera element som bör ta bort tomma tecken.
stylesheet Definierar rodelementet för stylets.
template Regler som tillämpas när den specifika noden matchas.
text Skapar textnoder genom att använda stylets.
transform Definierar rodelementet för stylets.
value-of Extraherar värdet för den valda noden.
variable Declarerar lokala eller globala variabler.
when Specificerar åtgärden för <choose>-elementet.
with-param Specificerar värdet för en parameter som ska passeras till en mall.

Toppen

XSLT, XPath och XQuery funktioner

Åtkomstfunktioner

名称 Description
fn:node-name(node) Returnerar nodnamnet för den angivna noden.
fn:nilled(node) Returnerar ett booleskt värde som indikerar om parametern är noll.
fn:data(item.item,...) Accepterar en serie objekt och returnerar en serie atomvärden.
  • fn:base-uri()
  • fn:base-uri(node)
Returnerar värdet av base-uri-attributet för den aktuella noden eller den angivna noden.
fn:document-uri(node) Returnerar värdet av document-uri-attributet för den angivna noden.

Fel- och spårningsfunktioner

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

exempel:error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high')

Resultat: Returnerar till den externa behandlingsmiljön http://example.com/test#toohigh samt strängen "Error: Price is too high".

fn:trace(value,label) Används för att debugga frågor.

Funktioner för numeriska värden

名称 Description
fn:number(arg)

Returnerar det numeriska värdet av parametern. Parametern kan vara ett booleskt värde, en sträng eller en noduppsättning.

exempel:number('100')

Resultat: 100

fn:abs(num)

Returnerar det absoluta värdet av parametern.

exempel:abs(3.14)

Resultat: 3.14

exempel:abs(-3.14)

Resultat: 3.14

fn:ceiling(num)

Returnerar det minsta heltal som är större än parametern num.

exempel:ceiling(3.14)

Resultat: 4

fn:floor(num)

Returnerar det största heltalet som inte är större än num-argumentet.

Exempel: floor(3.14)

Result: 3

fn:round(num)

Rundar num-argumentet till närmaste heltal.

Exempel: round(3.14)

Result: 3

fn:round-half-to-even()

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

Resultat: 0

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

Result: 2

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

Result: 2

Funktioner för strängar

名称 Description
fn:string(arg)

Returnerar strängvärdet för argumentet. Argumentet kan vara ett nummer, ett logiskt värde eller en nodsamling.

Exempel: string(314)

Resultat: "314"

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

Returnerar strängen baserat på kodpunktssekvensen.

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

Resultat: 'Thérèse'

fn:string-to-codepoints(string)

Returnerar kodpunktssekvensen baserat på strängen.

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

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

fn:codepoint-equal(comp1,comp2) Enligt Unicode-kodpunktsjämförelse returneras true om värdet för comp1 är lika med värdet för comp2. Annars returneras false. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint)
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

Om comp1 är mindre än comp2, returneras -1. Om comp1 är lika med comp2, returneras 0. Om comp1 är större än comp2, returneras 1. (Baserat på den använda jämförelseregeln).

Exempel: compare('ghi', 'ghi')

Resultat: 0

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

Returnerar sammansättning av strängar.

Exempel: concat('XPath ','är ','kul!')

Resultat: 'XPath är kul!'

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

Använd sep-parametern som separatortecken för att returnera den sammansatta strängen från string-argumenten.

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

Resultat: ' We are having fun! '

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

Resultat: 'Wearehavingfun!'

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

Resultat: ''

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

Returnerar en understräng av angiven längd från start-positionen. Första tecknets index är 1. Om len-parametret hoppas över, returneras understrängen från position start till strängens slut.

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

Resultat: 'Beat'

Exempel: substring('Beatles',2)

Resultat: 'eatles'

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

Returnerar längden på den angivna strängen. Om det inte finns ett string-argument, returneras längden på den aktuella nodens strängvärde.

Exempel: string-length('Beatles')

Resultat: 7

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

Tar bort angiven strängs början och slutet blanka tecken, och ersätter alla inre blankstrecksekvenser med ett, och returnerar resultatet. Om det inte finns ett string-argument, behandlas den aktuella noden.

Exempel: normalize-space(' The   XML ')

Resultat: 'The XML'

fn:normalize-unicode() Utför Unicode-standardisering.
fn:upper-case(string)

Konverterar string-argumentet till stora bokstäver.

Exempel: upper-case('The XML')

Resultat: 'THE XML'

fn:lower-case(string)

Konverterar string-argumentet till små bokstäver.

Exempel: lower-case('The XML')

Resultat: 'the xml'

fn:translate(string1,string2,string3)

Replace string2 in string1 with string3.

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

Result: '12:45'

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

Result: '12:45'

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

Result: 'bc:da'

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

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

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

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

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

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

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

fn:contains(string1,string2)

If string1 contains string2, return true, otherwise return false.

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

Result: true

fn:starts-with(string1,string2)

If string1 starts with string2, return true, otherwise return false.

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

Result: true

fn:ends-with(string1,string2)

If string1 ends with string2, return true, otherwise return false.

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

Resultat: false

fn:substring-before(string1,string2)

Return the substring before the occurrence of string2 in string1.

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

Result: '12'

fn:substring-after(string1,string2)

Return the substring after the occurrence of string2 in string1.

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

Result: '10'

fn:matches(string,pattern)

If the string parameter matches the specified pattern, return true, otherwise return false.

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

Result: true

fn:replace(string,pattern,replace)

Replace the specified pattern with the replace parameter and return the result.

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

Result: 'Be**a Ita*ia'

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

Result: 'Bea Itaia'

fn:tokenize(string,pattern)

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

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

Functions for anyURI

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

Functions related to boolean values

名称 Description
fn:boolean(arg) Return the boolean value of a number, string, or node set.
fn:not(arg)

First, restore the parameter to a boolean value using the boolean() function.

If the boolean value is false, return true, otherwise return true.

Example: not(true())

Resultat: false

fn:true()

Return the boolean value true.

Example: true()

Result: true

fn:false()

Return the boolean value false.

Example: false()

Resultat: false

Functions related to duration, date, and time

Function to extract components of date, time, and duration

名称 Description
fn:dateTime(date,time) Convert the parameter to a date and time.
fn:years-from-duration(datetimedur) Return the integer part of the year of the parameter value, expressed in standard vocabulary notation.
fn:months-from-duration(datetimedur) Return the integer part of the month of the parameter value, expressed in standard vocabulary notation.
fn:days-from-duration(datetimedur) Return the integer part of the day of the parameter value, expressed in standard vocabulary notation.
fn:hours-from-duration(datetimedur) Återger värdet för argumentet som ett heltal som representerar timmarna, angivet i standardlexikografisk notation.
fn:minutes-from-duration(datetimedur) Återger värdet för argumentet som ett heltal som representerar minuterna, angivet i standardlexikografisk notation.
fn:seconds-from-duration(datetimedur) Återger värdet för argumentet som ett decimaltal som representerar minuterna, angivet i standardlexikografisk notation.
fn:year-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett heltal som representerar åren.

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

Resultat: 2005

fn:month-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett heltal som representerar månaderna.

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

Resultat: 01

fn:day-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett heltal som representerar dagarna.

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

Resultat: 10

fn:hours-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett heltal som representerar timmarna.

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

Resultat: 12

fn:minutes-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett heltal som representerar minuterna.

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

Resultat: 30

fn:seconds-from-dateTime(datetime)

Återger det lokala värdet för argumentet som ett decimaltal som representerar sekunderna.

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

Resultat: 0

fn:timezone-from-dateTime(datetime) Returnerar tidszonkomponenten av argumentet, om den finns.
fn:year-from-date(date)

Återger det lokala värdet för argumentet som ett heltal som representerar året.

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

Resultat: 2005

fn:month-from-date(date)

Returnerar det heltal som representerar månaderna i det lokala värdet av argumentet.

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

Resultat: 4

fn:day-from-date(date)

Returnerar det heltal som representerar dagarna i det lokala värdet av argumentet.

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

Resultat: 23

fn:timezone-from-date(date) Returnerar tidszonkomponenten av argumentet, om den finns.
fn:hours-from-time(time)

Returnerar det heltal som representerar timmarna i det lokala värdet av argumentet.

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

Resultat: 10

fn:minutes-from-time(time)

Returnerar det heltal som representerar minuterna i det lokala värdet av argumentet.

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

Resultat: 22

fn:seconds-from-time(time)

Returnerar det heltal som representerar sekunderna i det lokala värdet av argumentet.

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

Resultat: 0

fn:timezone-from-time(time) Returnerar tidszonkomponenten av argumentet, om den finns.
fn:adjust-dateTime-to-timezone(datetime,timezone)

Om tidszon-argumentet är tomt, returneras dateTime utan tidszon.

Annars returneras dateTime med tidszon.

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

Om tidszon-argumentet är tomt, returneras datum utan tidszon.

Annars returneras datum med tidszon.

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

Om tidszon-argumentet är tomt, returneras tid utan tidszon.

Annars returnerar tid med tidszon.

Funktioner relaterade till 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()  

Funktioner för noder

名称 Description
  • fn:name()
  • fn:name(nodeset)
Returnerar namnet på den aktuella noden eller den första noden i den specifika nodgruppen.
  • fn:local-name()
  • fn:local-name(nodeset)
Returnerar namnet på den aktuella noden eller den första noden i den specifika nodgruppen utan namnrymdsprefix.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
Returnerar namnrymds URI för den aktuella noden eller den första noden i den specifika nodgruppen.
fn:lang(lang)

Returnerar true om språket för den aktuella noden matchar det specificerade språket.

Exempel: Lang("en") är true för <p xml:lang="en">...</p>

Exempel: Lang("de") är false för <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
Returnerar roten till nodträdet som tillhör den aktuella noden eller den specifika noden. Detta är vanligtvis en dokumentnod.

Funktioner för sekvenser

Allmän funktion

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

Returnerar positionen för det element som är lika med searchitem-argumentet i projektsekvensen.

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

Resultat: (2, 4)

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

Resultat (1, 4)

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

Resultat: ()

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

Returnerar en ny sekvens konstruerad av item-argumentet - och tar bort det element som specificeras av position-argumentet.

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

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

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

Resultat: ("cd", "ef")

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

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

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

Om parametervärdet är en tom sekvens returneras true, annars returneras false.

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

Resultat: false

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

Returnerar true om parametervärdet inte är en tom sekvens, annars returnerar det false.

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

Resultat: false

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

Returnerar unika värden.

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

Resultat: (1, 2, 3)

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

Returnerar en ny sekvens konstruerad av item-argumentet, samtidigt som det läggs till värdet av inserts-argumentet vid positionen specificerad av pos-argumentet.

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

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

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

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

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

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

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

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

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

Returnerar omvänd ordning av specifika projekt.

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

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

Exempel: reverse(("ab"))

Resultat: ("ab")

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

Returnerar en projektsekvens som specificerats av start-argumentet, och längden på sekvensen specificeras av len-argumentet.

Positionen för det första projektet är 1.

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

Resultat: ($item3, ...)

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

Resultat: ($item2, $item3)

fn:unordered((item,item,...)) Returnerar projekt i den ordning som definieras av implementeringen.

Testa sekvenskapaciteten

名称 Description
fn:zero-or-one(item,item,...) Returns the parameter if it contains zero or one item, otherwise generates an error.
fn:one-or-more(item,item,...) Returns the parameter if it contains one or more items, otherwise generates an error.
fn:exactly-one(item,item,...) Returns the parameter if it contains one item, 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 of the parameter values.

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

Result: 2

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

Returns the argument that is greater than the other arguments.

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

Result: 3

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

Result: 'k'

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

Returns the argument that is less than the other arguments.

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.

Sequence Generation Functions

名称 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。

Toppen

其他 XML DOM 对象

Toppen