PX_PUT_RECORDN(3)

💾 PX_put_recordn — bestie, we're filing your record in a Paradox file at a very specific spot 💅

okay so picture this: it's PX_put_recordn(3), from the Library Functions Manual, and it is literally the girl who knows exactly where every record belongs. Not "somewhere near the end", not "wherever there's space" — a specific position, bestie. she has a seating chart. she's got main character energy and the seating chart is her personality. ✨

🌸 SYNOPSIS 🌸

#include <paradox.h>

int PX_put_recordn(pxdoc_t *pxdoc, char *data, int recpos)

🎀 DESCRIPTION 🎀

So here's the tea: this function stores a record from the buffer data into a Paradox file, and it drops it at the given position recpos. And the very first position is number 0, not 1, because of course it is. Programmers love starting at zero. iykyk. 🙈

The function will figure out the data block for this record all by itself. no hand-holding needed, she's independent. 💅

Now, the spicy part. If the position you asked for is after the last data block? Then as many empty data blocks as needed get added. As many as needed. She'll build the whole neighborhood just to give your record a house. 🏠✨

But wait, there's more. If the position lands in the middle of a data block and there's no record right before that position, then the position gets recalculated so the new record lands in the first free slot of the datablock. She's not gonna leave a lil gap in the seating chart, that's not the vibe.

Example time, because honestly this one needs it: let's say a datablock contains H records, and the first call of PX_put_recordn wants to store a record at position 11. Guess what — that gets corrected to position H. PX_put_recordn will also add an empty data block and store the record as the first record of the second data block. boom. 🫶

And then — and this is the part that lowkey sends me — storing a second record at position 11 again will be executed without any position change. She remembered. She always remembers. 👑

One thing though, no cap: data must be constructed with the PX_put_data_xxx(3) functions beforehand. It has the same structure as the record returned by PX_get_record(3) and PX_get_record2(3). Don't just show up with raw data and expect her to make it work — that's not giving prepared. 😭

⭐ RETURN VALUE ⭐

Returns the record position on success, and -1 on failure. And yeah, we said it before but we're saying it again because it matters: the first position has number 0. periodt. 💖

🦋 SEE ALSO 🦋

• PX_get_record(3)
• PX_get_record2(3)
• PX_put_record(3)
• PX_put_data_byte(3)
• PX_put_data_short(3)
• PX_put_data_long(3)
• PX_put_data_double(3)
• PX_put_data_alpha(3)

🌈 AUTHOR 🌈

This manual page was written by Uwe Steinmann uwe@steinmann.cx. iconic of him honestly, we love a documentation king. 👑

and that's the whole page bestie!! this lil legend lives in the Library Functions Manual as PX_PUT_RECORDN(3), and this version of it is dated... okay well, the original footer date didn't survive the vibe check, but the manual name and source line are PX_PUT_RECORDN(3) from the Library Functions Manual, so jot that down. mwah 💋✨💖