buffer.h File Reference

String Buffer Operations. More...

#include <stdlib.h>
#include <stdarg.h>

Go to the source code of this file.

Data Structures

struct  buffer

Defines

#define buffer_putstring(b, s)   (buffer_putlstring(b,s,strlen(s)))
 Appends the string to the end of the buffer.
#define buffer_putliteral(b, l)   (buffer_putlstring(b,l "",sizeof(l)-1))
 Appends the string literal to the end of the buffer.

Functions

void buffer_init (buffer_t *b)
 Initialize a buffer.
void buffer_ubuf (buffer_t *b, char *buf, size_t len)
 Use the provided buffer as a starting buffer.
void buffer_max (buffer_t *b, size_t max)
 Set the maximum size of the buffer.
void buffer_abortonfailure (buffer_t *b, int abortonfailure)
 Set the buffer to call fatal(.
void buffer_free (buffer_t *b)
 Free any resources and memory in use by a buffer.
int buffer_putvfstring (buffer_t *b, const char *format, va_list ap)
 Print the formatted output to the buffer.
int buffer_putfstring (buffer_t *b, const char *format,...) __attribute__((format(printf
 Appends the formatted output to the buffer.
int buffer_putlstring (buffer_t *b, const char *str, size_t len)
 Appends the string to the end of the buffer.
const char * buffer_tostring (buffer_t *b, size_t *size)
 Returns the buffer as a string.
void buffer_rewind (buffer_t *b, size_t n)
 Rewinds the buffer to position n.
size_t buffer_pos (buffer_t *b)
 Get the current position in the buffer.

Detailed Description

String Buffer Operations.

You can use the buffer in the same way you would print to a file. Use the buffer to do formatted printing. When you are done retrieve the final string using buffer_tostring.


Define Documentation

#define buffer_putstring ( b,
 )     (buffer_putlstring(b,s,strlen(s)))

Appends the string to the end of the buffer.

Length derived via strlen.

Parameters:
b The buffer to fill.
s The string to append.
Returns:
-1 on error.
#define buffer_putliteral ( b,
 )     (buffer_putlstring(b,l "",sizeof(l)-1))

Appends the string literal to the end of the buffer.

Length derived via sizeof.

Parameters:
b The buffer to fill.
l The literal string to append.
Returns:
-1 on error.

Function Documentation

void buffer_init ( buffer_t b  ) 

Initialize a buffer.

The buffer includes a reasonably sized starting buffer as part of its definition. Usually this means for small strings being built, nothing is ever allocated on the heap. You can specify a larger starting buffer if this is inadequate.

Parameters:
b The buffer to initialize.
void buffer_ubuf ( buffer_t b,
char *  buf,
size_t  len 
)

Use the provided buffer as a starting buffer.

This function should only be called before any work is done on the buffer. The user buffer is only used if it is larger than the internal starting buffer.

Parameters:
b The buffer.
buf A starting buffer to initially use to avoid allocating memory on the heap. (can be NULL)
len The length of the buffer. (ignored if buf == NULL)
void buffer_max ( buffer_t b,
size_t  max 
)

Set the maximum size of the buffer.

Parameters:
b The buffer.
max The maximum amount of memory to allocate. (0 is unlimited)
void buffer_abortonfailure ( buffer_t b,
int  abortonfailure 
)

Set the buffer to call fatal(.

..) on error instead of returning an error code.

Parameters:
b The buffer.
abortonfailure Kill the process on errors. (you no longer have to check returns)
void buffer_free ( buffer_t b  ) 

Free any resources and memory in use by a buffer.

Parameters:
b The buffer to free.
int buffer_putvfstring ( buffer_t b,
const char *  format,
va_list  ap 
)

Print the formatted output to the buffer.

The format string follows the same semantics as the UNIX vprintf function. buffer_putvfstring does not call the variable argument macros va_(start|end) on ap.

Parameters:
b The buffer to fill.
format The format string.
ap The variable argument list for the format string.
Returns:
-1 on error.
int buffer_putfstring ( buffer_t b,
const char *  format,
  ... 
)

Appends the formatted output to the buffer.

The format string follows the same semantics as the UNIX vprintf function.

Parameters:
b The buffer to fill.
format The format string.
... The variable arguments for the format string.
Returns:
-1 on error.
int buffer_putlstring ( buffer_t b,
const char *  str,
size_t  len 
)

Appends the string to the end of the buffer.

Parameters:
b The buffer to fill.
str The string to append.
len The length of the string.
Returns:
-1 on error.
const char* buffer_tostring ( buffer_t b,
size_t *  size 
)

Returns the buffer as a string.

The string is no longer valid after deleting the buffer. A final ASCII NUL character is guaranteed to terminate the string.

Parameters:
b The buffer.
size The size of the string is placed in this variable. Can be NULL.
Returns:
The buffer as a string with a NUL terminator.
void buffer_rewind ( buffer_t b,
size_t  n 
)

Rewinds the buffer to position n.

Parameters:
b The buffer.
n The position to rewind to.
size_t buffer_pos ( buffer_t b  ) 

Get the current position in the buffer.

Parameters:
b The buffer.
Returns:
The current position.

Generated on 15 Aug 2014 for cctools by  doxygen 1.6.1