xpath()

XML 문자열에서 XPath 표현식에 일치하는 노드를 추출하여 반환합니다.

문법

xpath(XML_EXPR, PATH_EXPR)

매개변수

XML_EXPR
파싱할 XML 문자열 또는 식.
PATH_EXPR
추출 대상을 지정하는 XPath 표현식 문자열.

설명

xpath() 함수는 XML_EXPR을 XML 문서로 파싱하고 PATH_EXPR로 노드를 조회하여 반환합니다. 인수 중 하나라도 null이면 null을 반환합니다. XML 파싱 또는 XPath 평가에 실패하면 null을 반환합니다.

일치하는 노드가 정확히 하나이면 해당 노드의 값을 단일 값으로 반환합니다. 일치하는 노드가 둘 이상이면 노드 값을 순서대로 담은 리스트를 반환합니다.

오류 코드

해당 사항 없음

사용 예

  1. 단일 노드 추출

    json "{'xml': '<root><name>alice</name></root>'}" | eval result = xpath(xml, "/root/name")
    | # result: "alice"
    
  2. 여러 노드 추출

    json "{'xml': '<root><item>a</item><item>b</item></root>'}" | eval result = xpath(xml, "/root/item")
    | # result: ["a","b"]
    
  3. NULL 입력

    json "{'xml': null}" | eval result = xpath(xml, "/root/name")
    | # result: null
    

호환성

xpath() 함수는 소나 4.0 이전 버전부터 제공되었습니다.