pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
SPI_returntuple — 准备把一个元组返回为一个 Datum
HeapTupleHeader SPI_returntuple(HeapTuplerow, TupleDescrowdesc)
SPI_returntuple 在上层执行器上下文中创建一行的副本,并以行类型 Datum 的形式返回。返回的指针只需在返回前用 PointerGetDatum 转换为 Datum 即可。
此函数只能在连接到 SPI 时使用。否则,它会返回 NULL,并将 SPI_result 设为 SPI_ERROR_UNCONNECTED。
请注意,它应用于声明为返回复合类型的函数,而不用于触发器;触发器中返回修改后的行应使用 SPI_copytuple。
HeapTuple row要复制的行
TupleDesc rowdesc行描述符(若要获得最佳缓存效果,每次都传入同一个描述符)
指向复制后行的 HeapTupleHeader;出错时返回 NULL(错误指示见 SPI_result)
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。