SPI_cursor_find

SPI_cursor_find — encontra um cursor existente pelo nome

Sinopse

Portal SPI_cursor_find(const char * name)

Descrição

A função SPI_cursor_find encontra um portal existente pelo nome. Serve, principalmente, para resolver um nome de cursor retornado como texto por alguma outra função.

Argumentos

const char * name

nome do portal

Valor retornado

ponteiro para o portal com o nome especificado, ou NULL se nenhum foi encontrado

Notas

Deve-se tomar cuidado, porque esta função pode retornar um objeto Portal que não possui propriedades semelhantes a um cursor; por exemplo, pode não retornar tuplas. Se for simplesmente passado o ponteiro Portal para outras funções SPI, elas poderão se defender contra estes casos, mas é apropriado ter cautela ao inspecionar diretamente o Portal.