inc/dystring.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	dyString
Defines
#define	dyStringNew   newDyString
#define	dyStringFree(a)   freeDyString(a);
#define	dyStringFreeList(a)   freeDyStringList(a);
#define	dyStringClear(ds)   (ds->string[0] = ds->stringSize = 0)
Functions
dyString *	newDyString (int initialBufSize)
void	freeDyString (struct dyString **pDs)
void	freeDyStringList (struct dyString **pDs)
void	dyStringAppend (struct dyString *ds, char *string)
void	dyStringAppendN (struct dyString *ds, char *string, int stringSize)
char	dyStringAppendC (struct dyString *ds, char c)
void	dyStringAppendMultiC (struct dyString *ds, char c, int n)
void	dyStringAppendEscapeQuotes (struct dyString *dy, char *string, char quot, char esc)
void	dyStringVaPrintf (struct dyString *ds, char *format, va_list args)
void	dyStringPrintf (struct dyString *ds, char *format,...)
dyString *	dyStringSub (char *orig, char *in, char *out)
void	dyStringBumpBufSize (struct dyString *ds, int size)
char *	dyStringCannibalize (struct dyString **pDy)
void	dyStringResize (struct dyString *ds, int newSize)

---

Define Documentation

#define dyStringClear

(

ds

)

(ds->string[0] = ds->stringSize = 0)

Definition at line 60 of file dystring.h.

Referenced by dtdxTag(), emblLineGroup(), lineFileParseHttpHeader(), lineFileSlurpHttpBody(), netHttpGetMultiple(), nextBlock(), parseDatabaseLines(), readPartHeaderMB(), saveAxtBundle(), transQuery(), transTransQuery(), xapEndTag(), xpLookup(), xpParseEndTag(), xpParseNext(), and xpParseStartTag().

#define dyStringFree

(

a

)

freeDyString(a);

Definition at line 27 of file dystring.h.

Referenced by dnaMotifToLogoPGM(), dnaMotifToLogoPng(), dtdParse(), errCatchFree(), getWormGeneExonDna(), htmlPageFromForm(), htmlSlurpWithCookies(), lineFileParseHttpHeader(), lineFileVaAbort(), netGetOpenFtp(), netHttpConnect(), netHttpGet(), netSkipHttpHeaderLines(), outputFa(), pslGetCreateSql(), qaStatusSoftError(), readPartHeaderMB(), saveAxtBundle(), sendFtpCommand(), sqlByteArrayToString(), sqlCharArrayToString(), sqlDoubleArrayToString(), sqlFloatArrayToString(), sqlLongLongArrayToString(), sqlShortArrayToString(), sqlSignedArrayToString(), sqlStringArrayToString(), sqlUbyteArrayToString(), sqlUnsignedArrayToString(), and sqlUshortArrayToString().

#define dyStringFreeList

(

a

)

freeDyStringList(a);

Definition at line 32 of file dystring.h.

#define dyStringNew   newDyString

Definition at line 22 of file dystring.h.

Referenced by dnaMotifToLogoPGM(), dnaMotifToLogoPng(), dtdParse(), errCatchNew(), hashToRaString(), htmlExpandUrl(), htmlPageFromForm(), htmlSlurpWithCookies(), joinCmd(), joinCmds(), lineFileVaAbort(), parseDatabaseLines(), parseFacility(), parseMultiParts(), qaStatusSoftError(), quotedPrintableEncode(), and readPartHeaderMB().

---

Function Documentation

void dyStringAppend	(	struct dyString *	ds,
		char *	string
	)

Definition at line 115 of file dystring.c.

References ds, and dyStringAppendN().

Referenced by appendCgiVar(), appendMimeTerminus(), appendMimeVar(), cgiParseMultipart(), cgiUrlString(), cookieOutput(), dnaMotifToLogoPGM(), dnaMotifToLogoPng(), emblLineGroup(), expandEntities(), hashToRaString(), htmlExpandUrl(), htmlPageFromForm(), htmlSlurpWithCookies(), joinCmd(), joinCmds(), netHttpConnect(), netHttpGet(), netHttpGetMultiple(), outputFa(), parseBlockLine(), parseDatabaseLines(), parseFacility(), qaStatusSoftError(), readPartHeaderMB(), xapEndTag(), and xpLookup().

{
dyStringAppendN(ds, string, strlen(string));
}

Here is the call graph for this function:

Here is the caller graph for this function:

char dyStringAppendC	(	struct dyString *	ds,
		char	c
	)

Definition at line 88 of file dystring.c.

References ds, and dyStringExpandBuf().

Referenced by appendCgiVar(), cookieOutput(), dtdxTag(), dyStringAppendEscapeQuotes(), emblLineGroup(), errCatchWarnHandler(), expandEntities(), hashToRaString(), htmlExpandUrl(), lineFileParseHttpHeader(), lineFileSlurpHttpBody(), nodeNames(), phyloFindPath(), qaStatusSoftError(), quotedPrintableEncode(), xpLookup(), xpParseEndTag(), xpParseNext(), xpParseStartTag(), and xpTextUntil().

{
char *s;
if (ds->stringSize >= ds->bufSize)
     dyStringExpandBuf(ds, ds->bufSize+256);
s = ds->string + ds->stringSize++;
*s++ = c;
*s = 0;
return c;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void dyStringAppendEscapeQuotes	(	struct dyString *	dy,
		char *	string,
		char	quot,
		char	esc
	)

Definition at line 121 of file dystring.c.

References dyStringAppendC().

{
char c;
char *s = string;
while ((c = *s++) != 0)
     {
     if (c == quot)
         dyStringAppendC(dy, esc);
     dyStringAppendC(dy, c);
     }
}

Here is the call graph for this function:

void dyStringAppendMultiC	(	struct dyString *	ds,
		char	c,
		int	n
	)

Definition at line 100 of file dystring.c.

References ds, and dyStringExpandBuf().

Referenced by saveAxtBundle().

{
int oldSize = ds->stringSize;
int newSize = oldSize + n;
int newAllocSize = newSize + oldSize;
char *buf;
if (newSize > ds->bufSize)
    dyStringExpandBuf(ds,newAllocSize);
buf = ds->string;
memset(buf+oldSize, c, n);
ds->stringSize = newSize;
buf[newSize] = 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void dyStringAppendN	(	struct dyString *	ds,
		char *	string,
		int	stringSize
	)

Definition at line 73 of file dystring.c.

References ds, and dyStringExpandBuf().

Referenced by appendMimeVar(), dyStringAppend(), dyStringSub(), getWormGeneExonDna(), htmlExpandUrl(), lineFileParseHttpHeader(), lineFileSlurpHttpBody(), netSlurpFile(), nodeNames(), parseMultiParts(), phyloFindPath(), saveAxtBundle(), sendFtpCommand(), and xpTextUntil().

{
int oldSize = ds->stringSize;
int newSize = oldSize + stringSize;
int newAllocSize = newSize + oldSize;
char *buf;
if (newSize > ds->bufSize)
    dyStringExpandBuf(ds,newAllocSize);
buf = ds->string;
memcpy(buf+oldSize, string, stringSize);
ds->stringSize = newSize;
buf[newSize] = 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void dyStringBumpBufSize	(	struct dyString *	ds,
		int	size
	)

Definition at line 66 of file dystring.c.

References ds, and dyStringExpandBuf().

{
if (ds->bufSize < size)
    dyStringExpandBuf(ds, size);
}

Here is the call graph for this function:

char* dyStringCannibalize

(

struct dyString **

pDy

)

Definition at line 34 of file dystring.c.

References ds, and freez().

Referenced by hashToRaString(), htmlExpandUrl(), htmlPageFromForm(), htmlSlurpWithCookies(), joinCmd(), joinCmds(), parseMultiParts(), and quotedPrintableEncode().

{
char *s;
struct dyString *ds = *pDy;
assert(ds != NULL);
s = ds->string;
freez(pDy);
return s;
}

Here is the call graph for this function:

Here is the caller graph for this function:

void dyStringPrintf	(	struct dyString *	ds,
		char *	format,
			...
	)

Definition at line 167 of file dystring.c.

References ds, and dyStringVaPrintf().

Referenced by cgiParseMultipart(), cgiUrlString(), dnaMotifToLogoPGM(), dnaMotifToLogoPng(), htmlPageFromForm(), lineFileVaAbort(), netHttpConnect(), netHttpGet(), netSkipHttpHeaderLines(), outputFa(), parseMultiParts(), pslGetCreateSql(), qaStatusOnPage(), quotedPrintableEncode(), sqlByteArrayToString(), sqlCharArrayToString(), sqlDoubleArrayToString(), sqlFloatArrayToString(), sqlLongLongArrayToString(), sqlShortArrayToString(), sqlSignedArrayToString(), sqlStringArrayToString(), sqlUbyteArrayToString(), sqlUnsignedArrayToString(), sqlUshortArrayToString(), transQuery(), and transTransQuery().

{
va_list args;
va_start(args, format);
dyStringVaPrintf(ds, format, args);
va_end(args);
}

Here is the call graph for this function:

Here is the caller graph for this function:

void dyStringResize	(	struct dyString *	ds,
		int	newSize
	)

Definition at line 204 of file dystring.c.

References ds, and dyStringExpandBuf().

{
int oldSize = ds->stringSize;
if (newSize > oldSize)
    {
    /* grow */
    if (newSize > ds->bufSize)
        dyStringExpandBuf(ds, newSize + ds->stringSize);
    memset(ds->string+newSize, ' ', newSize);
    }
ds->string[newSize] = '\0';
ds->stringSize = newSize;
}

Here is the call graph for this function:

struct dyString* dyStringSub	(	char *	orig,
		char *	in,
		char *	out
	)			[read]

Definition at line 176 of file dystring.c.

References dyStringAppendN(), newDyString(), and stringIn.

{
int inLen = strlen(in), outLen = strlen(out), origLen = strlen(orig);
struct dyString *dy = newDyString(origLen + 2*outLen);
char *s, *e;

if (orig == NULL) return NULL;
for (s = orig; ;)
    {
    e = stringIn(in, s);
    if (e == NULL) 
        {
        e = orig + origLen;
        dyStringAppendN(dy, s, e - s);
        break;
        }
    else
        {
        dyStringAppendN(dy, s, e - s);
        dyStringAppendN(dy, out, outLen);
        s = e + inLen;
        }
    }
return dy;
}

Here is the call graph for this function:

void dyStringVaPrintf	(	struct dyString *	ds,
		char *	format,
		va_list	args
	)

Definition at line 135 of file dystring.c.

References ds, dyStringExpandBuf(), TRUE, and va_copy.

Referenced by dyStringPrintf(), errCatchWarnHandler(), lineFileVaAbort(), and qaStatusSoftError().

{
/* attempt to format the string in the current space.  If there
 * is not enough room, increase the buffer size and try again */
int avail, sz;
while (TRUE) 
    {
    va_list argscp;
    va_copy(argscp, args);
    avail = ds->bufSize - ds->stringSize;
    if (avail <= 0)
        {
        /* Don't pass zero sized buffers to vsnprintf, because who knows
         * if the library function will handle it. */
        dyStringExpandBuf(ds, ds->bufSize+ds->bufSize);
        avail = ds->bufSize - ds->stringSize;
        }
    sz = vsnprintf(ds->string + ds->stringSize, avail, format, argscp);
    va_end(argscp);

    /* note that some version return -1 if too small */
    if ((sz < 0) || (sz >= avail))
        dyStringExpandBuf(ds, ds->bufSize+ds->bufSize);
    else
        {
        ds->stringSize += sz;
        break;
        }
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void freeDyString

(

struct dyString **

pDs

)

Definition at line 23 of file dystring.c.

References ds, freeMem(), and freez().

Referenced by cgiParseMultipart(), freeDyStringList(), parseMultiParts(), transQuery(), xapFree(), and xpFree().

{
struct dyString *ds;
if ((ds = *pDs) != NULL)
    {
    freeMem(ds->string);
    freez(pDs);
    }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void freeDyStringList

(

struct dyString **

pDs

)

Definition at line 47 of file dystring.c.

References ds, freeDyString(), and dyString::next.

{
struct dyString *ds, *next;
for(ds = *pDs; ds != NULL; ds = next)
    {
    next = ds->next;
    freeDyString(&ds);
    }
*pDs = NULL;
}

Here is the call graph for this function:

struct dyString* newDyString

(

int

initialBufSize

)

[read]

Definition at line 11 of file dystring.c.

References AllocVar, ds, and needMem().

Referenced by cgiParseMultipart(), cgiUrlString(), dnaMotifToLogoPGM(), dnaMotifToLogoPng(), dyStringSub(), emblRecord(), getWormGeneExonDna(), htmlFormCgiVars(), lineFileParseHttpHeader(), lineFileSlurpHttpBody(), netHttpConnect(), netHttpGet(), netHttpGetMultiple(), netSkipHttpHeaderLines(), netSlurpFile(), nextBlock(), outputFa(), parseMultiParts(), phyloFindPath(), phyloNodeNames(), pslGetCreateSql(), saveAxtBundle(), sendFtpCommand(), sqlByteArrayToString(), sqlCharArrayToString(), sqlDoubleArrayToString(), sqlFloatArrayToString(), sqlLongLongArrayToString(), sqlShortArrayToString(), sqlSignedArrayToString(), sqlStringArrayToString(), sqlUbyteArrayToString(), sqlUnsignedArrayToString(), sqlUshortArrayToString(), transQuery(), transTransQuery(), xapStartTag(), xpNew(), xpParseNext(), and xpParseStartTag().

{
struct dyString *ds;
AllocVar(ds);
if (initialBufSize == 0)
    initialBufSize = 512;
ds->string = needMem(initialBufSize+1);
ds->bufSize = initialBufSize;
return ds;
}

Here is the call graph for this function:

Here is the caller graph for this function:

---