Back to index

tetex-bin  3.0
str-list.h
Go to the documentation of this file.
00001 /* str-list.h: Declarations for string lists.
00002 
00003 Copyright (C) 1993, 94 Karl Berry.
00004 
00005 This library is free software; you can redistribute it and/or
00006 modify it under the terms of the GNU Library General Public
00007 License as published by the Free Software Foundation; either
00008 version 2 of the License, or (at your option) any later version.
00009 
00010 This library is distributed in the hope that it will be useful,
00011 but WITHOUT ANY WARRANTY; without even the implied warranty of
00012 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
00013 Library General Public License for more details.
00014 
00015 You should have received a copy of the GNU Library General Public
00016 License along with this library; if not, write to the Free Software
00017 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.  */
00018 
00019 #ifndef KPATHSEA_STR_LIST_H
00020 #define KPATHSEA_STR_LIST_H
00021 
00022 #include <kpathsea/c-proto.h>
00023 #include <kpathsea/types.h>
00024 
00025 
00026 /* Lists of strings; used for, e.g., directory lists.  */
00027 
00028 typedef struct
00029 {
00030   unsigned length;
00031   string *list;
00032 } str_list_type;
00033 
00034 #define STR_LIST_LENGTH(l) ((l).length)
00035 #define STR_LIST(l) ((l).list)
00036 #define STR_LIST_ELT(l, n) STR_LIST (l)[n]
00037 #define STR_LIST_LAST_ELT(l) STR_LIST_ELT (l, STR_LIST_LENGTH (l) - 1)
00038 
00039 /* Return a new, empty, list.  */
00040 extern str_list_type str_list_init P1H(void);
00041 
00042 /* Append the string S to the list L.  It's up to the caller to not
00043    deallocate S; we don't copy it.  Also up to the caller to terminate
00044    the list with a null entry.  */
00045 extern void str_list_add P2H(str_list_type *l, string s);
00046 
00047 /* Append all the elements from MORE to TARGET.  */
00048 extern void str_list_concat P2H(str_list_type * target, str_list_type more);
00049 
00050 /* Free the space for the list elements (but not the list elements
00051    themselves).  */
00052 extern void str_list_free P1H(str_list_type *l);
00053 
00054 /* Append each element of more to each element of target. */
00055 extern void str_list_concat_elements P2H(str_list_type * target, str_list_type more);
00056 
00057 #endif /* not KPATHSEA_STR_LIST_H */