SPI_cursor_find <refpurpose>find an existing cursor by name</refpurpose> — 既存のカーソルを名前で検索する
Portal SPI_cursor_find(const char * name
)
<function>SPI_cursor_find</function> finds an existing portal by
name. This is primarily useful to resolve a cursor name returned
as text by some other function.
SPI_cursor_find
は既存のカーソルを名前で検索します。
これは主に、他の何らかの関数でテキストとして返されたカーソル名の名前解決の際に使用されます。
const char * name
name of the portal ポータルの名前
pointer to the portal with the specified name, or
<symbol>NULL</symbol> if none was found
指定された名前のポータルへのポインタ。見つからない場合はNULL
です。
Beware that this function can return a <type>Portal</type> object
that does not have cursor-like properties; for example it might not
return tuples. If you simply pass the <type>Portal</type> pointer
to other SPI functions, they can defend themselves against such
cases, but caution is appropriate when directly inspecting
the <type>Portal</type>.
この関数は、カーソルのようなプロパティを持たないPortal
オブジェクトを返す可能性があることに注意してください。例えば、タプルを返さない場合があります。
Portal
ポインタを他のSPI関数に渡すだけであれば、そのような場合から身を守ることができますが、Portal
を直接検査する場合には注意が必要です。