# SPI_returntuple ## Name SPI_returntuple?--?準備把一個行當作 Datum 返回 ## Synopsis ``` HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc) ``` ## 描述 `SPI_returntuple`在上層執行者環境里制作一個行的拷貝， 并且把它以行類型`Datum`的形式返回。 所返回的指針在返回之前只需要用`PointerGetDatum`轉換成`Datum`。 請注意這個函數應該只用于那些聲明為返回復合類型的函數。它不用于觸發器； 用`SPI_copytuple`在觸發器中返回一個修改過的行。 ## 參數 `HeapTuple` `row` 將要被拷貝的行 `TupleDesc` `rowdesc` 行的描述符(每次都傳遞同樣的描述符可以獲取最高緩沖效率) ## 返回值 指向拷貝出來的行的`HeapTupleHeader`；只有在`row` 或`rowdesc`是`NULL`的時候才返回`NULL`