gwenhywfar  4.6.0beta
Macros | Functions
stringlist.c File Reference
#include <gwenhywfar/gwenhywfarapi.h>
#include <gwenhywfar/misc.h>
#include "stringlist_p.h"
#include "debug.h"
#include <stdlib.h>
#include <assert.h>
#include <string.h>

Go to the source code of this file.

Macros

#define DISABLE_DEBUGLOG
 

Functions

static int GWEN_StringList__compar_asc_case (const void *a, const void *b)
 
static int GWEN_StringList__compar_asc_int (const void *a, const void *b)
 
static int GWEN_StringList__compar_asc_nocase (const void *a, const void *b)
 
static int GWEN_StringList__compar_desc_case (const void *a, const void *b)
 
static int GWEN_StringList__compar_desc_int (const void *a, const void *b)
 
static int GWEN_StringList__compar_desc_nocase (const void *a, const void *b)
 
void GWEN_StringList_AppendEntry (GWEN_STRINGLIST *sl, GWEN_STRINGLISTENTRY *se)
 
int GWEN_StringList_AppendString (GWEN_STRINGLIST *sl, const char *s, int take, int checkDouble)
 
void GWEN_StringList_Clear (GWEN_STRINGLIST *sl)
 
unsigned int GWEN_StringList_Count (const GWEN_STRINGLIST *sl)
 
GWEN_STRINGLISTGWEN_StringList_dup (const GWEN_STRINGLIST *sl)
 
GWEN_STRINGLISTENTRYGWEN_StringList_FirstEntry (const GWEN_STRINGLIST *sl)
 
const char * GWEN_StringList_FirstString (const GWEN_STRINGLIST *l)
 
void * GWEN_StringList_ForEach (const GWEN_STRINGLIST *l, void *(*func)(const char *s, void *u), void *user_data)
 
void GWEN_StringList_free (GWEN_STRINGLIST *sl)
 
GWEN_STRINGLISTGWEN_StringList_fromString (const char *str, const char *delimiters, int checkDouble)
 
GWEN_STRINGLISTGWEN_StringList_fromTabString (const char *s, int checkDup)
 
int GWEN_StringList_GetStringPos (const GWEN_STRINGLIST *sl, const char *s)
 
int GWEN_StringList_HasString (const GWEN_STRINGLIST *sl, const char *s)
 
int GWEN_StringList_InsertString (GWEN_STRINGLIST *sl, const char *s, int take, int checkDouble)
 
GWEN_STRINGLISTGWEN_StringList_new (void)
 
void GWEN_StringList_RemoveEntry (GWEN_STRINGLIST *sl, GWEN_STRINGLISTENTRY *se)
 
GWENHYWFAR_API int GWEN_StringList_RemoveString (GWEN_STRINGLIST *sl, const char *s)
 
void GWEN_StringList_SetIgnoreRefCount (GWEN_STRINGLIST *sl, int i)
 
void GWEN_StringList_SetSenseCase (GWEN_STRINGLIST *sl, int i)
 
void GWEN_StringList_Sort (GWEN_STRINGLIST *l, int ascending, GWEN_STRINGLIST_SORT_MODE sortMode)
 
const char * GWEN_StringList_StringAt (const GWEN_STRINGLIST *sl, int idx)
 
const char * GWEN_StringListEntry_Data (const GWEN_STRINGLISTENTRY *se)
 
void GWEN_StringListEntry_free (GWEN_STRINGLISTENTRY *sl)
 
GWEN_STRINGLISTENTRYGWEN_StringListEntry_new (const char *s, int take)
 
GWEN_STRINGLISTENTRYGWEN_StringListEntry_Next (const GWEN_STRINGLISTENTRY *se)
 
void GWEN_StringListEntry_ReplaceString (GWEN_STRINGLISTENTRY *e, const char *s, int take)
 

Macro Definition Documentation

#define DISABLE_DEBUGLOG

Definition at line 30 of file stringlist.c.

Function Documentation

static int GWEN_StringList__compar_asc_case ( const void *  a,
const void *  b 
)
static

Definition at line 507 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

static int GWEN_StringList__compar_asc_int ( const void *  a,
const void *  b 
)
static

Definition at line 524 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

static int GWEN_StringList__compar_asc_nocase ( const void *  a,
const void *  b 
)
static

Definition at line 491 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

static int GWEN_StringList__compar_desc_case ( const void *  a,
const void *  b 
)
static

Definition at line 515 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

static int GWEN_StringList__compar_desc_int ( const void *  a,
const void *  b 
)
static

Definition at line 533 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

static int GWEN_StringList__compar_desc_nocase ( const void *  a,
const void *  b 
)
static

Definition at line 499 of file stringlist.c.

Referenced by GWEN_StringList_Sort().

void GWEN_StringList_AppendEntry ( GWEN_STRINGLIST sl,
GWEN_STRINGLISTENTRY se 
)

Definition at line 128 of file stringlist.c.

Referenced by GWEN_StringList_AppendString(), and GWEN_StringList_dup().

int GWEN_StringList_AppendString ( GWEN_STRINGLIST sl,
const char *  s,
int  take,
int  checkDouble 
)
void GWEN_StringList_Clear ( GWEN_STRINGLIST sl)
unsigned int GWEN_StringList_Count ( const GWEN_STRINGLIST sl)
GWEN_STRINGLIST* GWEN_StringList_dup ( const GWEN_STRINGLIST sl)
GWEN_STRINGLISTENTRY* GWEN_StringList_FirstEntry ( const GWEN_STRINGLIST sl)
const char* GWEN_StringList_FirstString ( const GWEN_STRINGLIST l)

Returns the first string in this list.

Definition at line 482 of file stringlist.c.

Referenced by GWEN_I18N_ModuleInit().

void* GWEN_StringList_ForEach ( const GWEN_STRINGLIST l,
void *(*)(const char *s, void *u)  func,
void *  user_data 
)

Traverses the list, calling the callback function 'func' on each list element. Traversal will stop when 'func' returns a non-NULL value, and the routine will return with that value. Otherwise the routine will return NULL.

Parameters
lThe list to traverse.
funcThe function to be called with each list element.
user_dataA pointer passed on to the function 'func'.
Returns
The non-NULL pointer returned by 'func' as soon as it returns one. Otherwise (i.e. 'func' always returns NULL) returns NULL.

Definition at line 458 of file stringlist.c.

References GWEN_StringList_FirstEntry(), GWEN_StringListEntry_Data(), and GWEN_StringListEntry_Next().

Referenced by print_paths().

void GWEN_StringList_free ( GWEN_STRINGLIST sl)
GWEN_STRINGLIST* GWEN_StringList_fromString ( const char *  str,
const char *  delimiters,
int  checkDouble 
)
GWEN_STRINGLIST* GWEN_StringList_fromTabString ( const char *  s,
int  checkDup 
)

Definition at line 150 of file stringlist.c.

References GWEN_StringList_AppendString(), and GWEN_StringList_new().

int GWEN_StringList_GetStringPos ( const GWEN_STRINGLIST sl,
const char *  s 
)

Returns the position of the given string within the stringlist.

Returns
position, -1 if not found

Definition at line 406 of file stringlist.c.

int GWEN_StringList_HasString ( const GWEN_STRINGLIST sl,
const char *  s 
)

Checks whether the given string already exists within in the string list.

Returns
!=0 if found, 0 otherwise

Definition at line 378 of file stringlist.c.

Referenced by GWEN_Gui_Internal_GetPassword().

int GWEN_StringList_InsertString ( GWEN_STRINGLIST sl,
const char *  s,
int  take,
int  checkDouble 
)

Inserts a string.

Returns
0 if not inserted, !=0 if inserted
Parameters
takeif true then the StringList takes over ownership of the string
checkDoubleif true the the string will only be appended if it does not already exist

Definition at line 268 of file stringlist.c.

References GWEN_StringListEntry_new().

GWEN_STRINGLIST* GWEN_StringList_new ( void  )
void GWEN_StringList_RemoveEntry ( GWEN_STRINGLIST sl,
GWEN_STRINGLISTENTRY se 
)

Definition at line 185 of file stringlist.c.

Referenced by GWEN_StringList_RemoveString().

GWENHYWFAR_API int GWEN_StringList_RemoveString ( GWEN_STRINGLIST sl,
const char *  s 
)

Removes a given string from the stringlist.

Returns
0 if not found, !=0 if found and removed

Definition at line 307 of file stringlist.c.

References GWEN_StringList_RemoveEntry().

Referenced by GWEN_Gui_Internal_GetPassword(), GWEN_Gui_Internal_SetPasswordStatus(), and GWEN_MDigest_CheckFileTree().

void GWEN_StringList_SetIgnoreRefCount ( GWEN_STRINGLIST sl,
int  i 
)

Normally this group of functions ignores reference counters on stringlist entries when removing a string via GWEN_StringList_RemoveString. You can change this behaviour here.

Parameters
slstring list
iif 0 then reference counters are honoured

Definition at line 80 of file stringlist.c.

void GWEN_StringList_SetSenseCase ( GWEN_STRINGLIST sl,
int  i 
)

Normally this group of functions ignores cases when comparing two strings. You can change this behaviour here.

Parameters
slstring list
iif 0 then cases are ignored

Definition at line 73 of file stringlist.c.

void GWEN_StringList_Sort ( GWEN_STRINGLIST l,
int  ascending,
GWEN_STRINGLIST_SORT_MODE  sortMode 
)

Sorts this list. Internally this uses qsort(3), so the sorting should be reasonably fast even for large lists.

Parameters
lThe list to sort.
ascendingIf non-zero, the list is sorted ascending, i.e. smallest string first, according to strcmp(3) rules. If zero, the list is sorted descending.
sortModeSee GWEN_StringList_SortModeNoCase and following

Definition at line 544 of file stringlist.c.

References DBG_ERROR, GWEN_LOGDOMAIN, GWEN_StringList__compar_asc_case(), GWEN_StringList__compar_asc_int(), GWEN_StringList__compar_asc_nocase(), GWEN_StringList__compar_desc_case(), GWEN_StringList__compar_desc_int(), GWEN_StringList__compar_desc_nocase(), GWEN_StringList_SortModeCase, GWEN_StringList_SortModeInt, and GWEN_StringList_SortModeNoCase.

const char* GWEN_StringList_StringAt ( const GWEN_STRINGLIST sl,
int  idx 
)

Definition at line 622 of file stringlist.c.

Referenced by Gtk2Gui_WComboBox_GetCharProperty().

const char* GWEN_StringListEntry_Data ( const GWEN_STRINGLISTENTRY se)
void GWEN_StringListEntry_free ( GWEN_STRINGLISTENTRY sl)

Definition at line 118 of file stringlist.c.

References GWEN_FREE_OBJECT.

Referenced by GWEN_StringList_Clear(), and GWEN_StringList_free().

GWEN_STRINGLISTENTRY* GWEN_StringListEntry_new ( const char *  s,
int  take 
)
GWEN_STRINGLISTENTRY* GWEN_StringListEntry_Next ( const GWEN_STRINGLISTENTRY se)
void GWEN_StringListEntry_ReplaceString ( GWEN_STRINGLISTENTRY e,
const char *  s,
int  take 
)

Definition at line 104 of file stringlist.c.