home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21fs.zip / octave / kpathsea / str-list.h < prev    next >
C/C++ Source or Header  |  2000-01-15  |  2KB  |  55 lines
  1. /* str-list.h: Declarations for string lists.
  2.  
  3. Copyright (C) 1993, 94 Karl Berry.
  4.  
  5. This library is free software; you can redistribute it and/or
  6. modify it under the terms of the GNU Library General Public
  7. License as published by the Free Software Foundation; either
  8. version 2 of the License, or (at your option) any later version.
  9.  
  10. This library 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 GNU
  13. Library General Public License for more details.
  14.  
  15. You should have received a copy of the GNU Library General Public
  16. License along with this library; if not, write to the Free Software
  17. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 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. /* Append the string S to 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.