fg_string.h File Reference

Functions to manipulate strings used by Flowgrind. More...

#include "config.h"

Go to the source code of this file.

Functions
int	asprintf_append (char **resultp, const char *fmt,...) __attribute__((format(printf
	Realloc resultp to append the formatted result of fmt and return a pointer to it via the first argument. More...
size_t	fmtlen (char const *fmt, va_list ap)
	Determine the number of characters that would be generated by a printf with format string fmt and arguments ap. More...
char *	strdup_append (char *s, const char *a)
	Append the duplication of string a to the given string s. More...
char *	strndup_append (char *s, const char *a, size_t n)
	Append at most n characters of the duplication of string a to the given string s. More...
int int	vasprintf_append (char **resultp, const char *fmt, va_list ap) __attribute__((format(printf
	Realloc resultp to append the formatted result of fmt and ap and return a pointer to it via the first argument. More...

Detailed Description

Functions to manipulate strings used by Flowgrind.

Definition in file fg_string.h.

Function Documentation

asprintf_append()

int asprintf_append	(	char **	resultp,
		const char *	fmt,
			...
	)

Realloc resultp to append the formatted result of fmt and return a pointer to it via the first argument.

Good for gradually accumulating output into a string buffer. Appends at the end of the string

Parameters

[in,out]	resultp	destination string to append to
[in]	fmt	format string
[in]	...	parameters used to fill fmt

Returns

return the number of bytes printed for success, or -1 for failure

fmtlen()

size_t fmtlen	(	char const *	fmt,
		va_list	ap
	)

Determine the number of characters that would be generated by a printf with format string fmt and arguments ap.

Parameters

[in]	fmt	format string
[in]	ap	parameters used to fill fmt

Returns

number of number of characters

Definition at line 61 of file fg_string.c.

{
        va_list ap2;
        char c;
 
        /* If the output of vsnprintf is truncated, its return value is the
         * number of characters which would have been written to the string
         * if enough space had been available */
        va_copy(ap2, ap);
        size_t length = vsnprintf(&c, 1, fmt, ap2);
        va_end(ap2);
 
        return length;
}

strdup_append()

char* strdup_append	(	char *	s,
		const char *	a
	)

Append the duplication of string a to the given string s.

Parameters

[in]	s	destination string to append to
[in]	a	source string to be append

Returns

concatenated strings, NULL on error

Definition at line 76 of file fg_string.c.

{
        if (unlikely(!s))
                return strdup(a);
 
        if (unlikely(!a))
                return s;
 
        return strlendup_append(s, strlen(s), a, strlen(a));
}

strndup_append()

char* strndup_append	(	char *	s,
		const char *	a,
		size_t	n
	)

Append at most n characters of the duplication of string a to the given string s.

Parameters

[in]	s	destination string to append to
[in]	a	source string to be append
[in]	n	number of characters to be append from the string

Returns

concatenated strings, NULL on error

Definition at line 87 of file fg_string.c.

{
        if (unlikely(!s))
                return strdup(a);
 
        if (unlikely(!a))
                return s;
 
        return strlendup_append(s, strlen(s), a, strnlen(a, n));
}

vasprintf_append()

int int vasprintf_append	(	char **	resultp,
		const char *	fmt,
		va_list	ap
	)

Realloc resultp to append the formatted result of fmt and ap and return a pointer to it via the first argument.

Good for gradually accumulating output into a string buffer. Appends at the end of the string.

Parameters

[in,out]	resultp	destination string to append to
[in]	fmt	format string
[in]	ap	parameters used to fill fmt

Returns

return the number of bytes printed for success, or -1 for failure