<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <HTML> <HEAD> <META NAME="GENERATOR" CONTENT="SGML-Tools 1.0.9"> <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>