<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE> {The S-lang C Library Reference}: SLsmg_read_raw</TITLE>
<LINK HREF="cref-36.html" REL=next>
<LINK HREF="cref-34.html" REL=previous>
<LINK HREF="cref.html#toc35" REL=contents>
</HEAD>
<BODY>
<A HREF="cref-36.html">Next</A>
<A HREF="cref-34.html">Previous</A>
<A HREF="cref.html#toc35">Contents</A>
<HR>
<H2><A NAME="SLsmg_read_raw"></A> <A NAME="s35">35. <B>SLsmg_read_raw</B></A></H2>

<P>
<DL>
<DT><B> Synopsis </B><DD><P>Read characters from the virtual display
<DT><B> Usage </B><DD><P><CODE>unsigned int SLsmg_read_raw (unsigned short *buf, unsigned int len)</CODE>
<DT><B> Description </B><DD><P><CODE>SLsmg_read_raw</CODE> attempts to read <CODE>len</CODE> characters from the
current position on the virtual display into the buffer specified by
<CODE>buf</CODE>.  It returns the number of characters actually read.  This
number will be less than <CODE>len</CODE> if an attempt is made to read
past the right margin of the display.
<DT><B> Notes </B><DD><P>The purpose of the pair of functions, <CODE>SLsmg_read_raw</CODE> and
<CODE>SLsmg_write_raw</CODE>, is to permit one to copy the contents of one
region of the virtual display to another region.
<DT><B> See Also </B><DD><P><CODE>SLsmg_char_at, SLsmg_write_raw</CODE>
</DL>
<P>
<P>
<P>
<HR>
<A HREF="cref-36.html">Next</A>
<A HREF="cref-34.html">Previous</A>
<A HREF="cref.html#toc35">Contents</A>
</BODY>
</HTML>
