|
|
1.1 ! root 1: .\" @(#)gets.3s 6.1 (Berkeley) 5/15/85 ! 2: .\" ! 3: .TH GETS 3S "May 15, 1985" ! 4: .AT 3 ! 5: .SH NAME ! 6: gets, fgets \- get a string from a stream ! 7: .SH SYNOPSIS ! 8: .B #include <stdio.h> ! 9: .PP ! 10: .B char *gets(s) ! 11: .br ! 12: .B char *s; ! 13: .PP ! 14: .B char *fgets(s, n, stream) ! 15: .br ! 16: .B char *s; ! 17: .br ! 18: .SM ! 19: .B FILE ! 20: .B *stream; ! 21: .SH DESCRIPTION ! 22: .I Gets ! 23: reads a string into ! 24: .I s ! 25: from the standard input stream ! 26: .BR stdin . ! 27: The string is terminated by a newline ! 28: character, which is replaced in ! 29: .I s ! 30: by a null character. ! 31: .I Gets ! 32: returns its argument. ! 33: .PP ! 34: .I Fgets ! 35: reads ! 36: .IR n \-1 ! 37: characters, or up through a newline ! 38: character, whichever comes first, ! 39: from the ! 40: .I stream ! 41: into the string ! 42: .IR s . ! 43: The last character read into ! 44: .I s ! 45: is followed by a null character. ! 46: .I Fgets ! 47: returns its first argument. ! 48: .SH "SEE ALSO" ! 49: puts(3S), ! 50: getc(3S), ! 51: scanf(3S), ! 52: fread(3S), ! 53: ferror(3S) ! 54: .SH DIAGNOSTICS ! 55: .I Gets ! 56: and ! 57: .I fgets ! 58: return the constant pointer ! 59: .SM ! 60: .B NULL ! 61: upon end of file or error. ! 62: .SH BUGS ! 63: .I Gets ! 64: deletes a newline, ! 65: .I fgets ! 66: keeps it, ! 67: all in the name of backward compatibility.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.