From b233173f85a902d8b037d7a9ac8e069bd3ae1101 Mon Sep 17 00:00:00 2001 From: Pavel Březina Date: Mon, 16 Apr 2012 12:44:08 +0200 Subject: Talloc doc: talloc_strdup_append() The destination string is reallocated instead of duplicating the result. --- lib/talloc/talloc.h | 22 ++++++++++++++++++---- 1 file changed, 18 insertions(+), 4 deletions(-) (limited to 'lib') diff --git a/lib/talloc/talloc.h b/lib/talloc/talloc.h index 96c7e2467c..85c8ce9d6d 100644 --- a/lib/talloc/talloc.h +++ b/lib/talloc/talloc.h @@ -1,16 +1,16 @@ #ifndef _TALLOC_H_ #define _TALLOC_H_ -/* +/* Unix SMB/CIFS implementation. Samba temporary memory allocation functions Copyright (C) Andrew Tridgell 2004-2005 Copyright (C) Stefan Metzmacher 2006 - + ** NOTE! The following LGPL license applies to the talloc ** library. This does NOT imply that all of Samba is released ** under the LGPL - + This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either @@ -1290,7 +1290,20 @@ void *talloc_realloc_fn(const void *context, void *ptr, size_t size); char *talloc_strdup(const void *t, const char *p); /** - * @brief Append a string to given string and duplicate the result. + * @brief Append a string to given string. + * + * The destination string is reallocated to take strlen(s) + strlen(a) + 1 + * characters. + * + * The destination string is reallocated to take + * strlen(s) + strlen(a, n) + 1 characters. + * + * This functions sets the name of the new pointer to the new + * string. This is equivalent to: + * + * @code + * talloc_set_name_const(ptr, ptr) + * @endcode * * @param[in] s The destination to append to. * @@ -1299,6 +1312,7 @@ char *talloc_strdup(const void *t, const char *p); * @return The duplicated string, NULL on error. * * @see talloc_strdup() + * @see talloc_strdup_append_buffer() */ char *talloc_strdup_append(char *s, const char *a); -- cgit