<!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}: 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>