Комментарии
Комментарии допускаются в прологе и в теле запроса. Комментарии не влияют на обработку запроса.
Комментарий состоит из строки, которая ограничена символами (: и :). Следующие примеры являются комментариями в XQuery:
(: A comment. You can use comments to make your code easier to understand. :)
Следующие общие правила применимы к использованию комментариев в XQuery DB2:
- Комментарии могут использоваться там, где разрешаются пробельные символы. Игнорируемый пробельный символ - это пробельный символ, который не влияет на результаты выражения.
- Комментарии не допускаются в содержимом конструктора.
- Комментарии могут вкладываться один в другой, но каждый вложенный комментарий должен иметь открывающий и закрывающий ограничители,
(: и :).
Следующие примеры иллюстрируют правильные комментарии и комментарии, которые приводят к ошибкам:
(: 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 (:" :) приведет к ошибке. Содержимое литерала может привести к несбалансированным вложенным комментариям.