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