XML reference manual

XML reference manual

节点类型

下面的表格列出了不同的 W3C 节点类型，以及它们可拥有的子元素：

节点类型 描述 子元素
Document 表示整个文档（DOM 树的根节点）
  • Element (max. one)
  • ProcessingInstruction
  • Comment
  • DocumentType
DocumentFragment 表示轻量级的 Document 对象，其中容纳了一部分文档。
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
DocumentType 向为文档定义的实体提供接口。 None
ProcessingInstruction 表示处理指令。 None
EntityReference 表示实体引用元素。
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
Element 表示 element（元素）元素
  • Text
  • Comment
  • ProcessingInstruction
  • CDATASection
  • EntityReference
Attr 表示属性。
  • Text
  • EntityReference
Text 表示元素或属性中的文本内容。 None
CDATASection 表示文档中的 CDATA 区段（文本不会被解析器解析） None
Comment 表示注释。 None
Entity 表示实体。
  • ProcessingInstruction
  • Comment
  • Text
  • CDATASection
  • EntityReference
Notation 表示在 DTD 中声明的符号。 None

节点类型 - 所返回的值

下面的表格列出了对每个节点类型来说，nodeName 和 nodeValue 属性可返回的值：

节点类型 nodeName 的返回值 nodeValue 的返回值
Document #document null
DocumentFragment #document fragment null
DocumentType doctype 名称 null
EntityReference 实体引用名称 null
Element element name null
Attr 属性名称 属性值
ProcessingInstruction target 节点的内容
Comment #comment 注释文本
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

Top

XML DOM Node objekt

Properties of Node object

egenskab 描述
attributes NamedNodeMap containing the properties 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 following sibling node of the node.
nodeName Returner navnet på en node, afhængigt af dens type.
nodeType Returner typen for en node.
nodeValue Indstil eller returner værdien for en node, afhængigt af dens type.
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 preceding sibling node of the node.
textContent Set or return the text content of the node and its descendants.

Methods of Node object

Metode 描述
appendChild() Append a new child node to the end of the node's child node list.
cloneNode() Clone the node.
compareDocumentPosition() Compare the position of two nodes in the DOM hierarchy (document).
getFeature()feature,version) Return a DOM object that implements a specialized API for the specified feature and version.
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.

Top

XML DOM NodeList objekt

Properties of NodeList object

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

Methods of NodeList object

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

Top

XML DOM NamedNodeMap objekt

NamedNodeMap-objektets egenskaber

egenskab 描述
length Returner antallet af noder i listen.

NamedNodeMap-objektets metoder

Metode 描述
getNamedItem() Returner noden med specifikt navn.
getNamedItemNS() Returner noden med specifikt navn og navnerum.
item() Returner noden ved specifik index.
removeNamedItem() Fjern node med specifikt navn.
removeNamedItemNS() Fjern node med specifikt navn og navnerum.
setNamedItem() Sæt den specificerede node (efter navn).
setNamedItemNS() Sæt den specificerede node (efter navn og navnerum).

Top

XML DOM Document objekt

Document-objektets egenskaber

egenskab 描述
childNodes Returner NodeList af dokumentets undernodes.
doctype Returner dokumenttypedeklarationen, der er knyttet til dokumentet.
documentElement Returner dokumentets rodnode.
documentURI Sæt eller returner dokumentets placering.
domConfig Returner konfigurationen, der bruges ved kald af normalizeDocument().
firstChild Returner dokumentets første undernode.
implementation Returner DOMImplementation-objektet, der håndterer dette dokument.
inputEncoding Returner dokumentets brugte encoding (ved fortolkning).
lastChild Returner dokumentets sidste undernode.
nodeName Returner navnet på noden (afhænger af dens type).
nodeType Returner nodens nodetype.
nodeValue Sæt eller returner værdien af noden (afhænger af dens type).
xmlEncoding Returner dokumentets XML encoding.
xmlStandalone Sæt eller returner, om dokumentet er selvstændigt.
xmlVersion Sæt eller returner dokumentets XML version.

Document-objektets metoder

Metode 描述
adoptNode() Tag en node fra en anden dokument ind i dette dokument og returner den adopterede node.
createAttribute() Opret en egenskabsnode med specificeret navn, og returner det nye Attr-objekt.
createAttributeNS() Opret en egenskabsnode med specificeret navn og navnerum, og returner det nye Attr-objekt.
createCDATASection() Opret en CDATA sektion节点。
createComment() Opret en kommentar节点。
createDocumentFragment() Opret et tomt DocumentFragment-objekt og returner 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, which is either null or a DocumentType object.

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

egenskab 描述
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.

Metode 描述
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.

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

Top

XML DOM Element objekt

Properties of the Element object

egenskab 描述
attributes Return the NamedNodeMap of the element's attribute.
baseURI Return the absolute base URI of the element.
childNodes Return the NodeList of the element's child nodes.
firstChild Return the first child element of the element.
lastChild Return the last child element of the element.
localName Return the local part of the element name.
namespaceURI Return the namespace URI of the element.
nextSibling Return the node immediately following the element.
nodeName Return the name of the node, depending on its type.
nodeType Returner typen for en node.
ownerDocument Return the root element (document object) of the node.
parentNode Return the parent node of the element.
prefix Set or return the namespace prefix of the element.
previousSibling Return the node immediately preceding the element.
schemaTypeInfo Return the type information associated with the element.
tagName Return the name of the element.
textContent Set or return the text content of the element and its descendants.

Element object method

Metode 描述
appendChild() Add a new child node to the end of the node's child node list.
cloneNode() Clone the node.
compareDocumentPosition() Compare the document position of two nodes.
getAttribute() Return the value of the attribute.
getAttributeNS() Return the value of the attribute (with namespace).
getAttributeNode() Return an attribute node as an Attribute object.
getAttributeNodeNS() Return an attribute node (with namespace) as an Attribute object.
getElementsByTagName() Return a NodeList of matching element nodes and their child nodes.
getElementsByTagNameNS() Return a NodeList of matching element nodes (with namespace) and their child nodes.
getFeature()feature,version) Return a DOM object that implements a specialized API for the specified feature and version.
getUserData()key) Return the object associated with the key on the node. The object must first be set to this node by calling setUserData with the same key.
hasAttribute() Return whether the element has an attribute matching the specified name.
hasAttributeNS() Return whether the element has an attribute matching the specified name and namespace.
hasAttributes() Return whether the element has attributes.
hasChildNodes() Return whether the element has child nodes.
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 are there 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.

Top

Attributes of the Attr object

egenskab 描述
baseURI Return the absolute base URI of the attribute.
isId Return true if the attribute is of type id, 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 Returner navnet på en node, afhængigt af dens type.
nodeType Returner typen for en node.
nodeValue Indstil eller returner værdien for en node, afhængigt af dens type.
ownerDocument Returner rodelementet (dokumentobjektet) for egenskaben.
ownerElement Returner elementnoden, der er tilknyttet egenskaben.
prefix Indstil eller returner navnepræfikset for egenskaben.
schemaTypeInfo Returner typeinformation, der er knyttet til egenskaben.
specified

Returner true, hvis værdien af egenskaben er sat i dokumentet;

Returner false, hvis værdien af egenskaben er standardværdien i DTD/Schema.
textContent Indstil eller returner tekstindholdet for en egenskab.
value Indstil eller returner værdien for en egenskab.

Top

XML DOM Text objekt

Egenskaber på Text-objektet

egenskab 描述
data Indstil eller returner teksten for et element eller en egenskab.
isElementContentWhitespace Afgør om en tekstnode indeholder indhold af blanke tegn.
length Returner tekstlængden for et element eller en egenskab.
wholeText Returner alle tekster, der er nærliggende denne node, forbundet i dokumentets rækkefølge.

Metoder på Text-objektet

Metode 描述
appendData() Tilføj data til en node.
deleteData() Fjern data fra en node.
insertData() Indsæt data i en node.
replaceData() Erstat data i en node.
replaceWholeText(text) Erstat teksten for denne node og alle nærliggende tekstnoders tekst med den specificerede tekst.
splitText() Del en Text-node i to.
substringData() Uddrag data fra en node.

Top

XML DOM CDATASection objekt

Egenskaber på CDATASection-objektet

egenskab 描述
data Indstil eller returner teksten for denne node.
length Returner længden af CDATA-sektionen.

Metoder på CDATASection-objektet

Metode 描述
appendData() Tilføj data til en node.
deleteData() Fjern data fra en node.
insertData() Indsæt data i en node.
replaceData() Erstat data i en node.
splitText() Del en CDATA-node i to.
substringData() Uddrag data fra en node.

Top

XML DOM Comment objekt

Egenskaber på Comment-objektet

egenskab 描述
data Indstil eller returner teksten for denne node.
length Returner længden af teksten for denne node.

Metoder på Comment-objektet

Metode 描述
appendData() Tilføj data til en node.
deleteData() Fjern data fra en node.
insertData() Indsæt data i en node.
replaceData() Erstat data i en node.
substringData() Uddrag data fra en node.

Top

XML DOM XMLHttpRequest objekt

Metoder på XMLHttpRequest-objektet

Metode 描述
abort() Annuller den aktuelle anmodning.
getAllResponseHeaders() Returner header information.
getResponseHeader() Returner værdien af den specificerede HTTP respons header.
open(method,url,async,uname,pswd)

Specificer den anmodede type, URL, om anmodningen skal håndteres asynkront samt andre valgfri egenskaber for anmodningen.

  • method: Anmodningstypen: GET eller POST
  • url: Filens placering på serveren
  • async: true (asynkron) eller false (synkron)
send(string)

Send anmodningen til serveren.

string: Kun brugt til POST-anmodninger
setRequestHeader() Tilføj et etiket/værdi par til de hoveder, der skal sendes.

XMLHttpRequest-objektets egenskaber

egenskab 描述
onreadystatechange Lagrer funktionen (eller funktionens navn), der automatisk kaldes ved hver ændring af readyState-attributten.
readyState

Gemmer XMLHttpRequest's tilstand. Fra 0 til 4 ændringer:

  • 0: Anmodningen er ikke initialiseret
  • 1: Serverforbindelsen er etableret
  • 2: Anmodningen modtaget
  • 3: Anmodningen håndteres
  • 4: Anmodningen er fuldført, svaret er klar
responseText Returnerer respons data som en streng.
responseXML Returnerer respons data som XML data.
status Returnerer status nummer (f.eks. "404" betyder "Ikke Fundet", eller "200" betyder "OK").
statusText Returnerer status tekst (f.eks. "Ikke Fundet" eller "OK").

Top

XSD-elementer

element forklaring
all Fastlæggelse af, at underelementer kan optræde i hvilken som helst rækkefølge, og at hver underelement kan optræde nul eller én gang.
annotation Annotation-elementet er en topniveau element, der definerer kommentarer til schemaet.
any Lader skaberne udvide XML-dokumentet gennem elementer, der ikke er defineret i schemaet.
anyAttribute Lader skaberne udvide XML-dokumentet gennem egenskaber, der ikke er defineret i schemaet.
appInfo Fastlæggelse af information, som applikationen skal bruge i annotation-elementet.
attribute Definer en egenskab.
attributeGroup Definer egenskabsgrupper brugt i komplekse type definitioner.
choice Tillader kun én element at optræde i en indeholdende element i en <choice>-erklæring.
complexContent Definer udvidelser eller begrænsninger af komplekse typer (inkluderer blandet indhold eller kun elementer).
complexType Definer komplekse typer.
documentation Definer tekstkommentarer i schemaet.
element Definer elementer.
extension Udvid eksisterende simpleType- eller complexType-elementer.
field Specificerer en XPath-udtryk, der definerer værdierne, der bruges til at definere identitetsbegrænsninger.
group Definerer en gruppe af elementer, der bruges i komplekse type definitioner.
import Tilføj flere schemaer med forskellige målnavnespaces til et dokument.
include Tilføj flere schemaer med samme målnavnespace til et dokument.
key Specificerer, at værdien af en egenskab eller et element (eller en gruppe værdier) skal være en nøgle inden for en specificeret rækkevidde.
keyref Specificerer, at værdien af en egenskab eller et element (eller en gruppe værdier) skal svare til værdien af en specificeret nøgle eller unik element.
list Definerer en simpel type som en liste af værdier af en specificeret data type.
notation Beskriver formatet af ikke-XML data i et XML-dokument.
redefine Omdефinerer simple og komplekse typer, grupper og egenskabsgrupper, der er hentet fra eksterne arkitekturfiler.
restriction Definerer begrænsninger for simpleType, simpleContent eller complexContent.
schema Definerer schemaets rod element.
selector Specificerer en XPath-udtryk, der vælger en gruppe elementer til identitetsbegrænsninger.
sequence Kræver, at underelementer skal optræde i den angivne rækkefølge. Hver underelement kan optræde 0 til en hvilken som helst gang.
simpleContent Inkluderer udvidelser eller begrænsninger af complexType-elementer og indeholder ingen elementer.
simpleType Definerer en simpel type, der angiver begrænsninger samt information om værdierne af egenskaber eller elementer, der kun indeholder tekst.
union Definerer en samling af simpleType definitioner.
unique Specificerer, at værdien af en egenskab eller et element i en bestemt rækkevidde skal være unik.

Specifikation af XSD begrænsninger for datatyper

Se XSD begrænsninger / Facets

Begrænser 描述
enumeration Definerer en liste af acceptable værdier.
fractionDigits Definerer det maksimale antal decimaler, der er tilladt. Det skal være større end eller lig med 0.
length Definerer det præcise antal tilladte tegn eller elementer i en liste. Det skal være større end eller lig med 0.
maxExclusive Definerer den højeste grænseværdi for et tal. De tilladte værdier skal være mindre end denne værdi.
maxInclusive Definerer den højeste grænseværdi for et tal. De tilladte værdier skal være mindre end eller lig med denne værdi.
maxLength Definerer det maksimale antal tilladte tegn eller elementer i en liste. Det skal være større end eller lig med 0.
minExclusive Definerer den laveste grænseværdi for et tal. De tilladte værdier skal være større end denne værdi.
minInclusive Definerer den laveste grænseværdi for et tal. De tilladte værdier skal være større end eller lig med denne værdi.
minLength Definer det mindste antal tegn eller elementer, der er tilladt. Må være større end eller lig med 0.
pattern Definer den nøjagtige sekvens af tegn, der er accepteret.
totalDigits Definer den nøjagtige antal decimaler, der er tilladt for de tilladte arabiske tal. Må være større end 0.
whiteSpace Definer behandlingen af blanke tegn (linjeskift, returtegn, mellemrum og tabulatorer).

Top

XSLT-element

element 描述
apply-imports Anvend skabelonregler fra en importeret stilskema.
apply-templates Anvend skabelon på det nuværende element eller underelementer.
attribute Tilføj en egenskab til et element.
attribute-set Opret en navngivet egenskabsgruppe.
call-template Kald en specificeret skabelon.
choose Brug sammen med <when> og <otherwise> til at udtrykke flere betingelsesprøvninger.
comment Opret en kommentarnode i resultattreet.
copy Opret en kopi af den nuværende node (uden undernodes og egenskaber).
copy-of Opret en kopi af den nuværende node (med undernodes og egenskaber).
decimal-format Definer de tegn og symboler, der skal bruges, når et tal konverteres til en streng ved hjælp af format-number() funktionen.
element Opret et elementnode i output-dokumentet.
fallback Hvis processor ikke understøtter en XSLT-element, definer et alternativt kodeblok til kørsel.
for-each Gennemløb hver node i den angivne nodeskema.
if Inkluder et skabelon, kun når en bestemt betingelse er opfyldt.
import Brugt til at inkludere indholdet af et stilskema i et andet stilskema.
include Inkluder indholdet af et stilskema i et andet stilskema.
key Deklarér en navngivet nøgle.
message Skriv en besked til output (brugt til fejlrapportering).
namespace-alias Erstat navnerummet i stilskemaet med et andet navnerum i output.
number Bestem den nuværende nodes integerposition og formater tallene.
otherwise Definér standardhandling for <choose>-elementet.
output Definér formatet for output-dokumentet.
param Deklarér en lokal eller global parameter.
preserve-space Brugt til at definere elementer, der skal bevare blanke tegn.
processing-instruction Opret et behandlingskommando-nodeskema.
sort Sorter resultaterne.
strip-space Definiera elementer, der skal fjerne blanke tegn.
stylesheet definerer rodelementet for stilskabelonen.
template regler, der anvendes, når den specificerede knude matcher.
text genererer tekstknuder gennem stilskabelonen.
transform definerer rodelementet for stilskabelonen.
value-of udtrækker værdien af den valgte knude.
variable deklarerer lokale eller globale variabler.
when angiver handlingen for <choose> elementet.
with-param angiver værdien af parameteren, der skal indsendes til en skabelon.

Top

XSLT, XPath og XQuery funktioner

adgangsfunktioner

名称 Beskrivelse
fn:node-name(node) returnerer navnet på parameterknuden.
fn:nilled(node) returnerer et boolesk værdi der angiver om parameterknuden afvises.
fn:data(item.item,...) accepterer en sekvens af elementer og returnerer en sekvens af atomværdier.
  • fn:base-uri()
  • fn:base-uri(node)
 returnerer værdien af base-uri egenskaben for den aktuelle node eller den specificerede node.
fn:document-uri(node) returnerer værdien af document-uri egenskaben for den specificerede node.

fejl- og sporingfunktioner

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

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

resultat: Returnerer http://example.com/test#toohigh til den eksterne behandle miljø samt strengen "Error: Price is too high".
fn:trace(value,label) bruges til at debugge forespørgsler.

funktioner relateret til numeriske værdier

名称 Beskrivelse
fn:number(arg)

returnerer parameterens numeriske værdi. Parameter kan være et boolesk værdi, en streng eller en nodekollektion.

eksempel:number('100')

resultat: 100
fn:abs(num)

returnerer parameterens absolutte værdi.

eksempel:abs(3.14)

resultat: 3.14

eksempel:abs(-3.14)

resultat: 3.14
fn:ceiling(num)

returnerer det mindste heltal større end num parameteren.

eksempel:ceiling(3.14)

Returnerer parameterens lokale værdi, der repræsenterer månedsdelerne som et heltal.
fn:floor(num)

Returnerer det største heltal, der er mindre end eller lig med num parameteret.

Eksempel: floor(3.14)

Resultat: 3
fn:round(num)

Runder num parameteret op til det nærmeste heltal.

Eksempel: round(3.14)

Resultat: 3
fn:round-half-to-even()

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

Returnerer parameterens lokale værdi, der repræsenterer sekunddelene som et heltal.

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

Resultat: 2

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

Resultat: 2

Funktioner til streng

名称 Beskrivelse
fn:string(arg)

Returnerer den strengeværdi af argumentet. Argumentet kan være et tal, en logisk værdi eller en nodesæt.

Eksempel: string(314)

Resultat: "314"
fn:codepoints-to-string(int,int,...)

Returnerer en streng baseret på en sekvens af kodepunkter.

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

Resultat: 'Thérèse'
fn:string-to-codepoints(string)

Returnerer en sekvens af kodepunkter baseret på streng.

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

Resultat: 84, 104, 233, 114, 232, 115, 101
fn:codepoint-equal(comp1,comp2) Baseret på Unicode kodepunkts sammenligning, returneres true, hvis værdien af comp1 er lig med værdien af comp2. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint), ellers returneres false.
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

Hvis comp1 er mindre end comp2, returneres -1. Hvis comp1 er lig med comp2, returneres 0. Hvis comp1 er større end comp2, returneres 1. (afhængigt af den anvendte sammenligningsregel).

Eksempel: compare('ghi', 'ghi')

Returnerer parameterens lokale værdi, der repræsenterer sekunddelene som et heltal.
fn:concat(string,string,...)

Returnerer en sammenføjning af strenge.

Eksempel: concat('XPath ','er ','sjov!')

Resultat: 'XPath er sjov!'
fn:join((string,string,...),sep)

brug sep parameteren som adskiller for at returnere en sammensat string fra string parameteren.

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

resultat: ' We are having fun! '

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

resultat: 'Wearehavingfun!'

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

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

returnerer en substring af den angivne længde fra start positionen. Den første characters indeks er 1. Hvis len parameteren udelades, returneres substring fra position start til slutningen af strengen.

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

resultat: 'Beat'

eksempel: substring('Beatles',2)

resultat: 'eatles'
  • fn:string-length(string)
  • fn:string-length()

returnerer længden af den angivne string. Hvis der ikke er en string parameter, returneres længden af den aktuelle nodes strings værdi.

eksempel: string-length('Beatles')

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

fjerner angivne strings begyndelse og slutning af mellemrum, og erstatter alle interne mellemrumsserier med en, og returnerer derefter resultatet. Hvis der ikke er en string parameter, behandles den aktuelle node.

eksempel: normalize-space(' The　　　XML ')

resultat: 'The XML'
fn:normalize-unicode() udføres Unicode standardisering.
fn:upper-case(string)

konverterer string parameter til store bogstaver.

eksempel: upper-case('The XML')

resultat: 'THE XML'
fn:lower-case(string)

konverterer string parameter til små bogstaver.

eksempel: lower-case('The XML')

resultat: 'the xml'
fn:translate(string1,string2,string3)

Erstat string2 med string3 i string1.

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

Resultat: '12:45'

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

Resultat: '12:45'

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

Resultat: 'bc:da'
fn:escape-uri(stringURI,esc-res)

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

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

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

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

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

Resultat: "http://example.com/~b%C3%A9b%C3%A9"
fn:contains(string1,string2)

Returner true, hvis string1 indeholder string2, ellers returner false.

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

Resultat: true
fn:starts-with(string1,string2)

Returner true, hvis string1 starter med string2, ellers returner false.

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

Resultat: true
fn:ends-with(string1,string2)

Returner true, hvis string1 slutter med string2, ellers returner false.

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

resultat: false
fn:substring-before(string1,string2)

Returner den understreng, der forud for string2 i string1.

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

Resultat: '12'
fn:substring-after(string1,string2)

Returner den understreng, der følger string2 i string1.

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

Resultat: '10'
fn:matches(string,pattern)

Returnerer true, hvis string parameteren matcher det angivne mønster, ellers returnerer den false.

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

Resultat: true
fn:replace(string,pattern,replace)

Erstat den angivne mønster med replace parameter og returner resultatet.

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

Resultat: 'Be**a Ita*ia'

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

Resultat: 'Bea Itaia'
fn:tokenize(string,pattern)

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

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

Funktioner relateret til anyURI

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

Funktioner relateret til booleske værdier

名称 Beskrivelse
fn:boolean(arg) Returnerer boolesk værdi for et tal, en streng eller en nodesæt.
fn:not(arg)

Først gendannes parameteren til en boolesk værdi ved hjælp af boolean() funktionen.

Returnerer true, hvis den booleske værdi er false, ellers returnerer den true.

Eksempel: not(true())

resultat: false
fn:true()

Returnerer boolesk værdi true.

Eksempel: true()

Resultat: true
fn:false()

Returnerer boolesk værdi false.

Eksempel: false()

resultat: false

Funktioner relateret til varighed, dato og tid

Funktioner til at extrahere komponenter af dato, tid og varighed

名称 Beskrivelse
fn:dateTime(date,time) Konverterer parameteren til dato og tid.
fn:years-from-duration(datetimedur) Returnerer parameterens årgangsdel som et heltal, repræsenteret ved standardvokabular.
fn:months-from-duration(datetimedur) Returnerer parameterens månedsdel som et heltal, repræsenteret ved standardvokabular.
fn:days-from-duration(datetimedur) Returnerer parameterens deldel som et heltal, repræsenteret ved standardvokabular.
fn:hours-from-duration(datetimedur) Returnerer værdens time-del som et heltal, repræsenteret ved standardvokabular.
fn:minutes-from-duration(datetimedur) Returnerer værdens minutdel som et heltal, repræsenteret ved standardvokabular.
fn:seconds-from-duration(datetimedur) Returnerer værdens minutdel som et decimaltal, repræsenteret ved standardvokabular.
fn:year-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende året.

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

结果：2005
fn:month-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende måneden.

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

Resultat: 01
fn:day-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende dagen.

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

Returnerer parameterens lokale værdi, der repræsenterer time-delene som et heltal.
fn:hours-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende timerne.

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

Resultat: 12
fn:minutes-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende minutterne.

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

Resultat: 30
fn:seconds-from-dateTime(datetime)

Returnerer det lokale værdi af argumentet som et decimaltal repræsenterende sekunderne.

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

Returnerer parameterens lokale værdi, der repræsenterer sekunddelene som et heltal.
fn:timezone-from-dateTime(datetime) Resultat: 0
fn:year-from-date(date)

Returnerer det lokale værdi af argumentet som et heltal repræsenterende året.

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

结果：2005
fn:month-from-date(date)

Resultat: 2005

fn:month-from-date(date)

Returnerer parameterens lokale værdi, der repræsenterer månedsdelerne som et heltal.
Eksempel: month-from-date(xs:date("2005-04-23"))

Resultat: 4

fn:day-from-date(date)

Returnerer parameterens lokale værdi, der repræsenterer dagdelene som et heltal.
Eksempel: day-from-date(xs:date("2005-04-23")) Resultat: 0
Resultat: 23

fn:timezone-from-date(date)

fn:hours-from-time(time)

Returnerer parameterens lokale værdi, der repræsenterer time-delene som et heltal.
Eksempel: hours-from-time(xs:time("10:22:00"))

Resultat: 10

fn:minutes-from-time(time)

Returnerer parameterens lokale værdi, der repræsenterer minutdelene som et heltal.
Eksempel: minutes-from-time(xs:time("10:22:00"))

Resultat: 22

fn:seconds-from-time(time)

Returnerer parameterens lokale værdi, der repræsenterer sekunddelene som et heltal.
Eksempel: seconds-from-time(xs:time("10:22:00")) Resultat: 0
fn:timezone-from-time(time)

Returnerer parameterens tidszonestilling, hvis den findes.

fn:adjust-dateTime-to-timezone(datetime,timezone)
Hvis tidszonestilling-argumentet er tomt, returneres dateTime uden tidszone.

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

Hvis tidszonestilling-argumentet er tomt, returneres date uden tidszone.
fn:adjust-time-to-timezone(time,timezone)

Hvis tidszonestilling-argumentet er tomt, returneres date uden tidszone.

Hvis tidszonestilling-argumentet er tomt, returneres time uden tidszone.

Funktioner relateret til QNames

名称 Beskrivelse
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 relateret til noder

名称 Beskrivelse
  • fn:name()
  • fn:name(nodeset)
 Returnerer navnet på den nuværende node eller den første node i den specificerede node samling.
  • fn:local-name()
  • fn:local-name(nodeset)
 Returnerer navnet på den nuværende node eller den første node i den specificerede node samling - uden navnerum præfiks.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
 Returnerer navnerum URI'en for den nuværende node eller den første node i den specificerede node samling.
fn:lang(lang)

Returnerer true, hvis sprogene på den nuværende node matcher det specificerede sprog.

Eksempel: Lang("en") er true for <p xml:lang="en">...</p>

Eksempel: Lang("de") er false for <p xml:lang="en">...</p>
  • fn:root()
  • fn:root(node)
 Returnerer roden af det node-træ, som den nuværende node eller den specificerede node tilhører. Det er typisk dokumentnoden.

Funktioner relateret til sekvenser

Generelle funktioner

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

Returnerer positionen af elementet i projektsekvensen, der er lig med searchitem parameteren.

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

Resultat: (2, 4)

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

Resultat (1, 4)

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

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

Returnerer en ny sekvens konstrueret af item parameter - og sletter det element, der er specificeret af position parameteren.

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

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

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

Resultat: ("cd", "ef")

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

Resultat: ("ab", "cd", "ef")
fn:empty(item,item,...)

Hvis parameter værdien er en tom sekvens, returnerer den true, ellers returnerer den false.

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

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

returnerer true, hvis parameterværdien ikke er en tom sekvens, ellers returnerer den false.

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

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

returnerer unikke værdier.

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

resultat: (1, 2, 3)
fn:insert-before((item,item,...),pos,inserts)

returnerer en ny sekvens konstrueret af item parameteren - og indsætter værdien af inserts parameteren på den position, der specificeres af pos parameteren.

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

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

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

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

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

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

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

resultat: ("ab", "cd", "gh")
fn:reverse((item,item,...))

returnerer den omvendte rækkefølge af de specificerede projekter.

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

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

eksempel: reverse(("ab"))

resultat: ("ab")
fn:subsequence((item,item,...),start,len)

returnerer projektsekvensen ved hjælp af start parameteren, og længden af sekvensen specificeres af len parameteren.

den første projektets placering er 1.

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

resultat: ($item3, ...)

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

resultat: ($item2, $item3)
fn:unordered((item,item,...)) returnerer projekter i den rækkefølge, der er bestemt af implementeringen.

test af sekvenskapacitetens funktion

名称 Beskrivelse
fn:zero-or-one(item,item,...) Returnerer parameteren, hvis den indeholder ingen eller én projekt, ellers genererer den en fejl.
fn:one-or-more(item,item,...) Returnerer parameteren, hvis den indeholder en eller flere projekter, ellers genererer den en fejl.
fn:exactly-one(item,item,...) Returnerer parameteren, hvis den indeholder et projekt, ellers genererer den en fejl.

Lige, Union, Intersection og Except

名称 Beskrivelse
fn:deep-equal(param1,param2,collation) Returnerer true, hvis param1 og param2 er ens (deep-equal), ellers returnerer false.

Samlefunktioner

名称 Beskrivelse
fn:count((item,item,...)) Returnerer antallet af noder.
fn:avg((arg,arg,...))

Returnerer gennemsnittet af værdierne for parameterne.

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

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

Returnerer den parameter, der er større end de andre parametre.

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

Resultat: 3

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

Resultat: 'k'
fn:min((arg,arg,...))

Returnerer den parameter, der er mindre end de andre parametre.

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

Resultat: 1

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

Resultat: 'a'
fn:sum(arg,arg,...) Returnerer summen af værdierne for hver node i den angivne nodemasse.

Funktioner til at generere sekvenser

名称 Beskrivelse
fn:id((string,string,...),node) Returnerer en sekvens af elementnoder, hvis ID-værdi er lig en eller flere værdier specificeret i string parameteren.
fn:idref((string,string,...),node) Returnerer en sekvens af elementer eller egenskabsnoder, hvis IDREF-værdi er lig en eller flere værdier specificeret i string parameteren.
fn:doc(URI) 　
fn:doc-available(URI) Returnerer true, hvis doc() funktionen returnerer et dokumentnode, ellers returnerer false.
  • fn:collection()
  • fn:collection(string)
 　

Kontekstfunktioner

名称 Beskrivelse
fn:position()

Returnerer index-positionen for den node, der aktuelt håndteres.

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

Resultat: Vælg de tre første book-elementer

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。

Top

其他 XML DOM 对象

Top