<refsynopsisdiv>
<title>Syntax</title>
<synopsis>
- <function>allocate-foreign-object</function> <replaceable>type</replaceable> => <returnvalue>ptr</returnvalue>
+ <function>allocate-foreign-object</function> <replaceable>type &optional size</replaceable> => <returnvalue>ptr</returnvalue>
</synopsis>
</refsynopsisdiv>
<refsect1>
<varlistentry>
<term><parameter>type</parameter></term>
<listitem>
- <para>A type of foreign object to allocate.
+ <para>A unevaluated type of foreign object to allocate.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>size</parameter></term>
+ <listitem>
+ <para>An optional size parameter. If specified, allocates and returns an
+array of <parameter>type</parameter> that is <parameter>size</parameter> members long.
</para>
</listitem>
</varlistentry>
<refentry id="ensure-char-character">
<refnamediv>
<refname>ensure-char-character</refname>
- <refpurpose>Ensures that a dereferenced :char pointer is
+ <refpurpose>Ensures that a dereferenced <constant>:char</constant> pointer is
a character.
</refpurpose>
<refclass>Macro</refclass>
<refentry id="ensure-char-integer">
<refnamediv>
<refname>ensure-char-integer</refname>
- <refpurpose>Ensures that a dereferenced :char pointer is
+ <refpurpose>Ensures that a dereferenced <constant>:char</constant> pointer is
an integer.
</refpurpose>
<refclass>Macro</refclass>