SPI_FREETUPLE(3)

πŸ“¦ version 17.11, in opensuse-leap 16.0

πŸ’… SPI_FREETUPLE(3) πŸ’…

okay so bestie, welcome to the SPI_freetuple page β€” it's a PostgreSQL 17.11 manual page and honestly it's a short one, but we're gonna give it the main character energy it deserves ✨


🌸 NAME 🌸

SPI_freetuple β€” free a row allocated in the upper executor context πŸŽ€


✨ SYNOPSIS ✨

void SPI_freetuple(HeapTuple row)

that's it. that's the whole signature. one function, one argument, zero drama πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so like, SPI_freetuple frees a row that was previously allocated in the upper executor context. you allocated it up there, you clean it up from up there. balance. symmetry. the circle of life fr fr 🌈

and here's the tea β˜• β€” this function is no longer different from plain heap_freetuple. like, at all. it's literally the same thing wearing a different name tag πŸ™ˆ

it's kept just for backward compatibility of existing code. so if you see it out in the wild, it's not doing anything special, it's just being iconic for the sake of not breaking your old code. slay, honestly πŸ‘‘

lowkey important: don't go thinking it does extra stuff. it doesn't. it's a legacy icon and we respect it 🫢

πŸŽ€ ARGUMENTS πŸŽ€

  • HeapTuple row β€” the row to free 🧚

that's the whole list. one argument. she's simple, she's efficient, she ate πŸ’–


⭐ the cute sign-off ⭐

this page is from PostgreSQL 17.11, dated 2026 β€” documented with love, shipped with the rest of the manual, and now lovingly re-explained by your favorite Unix bestie πŸ’œ

go free those tuples, bestie. responsibly. 😭πŸ”₯


πŸ“¦ where this page comes from