%XML(xmlDocument {:options})
%XML은 분석할 XML 문서와 문서 분석 방법을 제어하는 옵션을 지정하는 XML-SAX 및 XML-INTO OP 코드의 두 번째 피연산자로서 사용됩니다. %XML은 값을 리턴하지 않으며 XML-SAX 및 XML-INTO OP 코드의 경우 다른 위치에서는 지정될 수 없습니다.
첫 번째 피연산자는 분석할 문서를 지정합니다. 이는 XML 문서나 XML 문서를 포함하는 파일명을 포함하는 상수, 변수 문자 또는 UCS-2 표현식이 될 수 있습니다.
두 번째 피연산자는 XML 문서를 해석하고 분석하는 방법을 제어하는 옵션을 지정합니다.
이는 상수 또는 변수 문자 표현식이 될 수 있습니다. 문자 표현식의 값은 양식에서 지정된
0 또는 더 많은 옵션의 리스트입니다.
optionname1=value1 optionname2=value2옵션명과 등호 사이 또는 등호와 값 사이에서는 공백을 입력할 수
없습니다. 그러나 옵션 앞, 뒤 또는 사이에는 공백이 표시될 수 있습니다. 옵션은 대소문자에 관계없이 지정할 수
있습니다. 다음은 XML-INTO에 대해 "doc=file" 및 "allowextra=yes" 옵션을 지정하는 유효한 모든
방법입니다.
'doc=file allowextra=yes'
' doc=file allowextra=yes '
'ALLOWEXTRA=YES DOC=FILE '
'AllowExtra=Yes Doc=File '다음은 유효하지 않은 옵션 스트링입니다.
| 옵션 스트링 | 옵션 스트링 문제점 |
|---|---|
| 'doc = file' | 등호 부호 주위에는 공백이 허용되지 않습니다. |
| 'allowextra' | 각 옵션에는 등호와 값이 있어야 합니다. |
| 'badopt=yes' | 유효한 옵션만 허용됩니다. |
| 'allowextra=ok' | 'allowextra' 값은 'yes' 또는 'no'만 될 수 있습니다. |
유효한 옵션과 값은 %XML 내장 기능의 컨텍스트를 기반으로 합니다. 유효한 옵션 및 값의 전체 목록은 XML-SAX(XML 문서 분석) 및 XML-INTO(변수로 XML 문서 분석)의 내용을 참조하십시오.
옵션이 두 번 이상 지정되면, 마지막으로 지정되는 값이 사용되는 값입니다.
예를 들어 옵션 매개변수에
'doc=file doc=string'구문 분석기가 유효하지 않은 옵션이나 유효하지 않은 값을 검색하면, 조작은 상태 코드 00352로 실패합니다.
그림 1. %XML 예
// The "options" parameter is omitted. Default values are used for
// all options. Since the default value for the "doc" option is
// always "string", the parser will correctly assume that the first
// parameter contains an XML document.
xmldocument = '<myfld>new value</myfld>';
XML-INTO myfld %XML(xmldocument);
// The "options" parameter is specified as a literal with two options.
XML-INTO myds %XML(xmldocument : 'allowmissing=yes allowextra=yes');
// The "options" parameter is specified as a variable expression
// with two options.
ccsidOpt = 'ccsid=' + %char(ccsid);
XML-SAX %HANDLER(mySaxHandler : myCommArea)
%XML('myinfo.xml' : 'doc=file ' + ccsidOpt);%XML의 더 많은 예는 XML-SAX(XML 문서 분석) 및 XML-INTO(변수로 XML 문서 분석)의 내용을 참조하십시오.