home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / gnu / ixemul-39.47-env-bin.lha / man / cat3 / fgetline.0 < prev    next >
Text File  |  1993-12-07  |  2KB  |  67 lines
  1.  
  2. FGETLINE(3)                UNIX Programmer's Manual                FGETLINE(3)
  3.  
  4. NNAAMMEE
  5.      ffggeettlliinnee - get a line from a stream
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _c_h_a_r _*
  11.      ffggeettlliinnee(_F_I_L_E _*_s_t_r_e_a_m, _s_i_z_e___t _*_l_e_n)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The ffggeettlliinnee() function returns a pointer to the next line from the
  15.      stream referenced by _s_t_r_e_a_m. The newline character at the end of the line
  16.      is replaced by a NUL.
  17.  
  18.      If _l_e_n is non­NULL, the length of the line, not counting the terminating
  19.      NUL, is stored in the memory location it references.
  20.  
  21. RREETTUURRNN VVAALLUUEESS
  22.      Upon successful completion a pointer is returned; this pointer becomes
  23.      invalid after the next I/O operation on _s_t_r_e_a_m (whether successful or
  24.      not) or as soon as the stream is closed.  Otherwise, NULL is returned.
  25.      The ffggeettlliinnee() function does not distinguish between end­of­file and er­
  26.      ror; the routines feof(3) and ferror(3) must be used to determine which
  27.      occurred.  If an error occurrs, the global variable _e_r_r_n_o is set to indi­
  28.      cate the error.  The end­of­file condition is remembered, even on a ter­
  29.      minal, and all subsequent attempts to read will return NULL until the
  30.      condition is cleared with clearerr(3).
  31.  
  32.      The text to which the returned pointer points may be modified, provided
  33.      that no changes are made beyond the terminating NUL. These changes are
  34.      lost as soon as the pointer becomes invalid.
  35.  
  36. EERRRROORRSS
  37.      [EBADF]  The argument _s_t_r_e_a_m is not a stream open for reading.
  38.  
  39.      The ffggeettlliinnee() function may also fail and set _e_r_r_n_o for any of the errors
  40.      specified for the routines fflush(3),  malloc(3),  read(2),  stat(2),  or
  41.      realloc(3).
  42.  
  43. SSEEEE AALLSSOO
  44.      ferror(3),  fgets(3),  fopen(3),  putc(3)
  45.  
  46. HHIISSTTOORRYY
  47.      The ffggeettlliinnee() function is currently under development.
  48.  
  49. BBUUGGSS
  50.      It is not possible to tell whether the final line of an input file was
  51.      terminated with a newline.
  52.  
  53. BSD Experimental                April 19, 1991                               1
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.