Mercurial > hg > Members > kono > nitros9-code
changeset 597:2e76fecc5ca0
All refentries finished.
author | roug |
---|---|
date | Fri, 15 Nov 2002 21:49:51 +0000 |
parents | fe8e46eca1ed |
children | a74b8d8c28db |
files | docs/ccguide/getc.refentry docs/ccguide/getpid.refentry |
diffstat | 2 files changed, 50 insertions(+), 5 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/ccguide/getc.refentry Fri Nov 15 21:49:51 2002 +0000 +++ b/docs/ccguide/getc.refentry Fri Nov 15 21:49:51 2002 +0000 @@ -30,7 +30,51 @@ <refsect1><title>Description</title> <para> -Placeholder +Getc returns the next character from the file pointed to by +"fp". +</para> +<para> +Getchar is equivalent to "getc(stdin)". +</para> +<para> +Getw returns the next two bytes from the file as an integer. +</para> +<para> +Under OS-9 there is a choice of service requests to use when +reading from a file. "Read()" will get characters up to a +specified number in "raw" mode i.e. no editing will take +place on the input stream and the characters will appear to the +program exactly as in the file. "Readln()", on the other +hand, will honor the various mappings of characters +associated with a Serial Character device such as a terminal +and in any case will return to the caller as soon as a carriage +return is seen on the input. +</para> +<para> +In the vast majority of cases, it is preferable to use +"readln()" for accessing Serial Character devices and "read()" +for any other file input. "Getc()" uses this strategy and, as +all file input using the Standard Library functions is routed +through "getc()", so do all the other input functions. The +choice is made when the first call to "getc()" is made after +the file has been opened. The system is consulted for the +status of the file and a flag bit is set in the file structure +accordingly. The choice may be forced by the programmer by +setting the relevant bit before a call to "getc()". The flag +bits are defined in "<stdio.h>" and "_SCF" and "_RBF" and the +method is as follows: assuming that the file pointer for the +file, as returned by "fopen()" is f, +<programlisting> + f->_flag |= _SCF; +</programlisting> +will force the use of "readln()" on input and +<programlisting> + f->_flag |= _RBF; +</programlisting> +will force the use of "read()". This trick may be played on +the standard streams "stdin", "stdout" and "stderr" without the +need for calling "fopen()" but before any input is requested +from the stream. </para> </refsect1>
--- a/docs/ccguide/getpid.refentry Fri Nov 15 21:49:51 2002 +0000 +++ b/docs/ccguide/getpid.refentry Fri Nov 15 21:49:51 2002 +0000 @@ -22,15 +22,16 @@ <refsect1><title>Description</title> <para> -Placeholder +A number unique to the current running task is often useful in +creating names for temporary files. This call returns the +task's system id (as returned to its parent by "os9fork"). </para> </refsect1> - -<refsect1><title>See Also</title> +<refsect1><title>Description</title> <para> <link linkend="os9fork">os9fork()</link>, Standard Library function -<link linkend="mktemp">mktemp()</link>. +<link linkend="mktemp">mktemp</link>. </para> </refsect1> </refentry>