ReqErr(3I)

💖 ReqErr — handle request errors 💖

okay bestie, so this is a page from the InterViews Reference Manual, and it's all about ReqErr, the little class that catches your oopsies before they take your whole process down. sit with me, it's gonna be fun. 🎀

✨ NAME ✨

ReqErr — handle request errors 🫶

🌸 SYNOPSIS 🌸

#include <InterViews/reqerr.h>

💅 DESCRIPTION 💅

so like, sometimes you send a request to the window server and it just… doesn't go. 🙈 not your fault, it's just life. the classic example: a window gets destroyed while it's being repositioned interactively, and then the request to place that window in its new position fails. gone. poof. 💀

normally? errors like this make the process terminate. like, the whole thing. no cap. 😭

that's where the ReqErr class comes in — it's the main character that lets you handle errors within your application instead of just dying about it. the base class defines the attributes associated with each error, and here's the lineup:

• a message string describing the error 💌
• an integer request code that specifies the kind of call that generated the error 🔢
• an id object that was the target of the request 🎯

and when an error occurs, the attributes of the current request handler get assigned, and then the handler's Error operation is called. periodt. ✨

👑 PUBLIC OPERATIONS 👑

• ReqErr* Install() — use this error handler for subsequent errors, and it returns the previous error handler. cute little switcheroo. 💫
• virtual void Error() — handle a detected error. the default handler is a nop (so if you don't override it, it literally does nothing, bestie, it's giving silent treatment 🧚).

🌈 SEE ALSO 🌈

• Interactor(3I)

and that's the whole vibe, fr fr 💜 this was the InterViews manual, dated 15 June 1987, and the page you just read is ReqErr(3I). go forth and handle your errors, queen 👑✨