1 2@c %start of fragment 3 4@node Error handling 5@chapter Error handling 6Decoding cairo's status 7 8@section Overview 9Cairo uses a single status type to represent all kinds of errors. A 10status value of @samp{CAIRO_STATUS_SUCCESS} represents no error and has 11an integer value of zero. All other status values represent an error. 12 13Cairo's error handling is designed to be easy to use and safe. All major 14cairo objects @dfn{retain} an error status internally which can be 15queried anytime by the users using cairo*_status() calls. In the mean 16time, it is safe to call all cairo functions normally even if the 17underlying object is in an error status. This means that no error 18handling code is required before or after each individual cairo function 19call. 20 21@section Usage 22@include defuns-cairo-status.xml.texi 23 24@c %end of fragment 25