Functions¶

char * talloc_strdup (const void *t, const char *p)
Duplicate a string into a talloc chunk. char * talloc_strdup_append (char *s, const char *a)
Append a string to given string. char * talloc_strdup_append_buffer (char *s, const char *a)
Append a string to a given buffer. char * talloc_strndup (const void *t, const char *p, size_t n)
Duplicate a length-limited string into a talloc chunk. char * talloc_strndup_append (char *s, const char *a, size_t n)
Append at most n characters of a string to given string. char * talloc_strndup_append_buffer (char *s, const char *a, size_t n)
Append at most n characters of a string to given buffer. char * talloc_vasprintf (const void *t, const char *fmt, va_list ap)
Format a string given a va_list. char * talloc_vasprintf_append (char *s, const char *fmt, va_list ap)
Format a string given a va_list and append it to the given destination string. char * talloc_vasprintf_append_buffer (char *s, const char *fmt, va_list ap)
Format a string given a va_list and append it to the given destination buffer. char * talloc_asprintf (const void *t, const char *fmt,...)
Format a string. char * talloc_asprintf_append (char *s, const char *fmt,...)
Append a formatted string to another string. char * talloc_asprintf_append_buffer (char *s, const char *fmt,...)
Append a formatted string to another string.

char* talloc_asprintf (const void * t, const char * fmt, ...)¶

Format a string. This function is the talloc equivalent of the C library function asprintf(3).

This functions sets the name of the new pointer to the new string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

Parameters:

Returns:

char* talloc_asprintf_append (char * s, const char * fmt, ...)¶

Append a formatted string to another string. This function appends the given formatted string to the given string. Use this variant when the string in the current talloc buffer may have been truncated in length.

This functions sets the name of the new pointer to the new string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

If s == NULL then new context is created.

Parameters:

Returns:

char* talloc_asprintf_append_buffer (char * s, const char * fmt, ...)¶

Append a formatted string to another string. This is a more efficient version of talloc_asprintf_append(). It determines the length of the destination string by the size of the talloc context.

Use this very carefully as it produces a different result than talloc_asprintf_append() when a zero character is in the middle of the destination string.

      char *str_a = talloc_strdup(NULL, 'hello world');


      char *str_b = talloc_strdup(NULL, 'hello world');


      str_a[5] = str_b[5] = ' '


      char *app = talloc_asprintf_append(str_a, '%s', ', hello');


      char *buf = talloc_strdup_append_buffer(str_b, '%s', ', hello');


      printf('%s0, app); // hello, hello (app = 'hello, hello')


      printf('%s0, buf); // hello (buf = 'hello world, hello')

If s == NULL then new context is created.

Parameters:

Returns:

See also:

char* talloc_strdup (const void * t, const char * p)¶

Duplicate a string into a talloc chunk. This function is equivalent to:

      ptr = talloc_size(ctx, strlen(p)+1);


      if (ptr) memcpy(ptr, p, strlen(p)+1);

This functions sets the name of the new pointer to the passed string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

Parameters:

Returns:

char* talloc_strdup_append (char * s, const char * a)¶

Append a string to given string. The destination string is reallocated to take strlen(s) + strlen(a) + 1 characters.

This functions sets the name of the new pointer to the new string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

If s == NULL then new context is created.

Parameters:

Returns:

See also:

char* talloc_strdup_append_buffer (char * s, const char * a)¶

Append a string to a given buffer. This is a more efficient version of talloc_strdup_append(). It determines the length of the destination string by the size of the talloc context.

Use this very carefully as it produces a different result than talloc_strdup_append() when a zero character is in the middle of the destination string.

      char *str_a = talloc_strdup(NULL, 'hello world');


      char *str_b = talloc_strdup(NULL, 'hello world');


      str_a[5] = str_b[5] = ' '


      char *app = talloc_strdup_append(str_a, ', hello');


      char *buf = talloc_strdup_append_buffer(str_b, ', hello');


      printf('%s0, app); // hello, hello (app = 'hello, hello')


      printf('%s0, buf); // hello (buf = 'hello world, hello')

If s == NULL then new context is created.

Parameters:

Returns:

See also:

char* talloc_strndup (const void * t, const char * p, size_t n)¶

Duplicate a length-limited string into a talloc chunk. This function is the talloc equivalent of the C library function strndup(3).

This functions sets the name of the new pointer to the passed string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

Parameters:

Returns:

char* talloc_strndup_append (char * s, const char * a, size_t n)¶

Append at most n characters of a string to given string. The destination string is reallocated to take strlen(s) + strnlen(a, n) + 1 characters.

This functions sets the name of the new pointer to the new string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

If s == NULL then new context is created.

Parameters:

Returns:

See also:

char* talloc_strndup_append_buffer (char * s, const char * a, size_t n)¶

Append at most n characters of a string to given buffer. This is a more efficient version of talloc_strndup_append(). It determines the length of the destination string by the size of the talloc context.

Use this very carefully as it produces a different result than talloc_strndup_append() when a zero character is in the middle of the destination string.

      char *str_a = talloc_strdup(NULL, 'hello world');


      char *str_b = talloc_strdup(NULL, 'hello world');


      str_a[5] = str_b[5] = ' '


      char *app = talloc_strndup_append(str_a, ', hello', 7);


      char *buf = talloc_strndup_append_buffer(str_b, ', hello', 7);


      printf('%s0, app); // hello, hello (app = 'hello, hello')


      printf('%s0, buf); // hello (buf = 'hello world, hello')

If s == NULL then new context is created.

Parameters:

Returns:

See also:

char* talloc_vasprintf (const void * t, const char * fmt, va_list ap)¶

Format a string given a va_list. This function is the talloc equivalent of the C library function vasprintf(3).

This functions sets the name of the new pointer to the new string. This is equivalent to:

      talloc_set_name_const(ptr, ptr)

Parameters:

Returns:

char* talloc_vasprintf_append (char * s, const char * fmt, va_list ap)¶

Format a string given a va_list and append it to the given destination string. Parameters:

Returns:

See also:

Format a string given a va_list and append it to the given destination string.

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

char* talloc_vasprintf_append_buffer (char * s, const char * fmt, va_list ap)¶

Format a string given a va_list and append it to the given destination buffer. Parameters:

Returns:

See also:

Format a string given a va_list and append it to the given destination buffer.

Always appends at the end of the talloc'ed buffer, not the end of the string.