支援的版本:目前 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本:12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

SPI_returntuple

SPI_returntuple — 準備將一個元組作為 Datum 傳回

概要

HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

描述

SPI_returntuple 在上層執行器上下文中建立一列的副本,並以列類型 Datum 的形式傳回它。傳回的指標只需在使用前透過 PointerGetDatum 轉換為 Datum 即可傳回。

只有在連接到 SPI 時才能使用此函式。 否則,它會傳回 NULL 並將 SPI_result 設定為 SPI_ERROR_UNCONNECTED

請注意,這應該用於宣告為傳回複合型別的函式。 它不用於觸發器;使用 SPI_copytuple 在觸發器中傳回修改後的列。

引數

HeapTuple row

要複製的列

TupleDesc rowdesc

列的描述符(為了獲得最有效的快取效果,每次都傳遞相同的描述符)

傳回值

指向複製列的 HeapTupleHeader,如果發生錯誤則傳回 NULL(請參閱 SPI_result 以獲取錯誤指示)

提交更正

如果您在文件中發現任何不正確、與您使用特定功能的經驗不符或需要進一步澄清的地方,請使用此表單來報告文件問題。