PX_DELETE_RECORD(3)

💖 PX_DELETE_RECORD(3) 💖

okay bestie, so this is a page from the Library Functions Manual, and it's all about PX_delete_record — the little function that says "bye bye" to a record in a Paradox file. no cap. 🦋

🌸 NAME 🌸

PX_delete_record — removes a record from a Paradox file 💅

✨ SYNOPSIS ✨

#include <paradox.h>

int PX_delete_record(pxdoc_t *pxdoc, int recpos)

🎀 DESCRIPTION 🎀

okay so listen. This one deletes the record with number recpos from the Paradox file. and here's the thing — the first record has number 0. so we're zero-indexed around here, that's just the vibe. 👑

The data of that record gets wiped out, like, gone gone. it becomes literally impossible to reconstruct it later. so if you delete it, that's your final answer, no takebacks, periodt. 💀

After that, the data block where the record used to live gets reconstructed, so that all the records sit nice and tidy at the beginning of the data block, followed by the free space. it's giving "cleaning up your room before your mom comes in" energy. ✨

And a cute little follow-up: calls to PX_insert_record(3) will use the first datablock with free space and add the new record after the records in the data block. so the freed space does get recycled, iykyk. 🫶

🔥 RETURN VALUE 🔥

Returns 0 on success or -1 on failure. that's it, that's the whole vibe check. 😌

💜 SEE ALSO 💜

• PX_retrieve_record(3)
• PX_insert_record(3)
• PX_update_record(3)

🌈 AUTHOR 🌈

This manual page was written by Uwe Steinmann uwe@steinmann.cx. thank you for your service king 👑

so yeah, that's PX_delete_record(3) — a page from the Library Functions Manual. take care of your records bestie, deleting is forever 💖