GETC.3
上传用户:jnzhq888
上传日期:2007-01-18
资源大小:51694k
文件大小:1k
源码类别:

操作系统开发

开发平台:

WINDOWS

  1. ." @(#)getc.3s 6.2 (Berkeley) 5/14/86
  2. ."
  3. .TH GETC 3  "May 14, 1986"
  4. .AT 3
  5. .SH NAME
  6. getc, getchar, fgetc, getw - get character or word from stream
  7. .SH SYNOPSIS
  8. .nf
  9. .ft B
  10. #include <stdio.h>
  11. int getc(FILE *fIstreamfP)
  12. int getchar(void)
  13. int fgetc(FILE *fIstreamfP)
  14. int getw(FILE *fIstreamfP)
  15. .ft R
  16. .fi
  17. .SH DESCRIPTION
  18. .B Getc
  19. returns the next character from the named input
  20. .IR stream .
  21. .PP
  22. .BR Getchar ()
  23. is identical to 
  24. .BR getc ( stdin ).
  25. .PP
  26. .B Fgetc
  27. behaves like 
  28. .BR getc ,
  29. but is a genuine function, not a macro;
  30. it may be used to save object text.
  31. .PP
  32. .B Getw
  33. returns the next
  34. .B int
  35. from the named input
  36. .IR stream .
  37. It returns the constant
  38. .SM
  39. .B EOF
  40. upon end of file or error, but since that is a good
  41. integer value,
  42. .B feof
  43. and
  44. .BR ferror (3)
  45. should be used to check the success of
  46. .BR getw .
  47. .B Getw
  48. assumes no special alignment in the file.
  49. .SH "SEE ALSO"
  50. .BR clearerr (3),
  51. .BR fopen (3),
  52. .BR putc (3),
  53. .BR gets (3),
  54. .BR scanf (3),
  55. .BR fread (3),
  56. .BR ungetc (3).
  57. .SH DIAGNOSTICS
  58. These functions return the integer constant
  59. .SM
  60. .B EOF
  61. at end of file, upon read error,
  62. or if an attempt is made to read a file not opened by
  63. .BR fopen .
  64. The end-of-file condition is remembered,
  65. even on a terminal,
  66. and all subsequent attempts to read will return
  67. .B EOF
  68. until the condition is cleared with
  69. .BR clearerr (3).
  70. .SH BUGS
  71. Because it is implemented as a macro,
  72. .B getc
  73. treats a
  74. .I stream
  75. argument with side effects incorrectly.
  76. In particular,
  77. `getc(*f++);'
  78. doesn't work sensibly.