/usr/share/gtk-doc/html/raptor/tutorial-parser-set-error-warning-handlers.html is in libraptor1-doc 1.4.21-10.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Set fatal error, error and warning handlers</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Raptor RDF Syntax Parsing and Serializing Library Manual">
<link rel="up" href="tutorial-parsing.html" title="Parsing syntaxes to RDF Triples">
<link rel="prev" href="tutorial-parser-set-triple-handler.html" title="Set RDF triple callback handler">
<link rel="next" href="tutorial-parser-set-id-handler.html" title="Set the identifier creator handler">
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="chapter" href="introduction.html" title="Raptor Overview">
<link rel="part" href="tutorial.html" title="Part I. Raptor Tutorial">
<link rel="chapter" href="tutorial-initialising-finishing.html" title="Initialising and Finishing using the Library">
<link rel="chapter" href="tutorial-querying-functionality.html" title="Listing built-in functionality">
<link rel="chapter" href="tutorial-parsing.html" title="Parsing syntaxes to RDF Triples">
<link rel="chapter" href="tutorial-serializing.html" title="Serializing RDF triples to a syntax">
<link rel="part" href="reference-manual.html" title="Part II. Raptor Reference Manual">
<link rel="chapter" href="raptor-parsers.html" title="Parsers in Raptor (syntax to triples)">
<link rel="chapter" href="raptor-serializers.html" title="Serializers in Raptor (triples to syntax)">
<link rel="index" href="ix01.html" title="Index">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="tutorial-parser-set-triple-handler.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="tutorial-parsing.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Raptor RDF Syntax Parsing and Serializing Library Manual</th>
<td><a accesskey="n" href="tutorial-parser-set-id-handler.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="section" title="Set fatal error, error and warning handlers">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="tutorial-parser-set-error-warning-handlers"></a>Set fatal error, error and warning handlers</h2></div></div></div>
<p>There are several other callback handlers that can be set
on parsers. These can be set any time before parsing is called.
Errors and warnings from parsing can be returned with functions
that all take a callback of type
<a class="link" href="raptor-section-general.html#raptor-message-handler" title="raptor_message_handler ()"><span class="type">raptor_message_handler</span></a>
and signature:
</p>
<pre class="programlisting">
void
message_handler(void *user_data, raptor_locator* locator,
const char *message)
{
/* do something with the message */
}
</pre>
<p>
returning the user data given, associated location information
as a <a class="link" href="raptor-section-locator.html#raptor-locator" title="raptor_locator"><span class="type">raptor_locator</span></a>
and the error/warning message itself. The <span class="emphasis"><em>locator</em></span>
structure contains full information on the details of where in the
file or URI the message occurred.
</p>
<p>The fatal error, error and warning handlers are all set with
similar functions that take a handler as follows:
</p>
<pre class="programlisting">
raptor_set_fatal_error_handler(rdf_parser, user_data, fatal_handler);
raptor_set_error_handler(rdf_parser, user_data, error_handler);
raptor_set_warning_handler(rdf_parser, user_data, warning_handler);
</pre>
<p>
</p>
<div class="caution" title="Caution" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Caution</h3>The program will terminate
with <code class="function">abort()</code> if the fatal error handler returns.
</div>
<p>
</p>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.13</div>
</body>
</html>
|