Somewhat related, one of my favorites from "Be Developer's Guide"[0]:

  is_computer_on_fire()

    double is_computer_on_fire(void)

Returns the temperature of the motherboard if the computer is currently on fire. Smoldering doesn't count. If the computer isn't on fire, the function returns some other value.

---

Though of course, the Microsoft engineer[ing committee] was entirely serious when they wrote the OP's function signature, while I imagine the Be engineer having a laugh while adding it to the SDK and then getting it into the official docs in print.

0. https://www.google.com/books/edition/Be_Developer_s_Guide/Wo...