Returns a function that takes the same arguments as function, and has the same side-effect behavior as function, but returns only a single value: a generalized boolean with the opposite truth value of that which would be returned as the primary value of function. That is, when the function would have returned true as its primary value the complement-function returns false, and when the function would have returned false as its primary value the complement-function returns true.
In Common Lisp, functions with names like
xxx-if-not are related to functions with names like
xxx-if in that
(xxx-if-not f . arguments) ≡ (xxx-if (complement f) . arguments)