fwrite man page "error"

Jeffrey E. F. Friedl jeff at unh.UUCP
Wed Feb 22 15:55:21 AEST 1989


Here's a cute one.
I had a user come to me asking about fread/fwrite,
showing me the man page:

    standard fread() man page "SYNTAX" section:

	 fread(ptr, sizeof(*ptr), nitems, stream)
	 char *ptr; unsigned nitems, sizeof(*ptr)
	 FILE *stream;

Pointing to "sizeof(*ptr)" then to "char *ptr", he asked
	"but won't that always be one?"

I never noticed the "error" -- sort of cute, eh? 
I can just imagine a novice user sitting with the man page
and pounding at the program wondering why it doesn't work!

I offered that the following might be better:

---------------vvvvvvv
	 fread((char*)ptr, sizeof(*ptr), nitems, stream)
	 item *ptr; unsigned nitems, sizeof(*ptr)
---------^^^^
	 FILE *stream;

which seems to make things more clear.  I left it at that.
I suppose I should tell him that sizeof(char) is !always 1, though.

	*jeff*

------------------------------------------------------------------------------
Jeffrey Eric Francis Friedl                             Box 2173 Babcock House
..!{uunet,decvax}!unh!jeff                          Durham New Hampshire 03824

Ever worked in Japan? Let me know your "what-to-do, what-never-to-do" stories.
I'm moving there in May (or so -- whenver the Visa comes through).



More information about the Comp.lang.c mailing list