XQuery のコメント
XQuery 式では、コメントは、不要な空白文字が許可されるいずれの場所でも使用できます。コメントは、式の処理には影響しません。
コメントは、記号 (: および :) で区切られたストリングです。
以下に、XQuery におけるコメントの例を示します。
(: This is a comment. It makes code easier to understand. :)
XQuery におけるコメントの使用には、以下のような汎用規則が適用されます。
- コメントは、不要な空白文字が許可されるいずれの場所でも使用できます。不要な空白文字 とは、XQuery 式の構文の一部ではない空白文字です。
- コメント同士はネスト可能ですが、ネストされたコメントは、左右を区切り文字 (: および :) で囲む必要があります。
以下は、正しいコメントの例、およびエラーになるコメントの例です。
- (: is this a comment? ::) は、正しいコメントです。
- (: is this a comment? ::) or an error? :) は、エラーになります。原因は、記号 (: および :) のネストが対になっていないためです。
- (: commenting out a (: comment :) may be confusing, but often helpful :) は、 正しいコメントです。コメントのネストが正しく対になっていれば、コメントはネストできます。
- "this is just a string :)" は正しい式です。
- (: "this is just a string :)" :) は、構文エラーになります。 同様に、"this is another string (:" は正しい式ですが、 (: "this is another string (:" :) は構文エラーになります。リテラル・コンテンツは、コメントのネストが対でなくても構いません。