<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
		"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="cairo-Error-handling">
<refmeta>
<refentrytitle role="top_of_page" id="cairo-Error-handling.top_of_page">Error handling</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>CAIRO Library</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Error handling</refname>
<refpurpose>Decoding cairo's status</refpurpose>
</refnamediv>

<refsect1 id="cairo-Error-handling.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_return" colwidth="150px"/>
<colspec colname="functions_name"/>
<tbody>
<row><entry role="function_type">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="cairo-status-to-string">cairo_status_to_string</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="cairo-debug-reset-static-data">cairo_debug_reset_static_data</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="cairo-Error-handling.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="name" colwidth="150px"/>
<colspec colname="description"/>
<tbody>
<row><entry role="datatype_keyword">enum</entry><entry role="function_name"><link linkend="cairo-status-t">cairo_status_t</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>


<refsect1 id="cairo-Error-handling.description" role="desc">
<title role="desc.title">Description</title>
<para>Cairo uses a single status type to represent all kinds of errors.  A status
value of <link linkend="CAIRO-STATUS-SUCCESS:CAPS"><literal>CAIRO_STATUS_SUCCESS</literal></link> represents no error and has an integer value
of zero.  All other status values represent an error.</para>
<para>Cairo's error handling is designed to be easy to use and safe.  All major
cairo objects <firstterm>retain</firstterm> 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.</para>

</refsect1>
<refsect1 id="cairo-Error-handling.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="cairo-status-to-string" role="function" condition="since:1.0">
<title>cairo_status_to_string&#160;()</title>
<indexterm zone="cairo-status-to-string" role="1.0"><primary sortas="status_to_string">cairo_status_to_string</primary></indexterm>
<programlisting language="C">const <link linkend="char"><returnvalue>char</returnvalue></link>&#160;*
cairo_status_to_string (<parameter><link linkend="cairo-status-t"><type>cairo_status_t</type></link> status</parameter>);</programlisting>
<para>Provides a human-readable description of a <link linkend="cairo-status-t"><type>cairo_status_t</type></link>.</para>
<refsect3 id="cairo-status-to-string.parameters" role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>status</para></entry>
<entry role="parameter_description"><para>a cairo status</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 id="cairo-status-to-string.returns" role="returns">
<title>Returns</title>
<para> a string representation of the status</para>
</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>
<refsect2 id="cairo-debug-reset-static-data" role="function" condition="since:1.0">
<title>cairo_debug_reset_static_data&#160;()</title>
<indexterm zone="cairo-debug-reset-static-data" role="1.0"><primary sortas="debug_reset_static_data">cairo_debug_reset_static_data</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
cairo_debug_reset_static_data (<parameter><type>void</type></parameter>);</programlisting>
<para>Resets all static data within cairo to its original state,
(ie. identical to the state at the time of program invocation). For
example, all caches within cairo will be flushed empty.</para>
<para>This function is intended to be useful when using memory-checking
tools such as valgrind. When valgrind's memcheck analyzes a
cairo-using program without a call to <link linkend="cairo-debug-reset-static-data"><function>cairo_debug_reset_static_data()</function></link>,
it will report all data reachable via cairo's static objects as
"still reachable". Calling <link linkend="cairo-debug-reset-static-data"><function>cairo_debug_reset_static_data()</function></link> just prior
to program termination will make it easier to get squeaky clean
reports from valgrind.</para>
<para>WARNING: It is only safe to call this function when there are no
active cairo objects remaining, (ie. the appropriate destroy
functions have been called as necessary). If there are active cairo
objects, this call is likely to cause a crash, (eg. an assertion
failure due to a hash table being destroyed when non-empty).</para>
<para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>

</refsect1>
<refsect1 id="cairo-Error-handling.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="cairo-status-t" role="enum" condition="since:1.0">
<title>enum cairo_status_t</title>
<indexterm zone="cairo-status-t" role="1.0"><primary sortas="status_t">cairo_status_t</primary></indexterm>
<para><link linkend="cairo-status-t"><type>cairo_status_t</type></link> is used to indicate errors that can occur when
using Cairo. In some cases it is returned directly by functions.
but when using <link linkend="cairo-t"><type>cairo_t</type></link>, the last error, if any, is stored in
the context and can be retrieved with <link linkend="cairo-status"><function>cairo_status()</function></link>.</para>
<para>New entries may be added in future versions.  Use <link linkend="cairo-status-to-string"><function>cairo_status_to_string()</function></link>
to get a human-readable representation of an error message.</para>
<refsect3 id="cairo-status-t.members" role="enum_members">
<title>Members</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="enum_members_name" colwidth="300px"/>
<colspec colname="enum_members_description"/>
<colspec colname="enum_members_annotations" colwidth="200px"/>
<tbody>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SUCCESS:CAPS">CAIRO_STATUS_SUCCESS</para></entry>
<entry role="enum_member_description"><para>no error has occurred (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NO-MEMORY:CAPS">CAIRO_STATUS_NO_MEMORY</para></entry>
<entry role="enum_member_description"><para>out of memory (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-RESTORE:CAPS">CAIRO_STATUS_INVALID_RESTORE</para></entry>
<entry role="enum_member_description"><para>cairo_restore() called without matching <link linkend="cairo-save"><function>cairo_save()</function></link> (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-POP-GROUP:CAPS">CAIRO_STATUS_INVALID_POP_GROUP</para></entry>
<entry role="enum_member_description"><para>no saved group to pop, i.e. <link linkend="cairo-pop-group"><function>cairo_pop_group()</function></link> without matching <link linkend="cairo-push-group"><function>cairo_push_group()</function></link> (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NO-CURRENT-POINT:CAPS">CAIRO_STATUS_NO_CURRENT_POINT</para></entry>
<entry role="enum_member_description"><para>no current point defined (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-MATRIX:CAPS">CAIRO_STATUS_INVALID_MATRIX</para></entry>
<entry role="enum_member_description"><para>invalid matrix (not invertible) (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STATUS:CAPS">CAIRO_STATUS_INVALID_STATUS</para></entry>
<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-status-t"><type>cairo_status_t</type></link> (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NULL-POINTER:CAPS">CAIRO_STATUS_NULL_POINTER</para></entry>
<entry role="enum_member_description"><para><link linkend="NULL:CAPS"><literal>NULL</literal></link> pointer (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STRING:CAPS">CAIRO_STATUS_INVALID_STRING</para></entry>
<entry role="enum_member_description"><para>input string not valid UTF-8 (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-PATH-DATA:CAPS">CAIRO_STATUS_INVALID_PATH_DATA</para></entry>
<entry role="enum_member_description"><para>input path data not valid (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-READ-ERROR:CAPS">CAIRO_STATUS_READ_ERROR</para></entry>
<entry role="enum_member_description"><para>error while reading from input stream (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-WRITE-ERROR:CAPS">CAIRO_STATUS_WRITE_ERROR</para></entry>
<entry role="enum_member_description"><para>error while writing to output stream (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SURFACE-FINISHED:CAPS">CAIRO_STATUS_SURFACE_FINISHED</para></entry>
<entry role="enum_member_description"><para>target surface has been finished (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-SURFACE-TYPE-MISMATCH:CAPS">CAIRO_STATUS_SURFACE_TYPE_MISMATCH</para></entry>
<entry role="enum_member_description"><para>the surface type is not appropriate for the operation (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-PATTERN-TYPE-MISMATCH:CAPS">CAIRO_STATUS_PATTERN_TYPE_MISMATCH</para></entry>
<entry role="enum_member_description"><para>the pattern type is not appropriate for the operation (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-CONTENT:CAPS">CAIRO_STATUS_INVALID_CONTENT</para></entry>
<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-content-t"><type>cairo_content_t</type></link> (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-FORMAT:CAPS">CAIRO_STATUS_INVALID_FORMAT</para></entry>
<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-format-t"><type>cairo_format_t</type></link> (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-VISUAL:CAPS">CAIRO_STATUS_INVALID_VISUAL</para></entry>
<entry role="enum_member_description"><para>invalid value for an input Visual* (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-FILE-NOT-FOUND:CAPS">CAIRO_STATUS_FILE_NOT_FOUND</para></entry>
<entry role="enum_member_description"><para>file not found (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-DASH:CAPS">CAIRO_STATUS_INVALID_DASH</para></entry>
<entry role="enum_member_description"><para>invalid value for a dash setting (Since 1.0)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-DSC-COMMENT:CAPS">CAIRO_STATUS_INVALID_DSC_COMMENT</para></entry>
<entry role="enum_member_description"><para>invalid value for a DSC comment (Since 1.2)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-INDEX:CAPS">CAIRO_STATUS_INVALID_INDEX</para></entry>
<entry role="enum_member_description"><para>invalid index passed to getter (Since 1.4)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-CLIP-NOT-REPRESENTABLE:CAPS">CAIRO_STATUS_CLIP_NOT_REPRESENTABLE</para></entry>
<entry role="enum_member_description"><para>clip region not representable in desired format (Since 1.4)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-TEMP-FILE-ERROR:CAPS">CAIRO_STATUS_TEMP_FILE_ERROR</para></entry>
<entry role="enum_member_description"><para>error creating or writing to a temporary file (Since 1.6)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-STRIDE:CAPS">CAIRO_STATUS_INVALID_STRIDE</para></entry>
<entry role="enum_member_description"><para>invalid value for stride (Since 1.6)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-FONT-TYPE-MISMATCH:CAPS">CAIRO_STATUS_FONT_TYPE_MISMATCH</para></entry>
<entry role="enum_member_description"><para>the font type is not appropriate for the operation (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-IMMUTABLE:CAPS">CAIRO_STATUS_USER_FONT_IMMUTABLE</para></entry>
<entry role="enum_member_description"><para>the user-font is immutable (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-ERROR:CAPS">CAIRO_STATUS_USER_FONT_ERROR</para></entry>
<entry role="enum_member_description"><para>error occurred in a user-font callback function (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-NEGATIVE-COUNT:CAPS">CAIRO_STATUS_NEGATIVE_COUNT</para></entry>
<entry role="enum_member_description"><para>negative number used where it is not allowed (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-CLUSTERS:CAPS">CAIRO_STATUS_INVALID_CLUSTERS</para></entry>
<entry role="enum_member_description"><para>input clusters do not represent the accompanying text and glyph array (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-SLANT:CAPS">CAIRO_STATUS_INVALID_SLANT</para></entry>
<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-font-slant-t"><type>cairo_font_slant_t</type></link> (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-WEIGHT:CAPS">CAIRO_STATUS_INVALID_WEIGHT</para></entry>
<entry role="enum_member_description"><para>invalid value for an input <link linkend="cairo-font-weight-t"><type>cairo_font_weight_t</type></link> (Since 1.8)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-SIZE:CAPS">CAIRO_STATUS_INVALID_SIZE</para></entry>
<entry role="enum_member_description"><para>invalid value (typically too big) for the size of the input (surface, pattern, etc.) (Since 1.10)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-USER-FONT-NOT-IMPLEMENTED:CAPS">CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED</para></entry>
<entry role="enum_member_description"><para>user-font method not implemented (Since 1.10)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-TYPE-MISMATCH:CAPS">CAIRO_STATUS_DEVICE_TYPE_MISMATCH</para></entry>
<entry role="enum_member_description"><para>the device type is not appropriate for the operation (Since 1.10)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-ERROR:CAPS">CAIRO_STATUS_DEVICE_ERROR</para></entry>
<entry role="enum_member_description"><para>an operation to the device caused an unspecified error (Since 1.10)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-INVALID-MESH-CONSTRUCTION:CAPS">CAIRO_STATUS_INVALID_MESH_CONSTRUCTION</para></entry>
<entry role="enum_member_description"><para>a mesh pattern
  construction operation was used outside of a
  <link linkend="cairo-mesh-pattern-begin-patch"><function>cairo_mesh_pattern_begin_patch()</function></link>/<link linkend="cairo-mesh-pattern-end-patch"><function>cairo_mesh_pattern_end_patch()</function></link>
  pair (Since 1.12)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-DEVICE-FINISHED:CAPS">CAIRO_STATUS_DEVICE_FINISHED</para></entry>
<entry role="enum_member_description"><para>target device has been finished (Since 1.12)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-JBIG2-GLOBAL-MISSING:CAPS">CAIRO_STATUS_JBIG2_GLOBAL_MISSING</para></entry>
<entry role="enum_member_description"><para><link linkend="CAIRO-MIME-TYPE-JBIG2-GLOBAL-ID:CAPS"><literal>CAIRO_MIME_TYPE_JBIG2_GLOBAL_ID</literal></link> has been used on at least one image
  but no image provided <link linkend="CAIRO-MIME-TYPE-JBIG2-GLOBAL:CAPS"><literal>CAIRO_MIME_TYPE_JBIG2_GLOBAL</literal></link> (Since 1.14)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-PNG-ERROR:CAPS">CAIRO_STATUS_PNG_ERROR</para></entry>
<entry role="enum_member_description"><para>error occurred in libpng while reading from or writing to a PNG file (Since 1.16)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-FREETYPE-ERROR:CAPS">CAIRO_STATUS_FREETYPE_ERROR</para></entry>
<entry role="enum_member_description"><para>error occurred in libfreetype (Since 1.16)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-WIN32-GDI-ERROR:CAPS">CAIRO_STATUS_WIN32_GDI_ERROR</para></entry>
<entry role="enum_member_description"><para>error occurred in the Windows Graphics Device Interface (Since 1.16)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-TAG-ERROR:CAPS">CAIRO_STATUS_TAG_ERROR</para></entry>
<entry role="enum_member_description"><para>invalid tag name, attributes, or nesting (Since 1.16)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
<row role="constant"><entry role="enum_member_name"><para id="CAIRO-STATUS-LAST-STATUS:CAPS">CAIRO_STATUS_LAST_STATUS</para></entry>
<entry role="enum_member_description"><para>this is a special value indicating the number of
  status values defined in this enumeration.  When using this value, note
  that the version of cairo at run-time may have additional status values
  defined than the value of this symbol at compile-time. (Since 1.10)</para>
</entry>
<entry role="enum_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3><para role="since">Since: <link linkend="api-index-1.0">1.0</link></para></refsect2>

</refsect1>
<refsect1 id="cairo-Error-handling.see-also">
<title>See Also</title>
<para>cairo_status(), <link linkend="cairo-surface-status"><function>cairo_surface_status()</function></link>, <link linkend="cairo-pattern-status"><function>cairo_pattern_status()</function></link>,
           <link linkend="cairo-font-face-status"><function>cairo_font_face_status()</function></link>, <link linkend="cairo-scaled-font-status"><function>cairo_scaled_font_status()</function></link>,
           <link linkend="cairo-region-status"><function>cairo_region_status()</function></link></para>

</refsect1>

</refentry>
