home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 (Developer) / NS_dev_3.2.iso / NextDeveloper / Source / GNU / cctools / as / input-file.h < prev    next >
C/C++ Source or Header  |  1990-12-07  |  2KB  |  58 lines
  1. /* input_file.h header for input-file.c
  2.    Copyright (C) 1987 Free Software Foundation, Inc.
  3.  
  4. This file is part of GAS, the GNU Assembler.
  5.  
  6. GAS is free software; you can redistribute it and/or modify
  7. it under the terms of the GNU General Public License as published by
  8. the Free Software Foundation; either version 1, or (at your option)
  9. any later version.
  10.  
  11. GAS is distributed in the hope that it will be useful,
  12. but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14. GNU General Public License for more details.
  15.  
  16. You should have received a copy of the GNU General Public License
  17. along with GAS; see the file COPYING.  If not, write to
  18. the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19.  
  20. /*"input_file.c":Operating-system dependant functions to read source files.*/
  21.  
  22.  
  23. /*
  24.  * No matter what the operating system, this module must provide the
  25.  * following services to its callers.
  26.  *
  27.  * input_file_begin()            Call once before anything else.
  28.  *
  29.  * input_file_end()            Call once after everything else.
  30.  *
  31.  * input_file_buffer_size()        Call anytime. Returns largest possible
  32.  *                    delivery from
  33.  *                    input_file_give_next_buffer().
  34.  *
  35.  * input_file_open(name)        Call once for each input file.
  36.  *
  37.  * input_file_give_next_buffer(where)    Call once to get each new buffer.
  38.  *                    Return 0: no more chars left in file,
  39.  *                       the file has already been closed.
  40.  *                    Otherwise: return a pointer to just
  41.  *                       after the last character we read
  42.  *                       into the buffer.
  43.  *                    If we can only read 0 characters, then
  44.  *                    end-of-file is faked.
  45.  *
  46.  * All errors are reported (using as_perror) so caller doesn't have to think
  47.  * about I/O errors. No I/O errors are fatal: an end-of-file may be faked.
  48.  */
  49.  
  50. void    input_file_begin();
  51. void    input_file_end();
  52. int    input_file_buffer_size();
  53. int    input_file_is_open();
  54. void    input_file_open();
  55. char *    input_file_give_next_buffer();
  56.  
  57. /* end: input_file.h */
  58.