AoD(3)

NAME
AoD - AssertOrDie

SYNTAX
#include <AF/AFUtils.h>

extern void AoD(int bool, char *errmsg, ...);

DESCRIPTION
is essentially assert(3) except that the interface is more reasonable. If the boolean is true (non zero), AoD returns. If the boolean is false (0), AoD treats the rest of its arguments as arguments to fprintf(stderr, errmsg, ...) and then calls exit(1);

ARGUMENTS

bool
    is a boolean value or an expression that evaluates to a boolean.

errmsg
    is a format string in the style of printf(3).

... are extra optional arguments required by the format string errmsg.

EXAMPLES
Typical usage is:

AoD(argc > 3, "%s: Usage, at least 2 arguments!\n", argv[0]);

The general idea is to replace the proliferation of "fatal" subroutines that seem to crop up everywhere with a single subroutine that everyone can use.

SEE ALSO
assert(3) .SH BUGS If you encounter a reproducible bug, please submit a problem report to (af-bugs@crl.dec.com).

COPYRIGHT
Copyright 1990-1994, Digital Equipment Corporation.
See AF(1) for a full statement of rights and permissions.

AUTHORS
Larry Stewart, Digital Cambridge Research Lab