XPath, XQuery 및 XSLT 함수

접근 함수

이름 설명
fn:node-name(node) 파라미터 노드의 노드 이름을 반환합니다.
fn:nilled(node) 파라미터 노드를 거부하는지 여부를 반환하는 불리언 값을 반환합니다.
fn:data(item.item,...) 항목 시퀀스를 받아들여서 원자 값 시퀀스를 반환합니다.
  • fn:base-uri()
  • fn:base-uri(node)
현재 노드 또는 지정된 노드의 base-uri 속성 값을 반환합니다.
fn:document-uri(node) 지정된 노드의 document-uri 속성 값을 반환합니다.

에러 및 추적 함수

이름 설명
  • fn:error()
  • fn:error(error)
  • fn:error(error,description)
  • fn:error(error,description,error-object)

예제: 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를 반환합니다。
  • fn:compare(comp1,comp2)
  • fn:compare(comp1,comp2,collation)

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')

결과: ''

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

start 위치에서 시작하는 지정된 길이의 서브스트링을 반환합니다. 첫 번째 문자의 인덱스는 1입니다. len 파라미터를 생략하면 위치 start에서 문자열의 끝까지의 서브스트링을 반환합니다。

예제: substring('Beatles', 1, 4)

결과: 'Beat'

예제: substring('Beatles', 2)

결과: 'eatles'

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

지정된 문자열의 길이를 반환합니다. string 파라미터가 없으면 현재 노드의 문자값의 길이를 반환합니다。

예제: string-length('Beatles')

결과: 7

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

지정된 문자열의 시작과 끝의 공백을 제거하고, 내부의 모든 공백 시퀀스를 하나의 공백으로 대체한 후 결과를 반환합니다. 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)

string1에서 string2가 나타나는 이후의 서브 문자열을 반환합니다.

例子: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 매개변수가 비어 있으면 시간대가 없는 날짜를 반환합니다. 그렇지 않으면 시간대가 있는 날짜를 반환합니다.
fn:adjust-time-to-timezone(time,timezone) timezone 매개변수가 비어 있으면 시간대가 없는 시간을 반환합니다. 그렇지 않으면 시간대가 있는 시간을 반환합니다.

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()  

노드에 대한 함수

이름 설명
  • fn:name()
  • fn:name(nodeset)
현재 노드의 이름이나 지정된 노드 집합의 첫 번째 노드의 이름을 반환합니다.
  • fn:local-name()
  • fn:local-name(nodeset)
현재 노드의 이름이나 지정된 노드 집합의 첫 번째 노드의 이름을 이름 공간 프리كس 없이 반환합니다.
  • fn:namespace-uri()
  • fn:namespace-uri(nodeset)
현재 노드나 지정된 노드 집합의 첫 번째 노드의 이름 공간 URI를 반환합니다.
fn:lang(lang)

현재 노드의 언어가 지정된 언어와 일치하면 true를 반환합니다.

예제: Lang("en") is true for <p xml:lang="en">...</p>

예제: Lang("de") is false for <p xml:lang="en">...</p>

  • fn:root()
  • fn:root(node)
현재 노드나 지정된 노드가 속한 노드 트리의 뿌리 노드를 반환합니다. 일반적으로 문서 노드입니다.

시퀀스에 대한 함수

일반적인 함수

이름 설명
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,...) 매개변수가 zero개나 하나의 항목을 포함하면 매개변수를 반환하고, 그렇지 않으면 오류를 생성합니다.
fn:one-or-more(아이템, 아이템, ...) 매개변수가 하나나 여러 항목을 포함하면 매개변수를 반환하고, 그렇지 않으면 오류를 생성합니다.
fn:exactly-one(아이템, 아이템, ...) 매개변수가 하나의 항목을 포함하면 매개변수를 반환하고, 그렇지 않으면 오류를 생성합니다.

Equals, Union, Intersection 및 Except

이름 설명
fn:deep-equal(param1, param2, collation) param1과 param2가 서로 deep-equal이면 true를 반환하고, 그렇지 않으면 false를 반환합니다.

합계 함수

이름 설명
fn:count((아이템, 아이템, ...)) 노드의 개수를 반환합니다.
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((문자, 문자, ...), 노드) 문자 인자의 값과 일치하는 ID 값이 있는 요소 노드의 시퀀스를 반환합니다.
fn:idref((문자, 문자, ...), 노드) 문자 인자의 값과 일치하는 IDREF 값이 있는 요소나 속성 노드의 시퀀스를 반환합니다.
fn:doc(URI)  
fn:doc-available(URI) doc() 함수가 문서 노드를 반환하면 true를 반환하며, 그렇지 않으면 false를 반환합니다.
  • fn:collection()
  • fn:collection(string)
 

컨텍스트 함수

이름 설명
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의 값을 반환합니다.