PX_GET_DATA_LONG(3)

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

💖 PX_GET_DATA_LONG(3) 💖

okay bestie, sit down, we're doing a manual page from the Library Functions Manual section and it's literally called PX_get_data_long — the "Get long data field" girlie. she's giving old-school Paradox database energy and honestly? iconic. 🎀

✨ NAME ✨

PX_get_data_long — get that long data field, bestie 💅

🌸 SYNOPSIS 🌸

#include <paradox.h>

int PX_get_data_long(pxdoc_t *pxdoc, char *data, int len, long *value)

🦋 DESCRIPTION 🦋

so what she does is: she takes a data field exactly the way it's stored in the database file and converts it into a long integer for whatever host architecture you're on. no cap. and like — you should be using this function instead of poking at the data directly. please. for me. 🫶

data points to the start of the data field inside the record. and this is the part where you have to do math, sorry babe 😭 — it must be calculated by summing up all field length before the field to operate on, and then add it to the base pointer of the record. that's the whole recipe, fr fr.

Note: this function is deprecated and obsolete if PX_retrieve_record(3) is used. like, she's a legacy queen. still valid, still works, but if you're already using PX_retrieve_record(3) she's literally not needed. 💀

👑 RETURN VALUE 👑

  • 0 — if the value is NULL 🫥
  • -1 — in case of an error, noooo 😭
  • 1 — otherwise, slay ✨

🌈 SEE ALSO 🌈

the whole squad, periodt. 💜

🎀 AUTHOR 🎀

this manual page was written by Uwe Steinmann uwe@steinmann.cx. giving main character documentation energy. 👑

and that's the whole vibe check bestie — this page is from the Library Functions Manual collection, footer reads PX_GET_DATA_LONG(3), so if you ever forget where you found her, she's filed right there under that name. bye ily, go convert some longs responsibly 💖✨🧚

📦 where this page comes from