home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-dist / octave-1.1.1p1-src.tgz / tar.out / fsf / octave / kpathsea / str-list.h < prev    next >
C/C++ Source or Header  |  1996-09-28  |  2KB  |  55 lines
  1. /* str-list.h: Declarations for string lists.
  2.  
  3. Copyright (C) 1993 Karl Berry.
  4.  
  5. This program is free software; you can redistribute it and/or modify
  6. it under the terms of the GNU General Public License as published by
  7. the Free Software Foundation; either version 2, or (at your option)
  8. any later version.
  9.  
  10. This program is distributed in the hope that it will be useful,
  11. but WITHOUT ANY WARRANTY; without even the implied warranty of
  12. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13. GNU General Public License for more details.
  14.  
  15. You should have received a copy of the GNU General Public License
  16. along with this program; if not, write to the Free Software
  17. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  18.  
  19. #ifndef KPATHSEA_STR_LIST_H
  20. #define KPATHSEA_STR_LIST_H
  21.  
  22. #include <kpathsea/c-proto.h>
  23. #include <kpathsea/types.h>
  24.  
  25.  
  26. /* Lists of strings; used for, e.g., directory lists.  */
  27.  
  28. typedef struct
  29. {
  30.   unsigned length;
  31.   string *list;
  32. } str_list_type;
  33.  
  34. #define STR_LIST_LENGTH(l) ((l).length)
  35. #define STR_LIST(l) ((l).list)
  36. #define STR_LIST_ELT(l, n) STR_LIST (l)[n]
  37. #define STR_LIST_LAST_ELT(l) STR_LIST_ELT (l, STR_LIST_LENGTH (l) - 1)
  38.  
  39. /* Return a new, empty, list.  */
  40. extern str_list_type str_list_init P1H(void);
  41.  
  42. /* Save the string S in the list L.  It's up to the caller to not
  43.    deallocate S; we don't copy it.  Also up to the caller to terminate
  44.    the list with a null entry.  */
  45. extern void str_list_add P2H(str_list_type *l, string s);
  46.  
  47. /* Append all the elements from MORE to TARGET.  */
  48. extern void str_list_concat P2H(str_list_type * target, str_list_type more);
  49.  
  50. /* Free the space for the list elements (but not the list elements
  51.    themselves).  */
  52. extern void str_list_free P1H(str_list_type *l);
  53.  
  54. #endif /* not KPATHSEA_STR_LIST_H */
  55.