2025年9月25日: PostgreSQL 18 釋出!
支援的版本: 當前 (18) / 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

提交更正

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