/usr/share/doc/cl-uffi/html/ensure-char-character.html is in cl-uffi 2.1.2-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 | <?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>ensure-char-character</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2" /><link rel="home" href="index.html" title="UFFI Reference Guide" /><link rel="up" href="objects.html" title="Objects" /><link rel="prev" href="deref-pointer.html" title="deref-pointer" /><link rel="next" href="ensure-char-integer.html" title="ensure-char-integer" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">ensure-char-character</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="deref-pointer.html">Prev</a> </td><th width="60%" align="center">Objects</th><td width="20%" align="right"> <a accesskey="n" href="ensure-char-integer.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="ensure-char-character"><a id="ensure-char-character"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ensure-char-character — Ensures that a dereferenced <code class="constant">:char</code> pointer is
a character.
<b>Macro</b></p></div><div class="refsynopsisdiv" title="Syntax"><h2>Syntax</h2><pre class="synopsis">
<code class="function">ensure-char-character</code> <em class="replaceable"><code>object</code></em> => <span class="returnvalue">char</span>
</pre></div><div class="refsect1" title="Arguments and Values"><a id="id406378"></a><h2>Arguments and Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>object</code></em></span></dt><dd><p>Either a character or a integer specifying a character code.
</p></dd><dt><span class="term"><span class="returnvalue">char</span></span></dt><dd><p>A character.
</p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id406424"></a><h2>Description</h2><p>
Ensures that an objects obtained by dereferencing
<code class="constant">:char</code> and <code class="constant">:unsigned-char</code>
pointers are a lisp character.
</p></div><div class="refsect1" title="Examples"><a id="id406443"></a><h2>Examples</h2><p>
</p><pre class="screen">
(let ((fs (convert-to-foreign-string "a")))
(prog1
(ensure-char-character (deref-pointer fs :char))
(free-foreign-object fs)))
=> #\a
</pre><p>
</p></div><div class="refsect1" title="Side Effects"><a id="id406461"></a><h2>Side Effects</h2><p>None.</p></div><div class="refsect1" title="Affected by"><a id="id406472"></a><h2>Affected by</h2><p>None.</p></div><div class="refsect1" title="Exceptional Situations"><a id="id406483"></a><h2>Exceptional Situations</h2><p>Depending upon the implementation and what <span class="application"><span class="emphasis"><em>UFFI</em></span></span> expects, this
macro may signal an error if the object is not a character or
integer.</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="deref-pointer.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="objects.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ensure-char-integer.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">deref-pointer </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> ensure-char-integer</td></tr></table></div></body></html>
|