<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE> {The S-lang C Library Reference}: SLang_ungetkey_string</TITLE>
<LINK HREF="cref-113.html" REL=next>
<LINK HREF="cref-111.html" REL=previous>
<LINK HREF="cref.html#toc112" REL=contents>
</HEAD>
<BODY>
<A HREF="cref-113.html">Next</A>
<A HREF="cref-111.html">Previous</A>
<A HREF="cref.html#toc112">Contents</A>
<HR>
<H2><A NAME="SLang_ungetkey_string"></A> <A NAME="s112">112. <B>SLang_ungetkey_string</B></A></H2>

<P>
<DL>
<DT><B> Synopsis </B><DD><P>Unget a key string
<DT><B> Usage </B><DD><P><CODE>int SLang_ungetkey_string (unsigned char *buf, unsigned int n)</CODE>
<DT><B> Description </B><DD><P>The <CODE>SLang_ungetkey_string</CODE> function may be used to push the
<CODE>n</CODE> characters pointed to by <CODE>buf</CODE> onto the buffered input
stream that <CODE>SLgetkey</CODE> uses.  If there is not enough room for
the characters, <CODE>-1</CODE> is returned and none are buffered.  Otherwise,
it returns zero.
<DT><B> Notes </B><DD><P>The difference between <CODE>SLang_buffer_keystring</CODE> and
<CODE>SLang_ungetkey_string</CODE> is that the <CODE>SLang_buffer_keystring</CODE>
appends the characters to the end of the getkey buffer, whereas
<CODE>SLang_ungetkey_string</CODE> inserts the characters at the beginning
of the input buffer.
<DT><B> See Also </B><DD><P><CODE>SLang_ungetkey, SLang_getkey</CODE>
</DL>
<P>
<P>
<P>
<HR>
<A HREF="cref-113.html">Next</A>
<A HREF="cref-111.html">Previous</A>
<A HREF="cref.html#toc112">Contents</A>
</BODY>
</HTML>
