HANDLE_LIST 函數會用搜尋引數來搜尋文字文件, 並且會傳回 DB2TEXTHLISTP 或 DB2TEXTFHLISTP 類型的值, 以指向所找到之文件的 handle 列示。
註: | 只有在使用此函數之 SQL 陳述式的範圍內,才能存取指向此列示的指標。 |
如果找不到含有該搜尋術語的文字文件,則 handle 列示會是空白的。 請使用 NO_OF_DOCUMENTS 函數來查看該列示是否為空白的。
如果您要搜尋儲存在基本表格之直欄中的文字,請使用此函數 (每一陳述式限用一次)。 如果您要搜尋儲存在概略表的直欄中的文字,而該概略表是由一個以上的基本表格所組成 (意即,其為聯合 (union) 概略表),請針對每一個 handle 直欄, 使用一個 handle,以作為 HANDLE_LIST 函數的 handle 輸入引數。
要訣 |
---|
此功能是 DB2 Text Extender 舊版的特性。 基於相容性理由,新版中繼續支援此函數。 但其功能已被 SEARCH_RESULT 搜尋函數所取代。 |
函數語法
>>-HANDLE_LIST---(--handle--,--search-argument----)------------><
函數參數