the_Foundation 1.0
Loading...
Searching...
No Matches
Data Structures | Macros | Functions | Variables
stringlist.h File Reference
#include "object.h"
#include "list.h"
#include "string.h"

Data Structures

struct  iStringListClass
 
struct  iStringList
 
struct  iStringListReverseIterator
 
struct  iStringListReverseConstIterator
 

Macros

#define size_StringList(d)   ((d)->size)
 
#define isEmpty_StringList(d)   ((d)->size == 0)
 
#define takeFirst_StringList(d)   take_StringList(d, 0)
 
#define takeLast_StringList(d)   take_StringList(d, size_StringList(d) - 1)
 

Functions

iStringList * new_StringList (void)
 
void init_StringList (iStringList *d)
 
void deinit_StringList (iStringList *d)
 
void serialize_StringList (const iStringList *, iStream *)
 
void deserialize_StringList (iStringList *, iStream *)
 
iStringList * newStrings_StringList (const iString *,...)
 
iStringList * newStringsCStr_StringList (const char *,...)
 
void clear_StringList (iStringList *)
 
const iString * constAt_StringList (const iStringList *, size_t pos)
 
iString * at_StringList (iStringList *, size_t pos)
 
void pushBack_StringList (iStringList *, const iString *str)
 
void pushBackCStr_StringList (iStringList *, const char *cstr)
 
void pushBackCStrN_StringList (iStringList *, const char *cstr, size_t size)
 
void pushFront_StringList (iStringList *, const iString *str)
 
void pushFrontCStr_StringList (iStringList *, const char *cstr)
 
void popBack_StringList (iStringList *)
 
void popFront_StringList (iStringList *)
 
void insert_StringList (iStringList *, size_t pos, const iString *str)
 
void insertCStr_StringList (iStringList *, size_t pos, const char *cstr)
 
void remove_StringList (iStringList *, size_t pos)
 
iString * take_StringList (iStringList *, size_t pos)
 
iString * joinCStr_StringList (const iStringList *, const char *delim)
 
Iterators
void init_StringListIterator (iStringListIterator *, iStringList *)
 
void next_StringListIterator (iStringListIterator *)
 
void init_StringListReverseIterator (iStringListReverseIterator *, iStringList *)
 
void next_StringListReverseIterator (iStringListReverseIterator *)
 
void remove_StringListIterator (iStringListIterator *)
 
iString * take_StringListIterator (iStringListIterator *)
 
void init_StringListConstIterator (iStringListConstIterator *, const iStringList *)
 
void next_StringListConstIterator (iStringListConstIterator *)
 
void init_StringListReverseConstIterator (iStringListReverseConstIterator *, const iStringList *)
 
void next_StringListReverseConstIterator (iStringListReverseConstIterator *)
 

Variables

iStringListClass Class_StringList
 

Detailed Description

List of strings.

StringList is based on a linked list of relatively short StringArrays. Therefore it is suitable for both small and large numbers of Strings without compromising performance of sequential access, random-access lookups, insertion, or removal.

 Node <--> Node <--> Node <-->
  |         |         |
String    String    String
String    String    String
String              String
                    String
Authors
Copyright (c) 2017 Jaakko Keränen jaakk.nosp@m.o.ke.nosp@m.ranen.nosp@m.@iki.nosp@m..fi
License

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.