allowextra (缺省值 no)

在线编辑

allowextra 选项用于 DATA-GEN ， DATA-INTO 和 XML-INTO。

对于文档具有分配给 RPG 数据结构的子字段所不需要的数据的情况，可以使用 allowextra 选项来指示是否将此视为错误。 在以下情况下，数据被视为额外数据:
  • 对于与 RPG 数据结构匹配的数据，如果找到非空格文本内容。
  • 对于与 RPG 数据结构的数组子字段匹配的数据，如果文档中的项数大于 RPG 子字段数组的维数。
  • 对于与 RPG 标量变量 (既不是数据结构也不是未建立索引的数组) 匹配的数据，如果项包含子项，那么 XML-INTO 操作的某些数据类型所允许的特殊格式化属性除外 (请参阅 用于将数据传输到 XML-INTO 和 DATA-INTO 的 RPG 变量的规则)。

如果找到意外数据，并且未指定 "allowextra = yes" ，那么操作将失败，状态为 00353 (XML 与 RPG 变量不匹配) 或 00356 (DATA-INTO 的文档与 RPG 变量不匹配)。

警告: 在任何时候，对于 XML-INTO 操作，非数据结构 XML 元素元素的 XML 属性都可能受到 RPG 运行时的解释。 目前， RPG 运行时已对某些目标数据类型解释 "fmt" 和 "调整"。 可以随时添加对其他属性的支持，甚至可以通过 PTF。 如果某个属性被选项 "allowextra = yes" 忽略，并且该属性对于 RPG 运行时变得有意义，那么它可能会影响数据的处理。

  • no 指示文档中用于设置 RPG 变量或数组元素的项必须仅包含设置该变量所需的数据。
  • yes 指示将忽略文档中的其他数据。