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

<P>
<DL>
<DT><B> Synopsis </B><DD><P>Append a keystring to the input buffer
<DT><B> Usage </B><DD><P><CODE>int SLang_buffer_keystring (unsigned char *b, unsigned int len)</CODE>
<DT><B> Description </B><DD><P><CODE>SLang_buffer_keystring</CODE> places the <CODE>len</CODE> characters
specified by <CODE>b</CODE> at the <EM>end</EM> of the buffer that
<CODE>SLang_getkey</CODE> uses.  Upon success it returns 0; otherwise, no
characters are buffered and it returns <CODE>-1</CODE>.
<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_getkey, SLang_ungetkey, SLang_ungetkey_string</CODE>
</DL>
<P>
<P>
<P>
<HR>
<A HREF="cref-114.html">Next</A>
<A HREF="cref-112.html">Previous</A>
<A HREF="cref.html#toc113">Contents</A>
</BODY>
</HTML>
