String Manipulation API.

Files
file	rpmstring.h
	String manipulation helper functions.
Defines
#define	appendStringBuf(sb, s)   appendStringBufAux(sb, s, 0)
#define	appendLineStringBuf(sb, s)   appendStringBufAux(sb, s, 1)
Typedefs
typedef struct StringBufRec *	StringBuf
Functions
static RPM_GNUC_CONST int	rislower (int c)
	Locale insensitive islower(3).
static RPM_GNUC_CONST int	risupper (int c)
	Locale insensitive isupper(3).
static RPM_GNUC_CONST int	risalpha (int c)
	Locale insensitive isalpha(3).
static RPM_GNUC_CONST int	risdigit (int c)
	Locale insensitive isdigit(3).
static RPM_GNUC_CONST int	risalnum (int c)
	Locale insensitive isalnum(3).
static RPM_GNUC_CONST int	risblank (int c)
	Locale insensitive isblank(3).
static RPM_GNUC_CONST int	risspace (int c)
	Locale insensitive isspace(3).
static RPM_GNUC_CONST int	rtolower (int c)
	Locale insensitive tolower(3).
static RPM_GNUC_CONST int	rtoupper (int c)
	Locale insensitive toupper(3).
RPM_GNUC_PURE int	rstrcasecmp (const char *s1, const char *s2)
	Locale insensitive strcasecmp(3).
RPM_GNUC_PURE int	rstrncasecmp (const char *s1, const char *s2, size_t n)
	Locale insensitive strncasecmp(3).
int	rasprintf (char **strp, const char *fmt,...) RPM_GNUC_PRINTF(2
	asprintf() clone
int char *	rstrcat (char **dest, const char *src)
	Concatenate two strings with dynamically (re)allocated memory.
char *	rstrscat (char **dest, const char *arg,...) RPM_GNUC_NULL_TERMINATED
	Concatenate multiple strings with dynamically (re)allocated memory.
size_t	rstrlcpy (char *dest, const char *src, size_t n)
	strlcpy() clone: Copy src to string dest of size n.
char *	stripTrailingChar (char *s, char c)
	Remove occurences of trailing character from string.
StringBuf	newStringBuf (void)
StringBuf	freeStringBuf (StringBuf sb)
void	truncStringBuf (StringBuf sb)
char *	getStringBuf (StringBuf sb)
void	stripTrailingBlanksStringBuf (StringBuf sb)
void	appendStringBufAux (StringBuf sb, const char *s, int nl)

---

Define Documentation

#define appendLineStringBuf	(	sb,
		s		)	appendStringBufAux(sb, s, 1)

Definition at line 189 of file rpmstring.h.

#define appendStringBuf	(	sb,
		s		)	appendStringBufAux(sb, s, 0)

Definition at line 185 of file rpmstring.h.

---

Typedef Documentation

typedef struct StringBufRec* StringBuf

Definition at line 161 of file rpmstring.h.

---

Function Documentation

void appendStringBufAux	(	StringBuf	sb,
		const char *	s,
		int	nl
	)

StringBuf freeStringBuf

(

StringBuf

sb

)

char* getStringBuf

(

StringBuf

sb

)

StringBuf newStringBuf

(

void

)

int rasprintf	(	char **	strp,
		const char *	fmt,
			...
	)

asprintf() clone

Referenced by buildForTarget(), and getTarSpec().

static RPM_GNUC_CONST int risalnum

(

int

c

)

[inline, static]

Locale insensitive isalnum(3).

Definition at line 53 of file rpmstring.h.

References risalpha(), and risdigit().

static RPM_GNUC_CONST int risalpha

(

int

c

)

[inline, static]

Locale insensitive isalpha(3).

Definition at line 37 of file rpmstring.h.

References rislower(), and risupper().

Referenced by risalnum().

static RPM_GNUC_CONST int risblank

(

int

c

)

[inline, static]

Locale insensitive isblank(3).

Definition at line 61 of file rpmstring.h.

Referenced by risspace().

static RPM_GNUC_CONST int risdigit

(

int

c

)

[inline, static]

Locale insensitive isdigit(3).

Definition at line 45 of file rpmstring.h.

Referenced by risalnum().

static RPM_GNUC_CONST int rislower

(

int

c

)

[inline, static]

Locale insensitive islower(3).

Definition at line 21 of file rpmstring.h.

Referenced by risalpha(), and rtoupper().

static RPM_GNUC_CONST int risspace

(

int

c

)

[inline, static]

Locale insensitive isspace(3).

Definition at line 69 of file rpmstring.h.

References risblank().

static RPM_GNUC_CONST int risupper

(

int

c

)

[inline, static]

Locale insensitive isupper(3).

Definition at line 29 of file rpmstring.h.

Referenced by risalpha(), and rtolower().

RPM_GNUC_PURE int rstrcasecmp	(	const char *	s1,
		const char *	s2
	)

Locale insensitive strcasecmp(3).

int char* rstrcat	(	char **	dest,
		const char *	src
	)

Concatenate two strings with dynamically (re)allocated memory.

Parameters:

	dest	pointer to destination string
	src	source string

Returns:

realloc'd dest with src appended

size_t rstrlcpy	(	char *	dest,
		const char *	src,
		size_t	n
	)

strlcpy() clone: Copy src to string dest of size n.

At most n-1 characters will be copied. Always zero-terminates (unless n == 0). Length of src is returned; if retval >= n, truncation occurred.

Parameters:

	dest	destination buffer
	src	string to copy
	n	destination buffer size

Returns:

length of src string

RPM_GNUC_PURE int rstrncasecmp	(	const char *	s1,
		const char *	s2,
		size_t	n
	)

Locale insensitive strncasecmp(3).

char* rstrscat	(	char **	dest,
		const char *	arg,
			...
	)

Concatenate multiple strings with dynamically (re)allocated memory.

Parameters:

	dest	pointer to destination string
	arg	NULL terminated list of strings to concatenate

Returns:

realloc'd dest with strings appended

Referenced by buildForTarget().

static RPM_GNUC_CONST int rtolower

(

int

c

)

[inline, static]

Locale insensitive tolower(3).

Definition at line 77 of file rpmstring.h.

References risupper().

static RPM_GNUC_CONST int rtoupper

(

int

c

)

[inline, static]

Locale insensitive toupper(3).

Definition at line 85 of file rpmstring.h.

References rislower().

void stripTrailingBlanksStringBuf

(

StringBuf

sb

)

char* stripTrailingChar	(	char *	s,
		char	c
	)

Remove occurences of trailing character from string.

Parameters:

	s	string
	c	character to strip

Returns:

string

void truncStringBuf

(

StringBuf

sb

)