cairo-error-status: Error handling
Description
Decoding cairo's statusDetailed Description
Cairo uses a single status type to represent all kinds of errors. A status
value of CAIRO_STATUS_SUCCESS
represents no error and has an integer value
of zero. All other status values represent an error. Cairo's error handling is designed to be easy to use and safe. All major
cairo objects retain an error status internally which
can be queried anytime by the users using cairo*status()
calls. In
the mean time, it is safe to call all cairo functions normally even if the
underlying object is in an error status. This means that no error handling
code is required before or after each individual cairo function call.