/usr/share/gtk-doc/html/raptor2/raptor2-section-memory.html is in libraptor2-doc 2.0.14-1.
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 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Memory</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Raptor RDF Syntax Library Manual">
<link rel="up" href="reference-manual.html" title="Part II. Raptor Reference Manual">
<link rel="prev" href="raptor2-section-general.html" title="General">
<link rel="next" href="raptor2-section-avltree.html" title="AVL Trees">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</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="raptor2-section-general.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="reference-manual.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 Library Manual</th>
<td><a accesskey="n" href="raptor2-section-avltree.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#raptor2-section-memory.synopsis" class="shortcut">Top</a>
|
<a href="#raptor2-section-memory.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="raptor2-section-memory"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="raptor2-section-memory.top_of_page"></a>Memory</span></h2>
<p>Memory — Memory handling functions</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="raptor2-section-memory.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis"><span class="returnvalue">void</span> <a class="link" href="raptor2-section-memory.html#raptor-free-memory" title="raptor_free_memory ()">raptor_free_memory</a> (<em class="parameter"><code><span class="type">void</span> *ptr</code></em>);
<span class="returnvalue">void</span> * <a class="link" href="raptor2-section-memory.html#raptor-alloc-memory" title="raptor_alloc_memory ()">raptor_alloc_memory</a> (<em class="parameter"><code><span class="type">size_t</span> size</code></em>);
<span class="returnvalue">void</span> * <a class="link" href="raptor2-section-memory.html#raptor-calloc-memory" title="raptor_calloc_memory ()">raptor_calloc_memory</a> (<em class="parameter"><code><span class="type">size_t</span> nmemb</code></em>,
<em class="parameter"><code><span class="type">size_t</span> size</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="raptor2-section-memory.description"></a><h2>Description</h2>
<p>
Wrappers around the free, malloc and calloc functions but
called from inside the library. Required by some systems
to handle multiple-HEAPs and pass memory to and from the library.
</p>
</div>
<div class="refsect1">
<a name="raptor2-section-memory.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="raptor-free-memory"></a><h3>raptor_free_memory ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> raptor_free_memory (<em class="parameter"><code><span class="type">void</span> *ptr</code></em>);</pre>
<p>
Free memory allocated inside raptor.
</p>
<p>
Some systems require memory allocated in a library to
be deallocated in that library. This function allows
memory allocated by raptor to be freed.
</p>
<p>
Examples include the result of the '_to_' methods that returns
allocated memory such as raptor_uri_filename_to_uri_string,
raptor_uri_filename_to_uri_string
and raptor_uri_uri_string_to_filename_fragment
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>ptr</code></em> :</span></p></td>
<td>memory pointer</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="raptor-alloc-memory"></a><h3>raptor_alloc_memory ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> * raptor_alloc_memory (<em class="parameter"><code><span class="type">size_t</span> size</code></em>);</pre>
<p>
Allocate memory inside raptor.
</p>
<p>
Some systems require memory allocated in a library to
be deallocated in that library. This function allows
memory to be allocated inside the raptor shared library
that can be freed inside raptor either internally or via
raptor_free_memory.
</p>
<p>
Examples include using this in the <a class="link" href="raptor2-section-world.html#raptor-world-generate-bnodeid" title="raptor_world_generate_bnodeid ()"><code class="function">raptor_world_generate_bnodeid()</code></a> handler
code to create new strings that will be used internally
as short identifiers and freed later on by the parsers.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td>size of memory to allocate</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the address of the allocated memory or NULL on failure</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="raptor-calloc-memory"></a><h3>raptor_calloc_memory ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> * raptor_calloc_memory (<em class="parameter"><code><span class="type">size_t</span> nmemb</code></em>,
<em class="parameter"><code><span class="type">size_t</span> size</code></em>);</pre>
<p>
Allocate zeroed array of items inside raptor.
</p>
<p>
Some systems require memory allocated in a library to
be deallocated in that library. This function allows
memory to be allocated inside the raptor shared library
that can be freed inside raptor either internally or via
raptor_free_memory.
</p>
<p>
Examples include using this in the <a class="link" href="raptor2-section-world.html#raptor-world-generate-bnodeid" title="raptor_world_generate_bnodeid ()"><code class="function">raptor_world_generate_bnodeid()</code></a> handler
code to create new strings that will be used internally
as short identifiers and freed later on by the parsers.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>nmemb</code></em> :</span></p></td>
<td>number of members</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
<td>size of item</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the address of the allocated memory or NULL on failure</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18</div>
</body>
</html>
|