summaryrefslogtreecommitdiff
path: root/source3/lib/talloc/talloc_guide.txt
diff options
context:
space:
mode:
authorJeremy Allison <jra@samba.org>2007-09-14 17:40:58 +0000
committerGerald (Jerry) Carter <jerry@samba.org>2007-10-10 12:30:47 -0500
commit47107b2cdea7c58c337639f6d1aaab94390bf0f6 (patch)
tree9b9572040dd6f838ece19c67ab9347010bea0575 /source3/lib/talloc/talloc_guide.txt
parent539635cd94dd21dbc72f070fbd8a54c726091f5a (diff)
downloadsamba-47107b2cdea7c58c337639f6d1aaab94390bf0f6.tar.gz
samba-47107b2cdea7c58c337639f6d1aaab94390bf0f6.tar.bz2
samba-47107b2cdea7c58c337639f6d1aaab94390bf0f6.zip
r25164: Add talloc_asprintf_append_buffer() and the docs for it.
Jeremy. (This used to be commit 2243a73d650319208aebbbaf65dfba2a508a7c10)
Diffstat (limited to 'source3/lib/talloc/talloc_guide.txt')
-rw-r--r--source3/lib/talloc/talloc_guide.txt19
1 files changed, 17 insertions, 2 deletions
diff --git a/source3/lib/talloc/talloc_guide.txt b/source3/lib/talloc/talloc_guide.txt
index c4634ae19a..18663b370d 100644
--- a/source3/lib/talloc/talloc_guide.txt
+++ b/source3/lib/talloc/talloc_guide.txt
@@ -568,8 +568,23 @@ string. This is equivalent to:
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
char *talloc_asprintf_append(char *s, const char *fmt, ...);
+The talloc_asprintf_append() function appends the given formatted
+string to the given string.
+Use this varient 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)
+
+
+=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
+char *talloc_asprintf_append_buffer(char *s, const char *fmt, ...);
+
The talloc_asprintf_append() function appends the given formatted
-string to the given string.
+string to the end of the currently allocated talloc buffer.
+Use this varient when the string in the current talloc buffer has
+not been changed.
This functions sets the name of the new pointer to the new
string. This is equivalent to:
@@ -577,7 +592,7 @@ string. This is equivalent to:
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-(type *)talloc_array(const void *ctx, type, uint_t count);
+((type *)talloc_array(const void *ctx, type, uint_t count);
The talloc_array() macro is equivalent to: