PX_PUT_DATA_DOUBLE(3)

📦 version 0.6.10, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PX_put_data_double — put value into a double data field 💖

okay bestie, gather round, because this one is short but it is important. it's a page from the Library Functions Manual (section 3, the library-functions girlies 🎀), and it's all about dropping a double into a data field the way the database file actually stores it. no cap.

✨ SYNOPSIS ✨

#include <paradox.h>

void PX_put_data_double(pxdoc_t *pxdoc, char *data, int len, double value)

like, that's the whole vibe. void return, four args, she does her job and she does not report back. queen behavior. 👑

🌸 DESCRIPTION 🌸

okay so here's the tea. PX_put_data_double converts a double into a value for a data field as it stored in the database file. that's the whole assignment. she takes your nice clean double and turns it into the bytes-on-disk representation that the database file expects. 💅

bestie, listen: you should use this function instead of accessing the record data directly. do not go poking around in the raw record buffer like you're the main character. use the function. it's literally right there. 🙈

now, about data — she points to the start of the data field in the record. and here's the part everyone gets wrong: you do not just hand her the record pointer and hope for the best. you have to calculate it by summing up all field length before the field to operate on, and then add it to the base pointer of the record. so like:

  • sum up every field length that comes before the field you're targeting ✨
  • add that sum to the base pointer of the record 🦋
  • that is your data 🌸

get that math wrong and you're writing your double into somebody else's field. it's giving chaos. it's giving corrupted records. don't do that to yourself. 😭

🦋 SEE ALSO 🦋

her sisters, her siblings, the whole friend group:

👑 AUTHOR 👑

This manual page was written by Uwe Steinmann uwe@steinmann.cx. thank you Uwe, we appreciate you fr fr 🫶

and that's the whole page, bestie!! this one came from the Library Functions Manual, section 3, under the name PX_put_data_double — and ngl the footer didn't hand us a date or a version to shout out, so just know she's out here doing her little double-writing thing, iconic as ever. slay, stay safe, and always compute that offset. periodt. 💖✨🎀

📦 where this page comes from