<refentry id="refshave">
<refmeta>
<refentrytitle>ne_shave</refentrytitle>
<manvolnum>3</manvolnum>
</refmeta>
<refnamediv>
<refname>ne_shave</refname>
<refpurpose>trim whitespace from a string</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>#include <ne_string.h></funcsynopsisinfo>
<funcprototype>
<funcdef>char *<function>ne_shave</function></funcdef>
<paramdef>char *<parameter>str</parameter></paramdef>
<paramdef>const char *<parameter>whitespace</parameter></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para><function>ne_shave</function> returns a portion of
<parameter>str</parameter> with any leading or trailing characters in
the <parameter>whitespace</parameter> array removed.
<parameter>str</parameter> may be modified. Note that the return
value may not be equal to <parameter>str</parameter>.</para>
</refsect1>
<refsect1>
<title>Examples</title>
<para>The following code segment will output
<literal>"fish"</literal>:</para>
<programlisting>char s[] = ".!.fish!.!";
puts(ne_shave(s, ".!"));</programlisting>
</refsect1>
</refentry>