allowmissing (預設值 no)

線上編輯

allowmissing 選項用於 DATA-INTO 和 XML-INTO。

對於文件對於 RPG 資料結構的子欄位沒有足夠項目的狀況，您可以使用 allowmissing 選項來指出這是否視為錯誤。 在下列情況下，資料會被視為遺漏:
  • 對於符合 RPG 資料結構的項目 (包括資料結構子欄位) ，如果文件中的項目沒有所有 RPG 子欄位的子項目。
  • 對於符合 RPG 資料結構之陣列子欄位的資料，如果文件中的項目數小於 RPG 子欄位陣列的維度。

如果找不到預期資料，且未指定 'allowmissing = yes' ，則作業會失敗，狀態為 00353 (XML 不符合 RPG 變數) 或狀態為 00356 (DATA-INTO 的文件不符合 RPG 變數)。

提示: countprefix 選項也可以用來處理文件對於資料結構中每個子欄位可能沒有足夠資料的狀況。

若要容許 XML-INTO 或 DATA-INTO 作業上所指定陣列的陣列元素較少，則不需要指定 'allowmissing = yes'。 如果文件包含的元素少於 RPG 陣列，則作業不會失敗。 可以使用 PSDS 位置 372-379 中的「元素數」子欄位來決定作業順利設定的元素數。

  • no 指出資料結構的每個子欄位 (包括資料結構子欄位的子欄位) 都必須呈現資料，且每個子欄位陣列的每個元素都必須呈現資料。
  • yes 指出當每一個子欄位和子欄位陣列元素沒有資料時，作業不會失敗。 如果變數指定為 XML-INTO 或 DATA-INTO 的第一個運算元，則未設定的子欄位將保留它們在作業之前保留的相同值。 如果 %HANDLER 指定為 XML-INTO 或 DATA-INTO 的第一個運算元，則傳遞至處理程序之陣列的未設定子欄位將具有類型的預設值 (數值為零，日期值為 *LOVAL 等)。