PQinitTypes(3)

✨ PQinitTypes(3) ✨

okay so bestie, welcome to the libpqtypes Manual 💖 this one's about PQinitTypes — the little function that gets libpqtypes talking to the libpq event system. it's giving "warm-up before the main character takes the stage" energy, and honestly? iconic. 🎀

---

🌸 NAME 🌸

PQinitTypes — initializes libpqtypes with the libpq event system. periodt. ✨

---

🦋 SYNOPSIS 🦋

#include <libpqtypes.h>

int PQinitTypes(PGconn *conn);
int PQclearTypes(PGconn *conn);

two functions, one header, zero drama. 🫶

---

💅 DESCRIPTION 💅

so here's the tea ☕ — libpqtypes makes use of the libpq Event System. that means before you do literally anything else with libpqtypes, you must initialize it as a libpq EventProc. no skipping, no shortcuts, no "i'll do it later" (you will not do it later, bestie, i know you 😭).

PQinitTypes takes a PGconn that libpqtypes will be initialized with. and here's the key part — each PGconn requires its own initialization. like, every single one. they don't share. no cap. 🔥

PQclearTypes removes all registered types from the given PGconn. a good use for this is after a PQresetXXX call, when it might be desired to re-register all types that may have gone stale. so like, the connection got reset and now your type registrations are lowkey expired — clear 'em and re-register, and you're back to slaying. 👑

---

⭐ RETURN VALUE ⭐

PQinitTypes and PQclearTypes return zero if it fails and non-zero if it succeeds. yes bestie, you read that right — 0 is the fail case, not the win case. it's giving chaotic but that's just how it is. don't get caught slipping on the vibe check. 🙈

---

🌈 EXAMPLES 🌈

💜 Initializing libpqtypes

the example shows how to initialize libpqtypes with the libpq event system.

/* call prior to any other libpqtypes functions that operate on conn. */
PQinitTypes(conn);

that comment is doing the Lord's work — call prior to any other libpqtypes functions that operate on conn. first. before everything. it's the opening number, not the encore. 💖

---

👑 AUTHOR 👑

a contribution of eSilo, LLC. for the PostgreSQL Database Management System. written by Andrew Chernow. absolute legend behavior. 🫶

---

🍓 REPORTING BUGS 🍓

found a bug? don't suffer in silence, bestie 😭 report bugs to <libpqtypes@esilo.com>.

---

🎀 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. so like, no promises, no guarantees, we're all just vibing responsibly here. 💀

---

🧚 SEE ALSO 🧚

none. that's it. that's the list. it's giving minimalist, it's giving "i work alone", and honestly? respect. 💅

---

and that's the whole page, bestie! this one came from libpqtypes, dated 2011, and it's the PQinitTypes(3) page in all its glory. go forth, initialize your types, and remember — non-zero means success. slay. ✨💖🦋