--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/genericopenlibs/cstdlib/LSTDIO/FREAD.C Tue Feb 02 02:01:42 2010 +0200
@@ -0,0 +1,111 @@
+/* FREAD.C
+ *
+ * Portions Copyright (c) 1990-2005 Nokia Corporation and/or its subsidiary(-ies).
+ * All rights reserved.
+ */
+
+/*
+ * Copyright (c) 1990 The Regents of the University of California.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms are permitted
+ * provided that the above copyright notice and this paragraph are
+ * duplicated in all such forms and that any documentation,
+ * advertising materials, and other materials related to such
+ * distribution and use acknowledge that the software was developed
+ * by the University of California, Berkeley. The name of the
+ * University may not be used to endorse or promote products derived
+ * from this software without specific prior written permission.
+ * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+ */
+
+/*
+FUNCTION
+<<fread>>---read array elements from a file
+
+INDEX
+ fread
+
+ANSI_SYNOPSIS
+ #include <stdio.h>
+ size_t fread(void *<[buf]>, size_t <[size]>, size_t <[count]>,
+ FILE *<[fp]>);
+
+TRAD_SYNOPSIS
+ #include <stdio.h>
+ size_t fread(<[buf]>, <[size]>, <[count]>, <[fp]>)
+ char *<[buf]>;
+ size_t <[size]>;
+ size_t <[count]>;
+ FILE *<[fp]>;
+
+DESCRIPTION
+<<fread>> attempts to copy, from the file or stream identified by
+<[fp]>, <[count]> elements (each of size <[size]>) into memory,
+starting at <[buf]>. <<fread>> may copy fewer elements than
+<[count]> if an error, or end of file, intervenes.
+
+<<fread>> also advances the file position indicator (if any) for
+<[fp]> by the number of @emph{characters} actually read.
+
+RETURNS
+The result of <<fread>> is the number of elements it succeeded in
+reading.
+
+PORTABILITY
+ANSI C requires <<fread>>.
+
+Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
+<<lseek>>, <<read>>, <<sbrk>>, <<write>>.
+*/
+
+#include <stdio.h>
+#include <string.h>
+#include "LOCAL.H"
+
+/**
+Read block of data from a stream.
+Read count number of items each one with a size of size bytes from the stream
+and stores it in the specified buffer.
+Stream's postion indicator is increased by the number of bytes readed.
+Total amount of bytes read is (size x count).
+@return The total number of items readed is returned.
+@param buf Pointer to the destination structure with a minimum size of (size*count) bytes.
+@param size Size in bytes of each item to be read.
+@param count Number of items, each one with a size of size bytes.
+@param fp pointer to an open file.
+*/
+EXPORT_C size_t
+fread (void *buf, size_t size, size_t count, FILE * fp)
+{
+ register size_t resid;
+ register char *p;
+ register int r;
+ size_t total;
+
+ if ((resid = count * size) == 0)
+ return 0;
+ if (fp->_r < 0)
+ fp->_r = 0;
+ total = resid;
+ p = (char*)buf;
+ while ((int)resid > (r = fp->_r))
+ {
+ (void) memcpy ((void *) p, (void *) fp->_p, (size_t) r);
+ fp->_p += r;
+ /* fp->_r = 0 ... done in __srefill */
+ p += r;
+ resid -= r;
+ if (__srefill (fp))
+ {
+ /* no more input: return partial result */
+ return (total - resid) / size;
+ }
+ }
+ (void) memcpy ((void *) p, (void *) fp->_p, resid);
+ fp->_r -= resid;
+ fp->_p += resid;
+ return count;
+}