XSLT, XPath 및 XQuery 함수
XSLT 2.0, XPath 2.0, XQuery 1.0은 공통된 함수 라이브러리를 공유합니다.
함수 참조 매뉴얼
함수 이름 공간의 기본 전사는 다음과 같습니다:fn:
함수 이름 공간의 URI는 다음과 같습니다:http://www.w3.org/2005/xpath-functions
추천:보통 사용 fn:
접두사를 사용하여 함수를 호출하면 예를 들어 fn:string()
하지만, fn:
이 이름 공간의 기본 전사는 따라서 함수 이름에 전사를 추가하지 않아도 됩니다.
접근 함수
이름 | 설명 |
---|---|
fn:node-name(node) | 매개변수 노드의 노드 이름을 반환합니다. |
fn:nilled(node) | 매개변수 노드를 거부하는지 여부를 반환하는 불리언 값을 반환합니다. |
fn:data(item.item,...) | 요소 시퀀스를 받아들여서 원자 값 시퀀스를 반환합니다. |
|
현재 노드 또는 지정된 노드의 base-uri 속성 값을 반환합니다. |
fn:document-uri(node) | 지정된 노드의 document-uri 속성 값을 반환합니다. |
에러와 추적 함수
이름 | 설명 |
---|---|
|
예제: error(fn:QName('http://example.com/test', 'err:toohigh'), 'Error: Price is too high') 결과: 외부 처리 환경에 http://example.com/test#toohigh 및 문자열 "Error: Price is too high"을 반환합니다. |
fn:trace(value,label) | 쿼리를 디버그하기 위해 사용됩니다. |
숫자와 관련된 함수
이름 | 설명 |
---|---|
fn:number(arg) |
전달된 매개변수의 값을 반환합니다. 매개변수는 불리언 값, 문자열 또는 노드 집합일 수 있습니다. 예제: number('100') 결과: 100 |
fn:abs(num) |
인수의 절대 값을 반환합니다。 예제: abs(3.14) 결과: 3.14 예제: abs(-3.14) 결과: 3.14 |
fn:ceiling(num) |
인수 num에 대한 가장 작은 정수를 반환합니다. 예제: ceiling(3.14) 결과: 4 |
fn:floor(num) |
인수 num에 대한 가장 큰 정수를 반환합니다. 예제: floor(3.14) 结果:3 |
fn:round(num) |
num 인수를 가장 가까운 정수로 둥글립니다。 예제: round(3.14) 结果:3 |
fn:round-half-to-even() |
예제: round-half-to-even(0.5) 결과: 0 예제: round-half-to-even(1.5) 结果:2 예제: round-half-to-even(2.5) 结果:2 |
문자열 함수에 관한 내용
이름 | 설명 |
---|---|
fn:string(arg) |
인수의 문자열 값을 반환합니다. 인수는 숫자, 논리 값 또는 노드 셋일 수 있습니다。 예제: string(314) 결과: "314" |
fn:codepoints-to-string(int,int,...) |
코드 포인트 시퀀스를 문자열로 반환합니다。 예제: codepoints-to-string(84, 104, 233, 114, 232, 115, 101) 결과: 'Thérèse' |
fn:string-to-codepoints(string) |
문자열을 코드 포인트 시퀀스로 반환합니다。 예제: string-to-codepoints("Thérèse") 결과: 84, 104, 233, 114, 232, 115, 101 |
fn:codepoint-equal(comp1,comp2) | Unicode 코드 포인트 대조에 따라, comp1의 값이 comp2의 값과 같으면 true를 반환합니다. (http://www.w3.org/2005/02/xpath-functions/collation/codepoint),아니면 false를 반환합니다。 |
|
만약 comp1이 comp2보다 작으면 -1을 반환합니다. comp1이 comp2와 같으면 0을 반환합니다. comp1이 comp2보다 크면 1을 반환합니다。(사용하는 대조 규칙에 따라)。 예시: compare('ghi', 'ghi') 결과: 0 |
fn:concat(string,string,...) |
문자열을 연결합니다. 예시: concat('XPath ','is ','FUN!') 결과: 'XPath is FUN!' |
fn:string-join((string,string,...),sep) |
sep 매개변수를 사용하여 string 매개변수를 연결한 문자열을 반환합니다. 예시: string-join(('We', 'are', 'having', 'fun!'), ' ') 결과: ' We are having fun! ' 예시: string-join(('We', 'are', 'having', 'fun!')) 결과: 'Wearehavingfun!' 예시: string-join((), 'sep') 결과: '' |
|
start 위치에서 시작하는 지정된 길이의 서브 문자열을 반환합니다. 첫 번째 문자의 인덱스는 1입니다. len 매개변수를 생략하면 위치 start에서 문자열의 끝까지의 서브 문자열을 반환합니다. 예시: substring('Beatles',1,4) 결과: 'Beat' 예시: substring('Beatles',2) 결과: 'eatles' |
|
지정된 문자열의 길이를 반환합니다. string 매개변수가 없으면 현재 노드의 문자값의 길이를 반환합니다. 예시: string-length('Beatles') 결과: 7 |
|
지정된 문자열의 시작과 끝의 공백을 제거하고, 내부의 모든 공백 시퀀스를 하나의 공백으로 대체한 후 결과를 반환합니다. string 매개변수가 없으면 현재 노드를 처리합니다. 예시: normalize-space(' The XML ') 결과: 'The XML' |
fn:normalize-unicode() | Unicode 규격화를 수행합니다. |
fn:upper-case(string) |
string 매개변수를 대문자로 변환합니다. 예시: upper-case('The XML') 결과: 'THE XML' |
fn:lower-case(string) |
string 매개변수를 소문자로 변환합니다. 예제: lower-case('The XML') 결과: 'the xml' |
fn:translate(string1,string2,string3) |
string1 중 string2를 string3로 대체합니다. 예제: translate('12:30','30','45') 결과: '12:45' 예제: translate('12:30','03','54') 결과: '12:45' 예제: translate('12:30','0123','abcd') 결과: 'bc:da' |
fn:escape-uri(stringURI,esc-res) |
예제: escape-uri("http://example.com/test#car", true()) 결과: "http%3A%2F%2Fexample.com%2Ftest#car" 예제: escape-uri("http://example.com/test#car", false()) 결과: "http://example.com/test#car" 예제: escape-uri ("http://example.com/~bébé", false()) 결과: "http://example.com/~b%C3%A9b%C3%A9" |
fn:contains(string1,string2) |
string1이 string2를 포함하면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예제: contains('XML','XM') 结果:true |
fn:starts-with(string1,string2) |
string1이 string2로 시작하면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예제: starts-with('XML','X') 结果:true |
fn:ends-with(string1,string2) |
string1이 string2로 끝나면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예제: ends-with('XML','X') 결과:false |
fn:substring-before(string1,string2) |
string1 中 string2 出现之前的子字符串을 반환합니다. 例子:substring-before('12/10','/') 结果:'12' |
fn:substring-after(string1,string2) |
返回 string2 在 string1 中出现之后的子字符串。 例子:substring-after('12/10','/') 结果:'10' |
fn:matches(string,pattern) |
如果 string 参数匹配指定的模式,则返回 true,否则返回 false。 例子:matches("Merano", "ran") 结果:true |
fn:replace(string,pattern,replace) |
把指定的模式替换为 replace 参数,并返回结果。 例子:replace("Bella Italia", "l", "*") 结果:'Be**a Ita*ia' 例子:replace("Bella Italia", "l", "") 结果:'Bea Itaia' |
fn:tokenize(string,pattern) |
例子:tokenize("XPath is fun", "\s+") 结果:("XPath", "is", "fun") |
针对 anyURI 的函数
이름 | 설명 |
---|---|
fn:resolve-uri(relative,base) |
关于布尔值的函数
이름 | 설명 |
---|---|
fn:boolean(arg) | 返回数字、字符串或节点集的布尔值。 |
fn:not(arg) |
首先通过 boolean() 函数把参数还原为一个布尔值。 如果该布尔值为 false,则返回 true,否则返回 true。 例子:not(true()) 결과:false |
fn:true() |
返回布尔值 true。 例子:true() 结果:true |
fn:false() |
返回布尔值 false。 例子:false() 결과:false |
有关持续时间、日期和时间的函数
日期、时间、持续时间的组件提取函数
이름 | 설명 |
---|---|
fn:dateTime(date,time) | 把参数转换为日期和时间。 |
fn:years-from-duration(datetimedur) | 返回参数值的年份部分的整数,以标准词汇表示法来表示。 |
fn:months-from-duration(datetimedur) | 返回参数值的月份部分的整数,以标准词汇表示法来表示。 |
fn:days-from-duration(datetimedur) | 지정된 매개변수의 값의 일 부분의 정수를 표준 단어 표기법으로 표현합니다. |
fn:hours-from-duration(datetimedur) | 지정된 매개변수의 값의 시 부분의 정수를 표준 단어 표기법으로 표현합니다. |
fn:minutes-from-duration(datetimedur) | 지정된 매개변수의 값의 분 부분의 정수를 표준 단어 표기법으로 표현합니다. |
fn:seconds-from-duration(datetimedur) | 지정된 매개변수의 값의 분 부분의 십진수를 표준 단어 표기법으로 표현합니다. |
fn:year-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 연 부분의 정수를 반환합니다. 예시: year-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 결과: 2005 |
fn:month-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 월 부분의 정수를 반환합니다. 예시: month-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 결과: 01 |
fn:day-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 일 부분의 정수를 반환합니다. 예시: day-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 결과: 10 |
fn:hours-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 시 부분의 정수를 반환합니다. 예시: hours-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 결과: 12 |
fn:minutes-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 분 부분의 정수를 반환합니다. 예시: minutes-from-dateTime(xs:dateTime("2005-01-10T12:30-04:10")) 결과: 30 |
fn:seconds-from-dateTime(datetime) |
지정된 매개변수의 로컬 값의 초 부분의 십진수를 반환합니다. 예시: seconds-from-dateTime(xs:dateTime("2005-01-10T12:30:00-04:10")) 결과: 0 |
fn:timezone-from-dateTime(datetime) | 시간대 부분이 존재하면, 파라미터의 시간대 부분을 반환합니다. |
fn:year-from-date(date) |
파라미터의 로컬 값에서 연 부분을 나타내는 정수를 반환합니다. 예제: year-from-date(xs:date("2005-04-23")) 결과: 2005 |
fn:month-from-date(date) |
파라미터의 로컬 값에서 월 부분을 나타내는 정수를 반환합니다. 예제: month-from-date(xs:date("2005-04-23")) 결과: 4 |
fn:day-from-date(date) |
파라미터의 로컬 값에서 날 부분을 나타내는 정수를 반환합니다. 예제: day-from-date(xs:date("2005-04-23")) 결과: 23 |
fn:timezone-from-date(date) | 시간대 부분이 존재하면, 파라미터의 시간대 부분을 반환합니다. |
fn:hours-from-time(time) |
파라미터의 로컬 값에서 시 부분을 나타내는 정수를 반환합니다. 예제: hours-from-time(xs:time("10:22:00")) 결과: 10 |
fn:minutes-from-time(time) |
파라미터의 로컬 값에서 분 부분을 나타내는 정수를 반환합니다. 예제: minutes-from-time(xs:time("10:22:00")) 결과: 22 |
fn:seconds-from-time(time) |
파라미터의 로컬 값에서 초 부분을 나타내는 정수를 반환합니다. 예제: seconds-from-time(xs:time("10:22:00")) 결과: 0 |
fn:timezone-from-time(time) | 시간대 부분이 존재하면, 파라미터의 시간대 부분을 반환합니다. |
fn:adjust-dateTime-to-timezone(datetime,timezone) |
timezone 파라미터가 비어 있으면, 시간대가 없는 dateTime를 반환합니다. 그렇지 않으면, 시간대가 있는 dateTime를 반환합니다. |
fn:adjust-date-to-timezone(date,timezone) |
timezone 파라미터가 비어 있으면, 시간대가 없는 date를 반환합니다. 그렇지 않으면, 시간대가 있는 date를 반환합니다. |
fn:adjust-time-to-timezone(time,timezone) |
timezone 파라미터가 비어 있으면, 시간대가 없는 time을 반환합니다. 그렇지 않으면 시간에 시간대가 포함된 time를 반환합니다. |
QNames와 관련된 함수
이름 | 설명 |
---|---|
fn:QName() | |
fn:local-name-from-QName() | |
fn:namespace-uri-from-QName() | |
fn:namespace-uri-for-prefix() | |
fn:in-scope-prefixes() | |
fn:resolve-QName() |
노드에 대한 함수
이름 | 설명 |
---|---|
|
현재 노드의 이름이나 지정된 노드 집합의 첫 번째 노드를 반환합니다. |
|
현재 노드의 이름이나 지정된 노드 집합의 첫 번째 노드를 이름 공간 프리كس없이 반환합니다. |
|
현재 노드나 지정된 노드 집합의 첫 번째 노드의 이름 공간 URI를 반환합니다. |
fn:lang(lang) |
현재 노드의 언어가 지정된 언어와 일치하면 true를 반환합니다. 예시: Lang("en")는 true입니다. <p xml:lang="en">...</p> 예시: Lang("de")는 false입니다. <p xml:lang="en">...</p> |
|
현재 노드나 지정된 노드가 속한 노드 트리의 루트 노드를 반환합니다. 일반적으로 문서 노드입니다. |
시퀀스에 대한 함수
일반적인 함수
이름 | 설명 |
---|---|
fn:index-of((item,item,...),searchitem) |
searchitem 매개변수와 같은 요소가 시퀀스에 있는 위치를 반환합니다. 예시: index-of ((15, 40, 25, 40, 10), 40) 결과: (2, 4) 예시: index-of (("a", "dog", "and", "a", "duck"), "a") 결과 (1, 4) 예시: index-of ((15, 40, 25, 40, 10), 18) 결과: () |
fn:remove((item,item,...),position) |
item 매개변수로 생성된 새로운 시퀀스를 반환 - position 매개변수로 지정된 위치의 요소를 제거합니다. 예시: remove(("ab", "cd", "ef"), 0) 결과:("ab", "cd", "ef") 예시: remove(("ab", "cd", "ef"), 1) 결과:("cd", "ef") 예시:remove(("ab", "cd", "ef"), 4) 결과:("ab", "cd", "ef") |
fn:empty(item,item,...) |
매개변수 값이 비어있는 시퀀스이면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예시:empty(remove(("ab", "cd"), 1)) 결과:false |
fn:exists(item,item,...) |
매개변수 값이 비어있지 않은 시퀀스가 아니면 true를 반환하고, 그렇지 않으면 false를 반환합니다. 예시:exists(remove(("ab"), 1)) 결과:false |
fn:distinct-values((item,item,...),collation) |
유일한 다른 값들을 반환합니다. 예시: distinct-values((1, 2, 3, 1, 2)) 결과:(1, 2, 3) |
fn:insert-before((item,item,...),pos,inserts) |
item 매개변수로 구성된 새 시퀀스를 반환하며, pos 매개변수가 지정한 위치에 inserts 매개변수의 값을 삽입합니다. 예시: insert-before(("ab", "cd"), 0, "gh") 결과:("gh", "ab", "cd") 예시: insert-before(("ab", "cd"), 1, "gh") 결과:("gh", "ab", "cd") 예시: insert-before(("ab", "cd"), 2, "gh") 결과:("ab", "gh", "cd") 예시: insert-before(("ab", "cd"), 5, "gh") 결과:("ab", "cd", "gh") |
fn:reverse((item,item,...)) |
지정된 아이템의 역순을 반환합니다. 예시: reverse(("ab", "cd", "ef")) 결과:("ef", "cd", "ab") 예시: reverse(("ab")) 결과:("ab") |
fn:subsequence((item,item,...),start,len) |
start 매개변수가 지정한 위치에서 아이템 시퀀스를 반환하고, 시퀀스의 길이는 len 매개변수로 지정됩니다. 첫 번째 항목의 위치는 1입니다. 예시: subsequence(($item1, $item2, $item3,...), 3) 结果:($item3, ...) 例子:subsequence(($item1, $item2, $item3, ...), 2, 2) 结果:($item2, $item3) |
fn:unordered((item,item,...)) | 依据实现决定的顺序来返回项目。 |
测试序列容量的函数
이름 | 설명 |
---|---|
fn:zero-or-one(item,item,...) | 如果参数包含零个或一个项目,则返回参数,否则生成错误。 |
fn:one-or-more(item,item,...) | 如果参数包含一个或多个项目,则返回参数,否则生成错误。 |
fn:exactly-one(item,item,...) | 如果参数包含一个项目,则返回参数,否则生成错误。 |
Equals, Union, Intersection and Except
이름 | 설명 |
---|---|
fn:deep-equal(param1,param2,collation) | 如果 param1 和 param2 与彼此相等(deep-equal),则返回 true,否则返回 false。 |
合计函数
이름 | 설명 |
---|---|
fn:count((item,item,...)) | 返回节点的数量。 |
fn:avg((arg,arg,...)) |
返回参数值的平均数。 例子:avg((1,2,3)) 结果:2 |
fn:max((arg,arg,...)) |
返回大于其它参数的参数。 例子:max((1,2,3)) 结果:3 例子:max(('a', 'k')) 结果:'k' |
fn:min((arg,arg,...)) |
返回小于其它参数的参数。 例子:min((1,2,3)) 结果:1 例子:min(('a', 'k')) 结果:'a' |
fn:sum(arg,arg,...) | 返回指定节点集中每个节点的数值的总和。 |
生成序列的函数
이름 | 설명 |
---|---|
fn:id((string,string,...),node) | 返回元素节点序列,这些节点的 ID 值等于 string 参数中指定的一个或多个值。 |
fn:idref((string,string,...),node) | 返回元素或属性节点序列,这些节点的 IDREF 值等于 string 参数中指定的一个或多个值。 |
fn:doc(URI) | |
fn:doc-available(URI) | doc() 함수가 문서 노드를 반환하면 true를 반환하고, 그렇지 않으면 false를 반환합니다. |
|
컨텍스트 함수
이름 | 설명 |
---|---|
fn:position() |
현재 처리되고 있는 노드의 index 위치를 반환합니다. 예: //book[position()<=3] 결과: 첫 세 개의 book 요소를 선택합니다 |
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를 반환합니다. |