PQgeterror(3)

💖 PQgeterror(3) — libpqtypes Manual 💖

okay bestie, so this is the libpqtypes error system page. like, the whole little family of functions that handle errors in libpqtypes. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

PQgeterror, PQseterror, PQgetErrorField — the libpqtypes error system management functions. that's the trio. the error girlies. the whole friend group 💅

---

✨ SYNOPSIS ✨

#include <libpqtypes.h>

char *PQgeterror(void);
void PQseterror(const char *format, ...);
char *PQgetErrorField(int fieldcode);

look at them. so neat. so iconic. ⭐

---

✨ DESCRIPTION ✨

so, the tea: the libpqtypes library keeps a per-thread global error message. like every thread gets its own lil error journal, no sharing, no drama. 📓✨ and that error message is managed by PQgeterror() and PQseterror().

PQseterror() takes a regular printf compatible format string — yes, the normal printf kind you already know and love — and uses it to set the libpqtypes error message. 🎀

PQgetErrorField() gets an error field from the last executed query. and okay this part matters, don't skip it: the error field is only set by PQparamExec and PQparamExecPrepared. that's it. that's the only way. so if you're using libpq functions that return results, like PQexec, then keep using PQresultErrorField like you always did. don't come to PQgetErrorField() for those, it won't have your answer, and honestly that's not its job. 💀

and when you want to clear the libpqtypes error message? call PQseterror() with a NULL format string:

PQseterror(NULL);

boom. cleared. ✨ and lowkey highkey important: this will also clear error fields. two birds, one iconic little function call. 🦋

---

✨ RETURN VALUE ✨

PQgeterror() returns the last error message for the calling thread. and bestie, listen — it will never return NULL. never ever. it always has something to say. 💅

PQgetErrorField() returns the error field, referenced by fieldcode, for the last executed query. if no value exists, it returns NULL. so like, sometimes it's quiet. that's valid. 🌸

---

✨ EXAMPLES ✨

None.

yeah. that's the whole section. the manpage said None and we respect that. no examples today, go write your own, main character. 👑

---

✨ AUTHOR ✨

a contribution of eSilo, LLC. for the PostgreSQL Database Management System. written by Andrew Chernow and Merlin Moncure. absolute legends, we stan. 🫶🌟

---

✨ REPORTING BUGS ✨

found a bug? report it to <libpqtypes@esilo.com>. tell them everything. they wanna know. 🐛💌

---

✨ COPYRIGHT ✨

Copyright (c) 2011 eSilo, LLC. All rights reserved.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

no warranty bestie. literally none. not even the merchantability one. not even the fitness-for-a-particular-purpose one. it's giving "you're on your own" but make it legal. 😭

---

✨ SEE ALSO ✨

• pqt-specs(3) 🌈

---

and that's the page!! 💖 this is PQgeterror(3) from the libpqtypes manual, dated 2011. go forth and handle your errors, you gorgeous little thread. no cap. ✨🎀🦋