Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender Administración y programación

HANDLE_LIST

La función HANDLE_LIST busca documentos de texto utilizando un argumento de búsqueda y devuelve un valor de tipo DB2TEXTHLISTP o DB2TEXTFHLISTP que apunta a una lista de descriptores de contexto para los documentos encontrados.
Nota:Sólo se puede acceder al puntero para esta lista desde el ámbito de la sentencia de SQL que utiliza esta función.

Si no se encuentran documentos que contengan el término o los términos de búsqueda, la lista de descriptores de contexto está vacía. Utilice la función NO_OF_DOCUMENTS para averiguar si la lista está vacía.

Si busca texto almacenado en una columna de una tabla base, utilice esta función sólo una vez por sentencia. Si busca texto almacenado en una columna de una vista y la vista se ha creado a partir de más de una tabla base (es decir, es una vista de uniones), utilice un descriptor de contexto para cada columna de descriptores de contexto como argumento de entrada de descriptor-contexto para la función HANDLE_LIST.
Consejo

Esta función es una característica de un release anterior de DB2 Text Extender. Se sigue soportando por razones de compatibilidad. Su funcionalidad se ha sustituido por la función de búsqueda SEARCH_RESULT.

Sintaxis de la función

>>-HANDLE_LIST-------------------------------------------------->
 
>----(--descriptor-contexto--,--argumento-búsqueda----)--------><
 

Parámetros de la función

descriptor-contexto
Una expresión cuyo resultado es un valor de tipo DB2TEXTH o DB2TEXTFH. Normalmente, es la columna de descriptores de contexto que contiene los descriptores de contexto de los documentos de texto que se han de buscar. También puede ser un descriptor de contexto prototipo extraído de la vista del catálogo TEXTCOLUMNS.

argumento-búsqueda
Una serie de tipo LONG VARCHAR que contiene los términos que se han de buscar. Consulte el apartado Capítulo 12, Sintaxis de los argumentos de búsqueda.


[ Principio de página | Página anterior | Página siguiente | Contenido | Índice ]