dstring.c File Reference

#include "nsd.h"

Functions
char *	Ns_DStringVarAppend (Ns_DString *dsPtr,...)
char *	Ns_DStringExport (Ns_DString *dsPtr)
char *	Ns_DStringAppendArg (Ns_DString *dsPtr, char *string)
char *	Ns_DStringPrintf (Ns_DString *dsPtr, char *fmt,...)
char **	Ns_DStringAppendArgv (Ns_DString *dsPtr)
Ns_DString *	Ns_DStringPop (void)
void	Ns_DStringPush (Ns_DString *dsPtr)
void	Ns_DStringInit (Ns_DString *dsPtr)
void	Ns_DStringFree (Ns_DString *dsPtr)
void	Ns_DStringSetLength (Ns_DString *dsPtr, int length)
void	Ns_DStringTrunc (Ns_DString *dsPtr, int length)
char *	Ns_DStringNAppend (Ns_DString *dsPtr, char *string, int length)
char *	Ns_DStringAppend (Ns_DString *dsPtr, char *string)
char *	Ns_DStringAppendElement (Ns_DString *dsPtr, char *string)
int	Ns_DStringLength (Ns_DString *dsPtr)
char *	Ns_DStringValue (Ns_DString *dsPtr)

---

Function Documentation

char* Ns_DStringAppend	(	Ns_DString *	dsPtr,
		char *	string
	)

char* Ns_DStringAppendArg	(	Ns_DString *	dsPtr,
		char *	string
	)

---------------------------------------------------------------------- Ns_DStringAppendArg --

Append a string including its terminating null byte.

Results: Pointer to the current string value.

Side effects: None.

----------------------------------------------------------------------

char** Ns_DStringAppendArgv

(

Ns_DString *

dsPtr

)

---------------------------------------------------------------------- Ns_DStringAppendArgv --

Append an argv vector pointing to the null terminated strings in the given dstring.

Results: Pointer char ** vector appended to end of dstring.

Side effects: None.

----------------------------------------------------------------------

Determine the number of strings.

Resize the dstring with space for the argv aligned on an 8 byte boundry.

Set the argv elements to the strings.

char* Ns_DStringAppendElement	(	Ns_DString *	dsPtr,
		char *	string
	)

char* Ns_DStringExport

(

Ns_DString *

dsPtr

)

----------------------------------------------------------------------

Ns_DStringExport --

Return a copy of the string value on the heap. Ns_DString is left in an initialized state.

Results: Pointer to ns_malloc'ed string which must be eventually freed.

Side effects: None.

----------------------------------------------------------------------

void Ns_DStringFree

(

Ns_DString *

dsPtr

)

void Ns_DStringInit

(

Ns_DString *

dsPtr

)

---------------------------------------------------------------------- Compatibility routines --

Wrappers for old Ns_DString functions.

Results: See Tcl_DString routine.

Side effects: See Tcl_DString routine.

----------------------------------------------------------------------

int Ns_DStringLength

(

Ns_DString *

dsPtr

)

char* Ns_DStringNAppend	(	Ns_DString *	dsPtr,
		char *	string,
		int	length
	)

Ns_DString* Ns_DStringPop

(

void

)

---------------------------------------------------------------------- Ns_DStringPop --

Allocate a new dstring.

Results: Pointer to Ns_DString.

Side effects: None.

----------------------------------------------------------------------

char* Ns_DStringPrintf	(	Ns_DString *	dsPtr,
		char *	fmt,
			...
	)

---------------------------------------------------------------------- Ns_DStringPrintf --

Append a sequence of values using a format string

Results: Pointer to the current string value.

Side effects: None.

----------------------------------------------------------------------

void Ns_DStringPush

(

Ns_DString *

dsPtr

)

---------------------------------------------------------------------- Ns_DStringPush --

Free a dstring.

Results: None.

Side effects: None.

----------------------------------------------------------------------

void Ns_DStringSetLength	(	Ns_DString *	dsPtr,
		int	length
	)

void Ns_DStringTrunc	(	Ns_DString *	dsPtr,
		int	length
	)

char* Ns_DStringValue

(

Ns_DString *

dsPtr

)

char* Ns_DStringVarAppend	(	Ns_DString *	dsPtr,
			...
	)

----------------------------------------------------------------------

Ns_DStringVarAppend --

Append a variable number of string arguments to a dstring.

Results: Pointer to current dstring value.

Side effects: None.

----------------------------------------------------------------------

---