gString.h File Reference

#include "statusMessageReporting.h"

Go to the source code of this file.

Classes
struct	gString_s

Macros
#define	gString_minIncrement   sizeof( char * )

Typedefs
typedef struct gString_s	gString

Functions
int	gString_initialize (statusMessageReporting *smr, gString *gStr, int size, int increment)
int	gString_release (statusMessageReporting *smr, gString *gStr)
int	gString_clear (statusMessageReporting *smr, gString *gStr)
int	gString_addTo (statusMessageReporting *smr, gString *gStr, char const *str)
char const *	gString_string (statusMessageReporting *smr, gString *gStr)
int	gString_length (statusMessageReporting *smr, gString *gStr)
int	gString_allocated (statusMessageReporting *smr, gString *gStr)
int	gString_increment (statusMessageReporting *smr, gString *gStr)

Macro Definition Documentation

gString_minIncrement

#define gString_minIncrement   sizeof( char * )

Definition at line 49 of file gString.h.

Typedef Documentation

gString

typedef struct gString_s gString

Definition at line 50 of file gString.h.

Function Documentation

gString_addTo()

int gString_addTo	(	statusMessageReporting *	smr,
		gString *	gStr,
		char const *	str
	)

Definition at line 90 of file gString.cc.

                                                                                 {
 
    int n, size = strlen( str );
 
    if( gStr->gStr == NULL ) {
        if( gString_initialize( smr, gStr, size + 1, gStr->increment ) != 0 ) return( 1 ); }
    else if( ( gStr->length + size ) > gStr->allocated ) {
        n = gStr->increment;
        if( n < size ) n = size;
        //if( ( gStr->gStr = xData_realloc2( smr, gStr->gStr, gStr->allocated + n, "gStr->gStr" ) ) == NULL ) return( 1 );
        if( ( gStr->gStr = (char*) xData_realloc2( smr, gStr->gStr, gStr->allocated + n, "gStr->gStr" ) ) == NULL ) return( 1 );
        gStr->allocated += n;
    }
    strcpy( &(gStr->gStr[gStr->length - 1]), str );
    gStr->length = gStr->length + size;
    return( 0 );
}

Referenced by tpi_channelID_toStringSans(), and tpi_spectralID_toStringSans().

gString_allocated()

int gString_allocated	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 127 of file gString.cc.

                                                                 {
 
    return( gStr->allocated );
}

gString_clear()

int gString_clear	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 79 of file gString.cc.

                                                             {
 
    if( gStr->gStr != NULL ) {
        gStr->length = 1;
        gStr->gStr[0] = 0;
    }
    return( 0 );
}

gString_increment()

int gString_increment	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 135 of file gString.cc.

                                                                 {
 
    return( gStr->increment );
}

gString_initialize()

int gString_initialize	(	statusMessageReporting *	smr,
		gString *	gStr,
		int	size,
		int	increment
	)

Definition at line 48 of file gString.cc.

                                                                                              {
 
    if( size > 0 ) {
        //if( ( gStr->gStr = xData_malloc2( smr, size + 1, 0, "gStr->gStr" ) ) == NULL ) return( 1 );
        if( ( gStr->gStr = (char*) xData_malloc2( smr, size + 1, 0, "gStr->gStr" ) ) == NULL ) return( 1 );
        gStr->length = 1;
        gStr->gStr[0] = 0; }
    else {
        size = 0;
        gStr->length = 0;
        gStr->gStr = NULL;
    }
    gStr->allocated = size;
    //if( increment < gString_minIncrement ) increment = gString_minIncrement;
    if( increment < (int) gString_minIncrement ) increment = gString_minIncrement;
    gStr->increment = increment;
    return( 0 );
}

Referenced by gString_addTo(), and gString_release().

gString_length()

int gString_length	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 119 of file gString.cc.

                                                              {
 
    return( gStr->length );
}

gString_release()

int gString_release	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 69 of file gString.cc.

                                                                  {
 
    if( gStr->gStr != NULL ) free( gStr->gStr );
    gString_initialize( smr, gStr, 0, gStr->increment );
    return( 0 );
}

gString_string()

char const * gString_string	(	statusMessageReporting *	smr,
		gString *	gStr
	)

Definition at line 111 of file gString.cc.

                                                                      {
 
    return( gStr->gStr );
}