diff options
| author | Daniel Gustafsson <dgustafsson@postgresql.org> | 2024-03-16 23:18:28 +0100 |
|---|---|---|
| committer | Daniel Gustafsson <dgustafsson@postgresql.org> | 2024-03-16 23:18:28 +0100 |
| commit | b7831865159d5fb6f0d263e6023f0986589fe254 (patch) | |
| tree | f6525ed20cab8159e66d39a0fd7e5ca754bf21aa /src/include/lib/stringinfo.h | |
| parent | 927332b95e778c0d15a9fbf96e3efeab0d3d937c (diff) | |
| download | postgresql-b7831865159d5fb6f0d263e6023f0986589fe254.tar.gz postgresql-b7831865159d5fb6f0d263e6023f0986589fe254.zip | |
Add destroyStringInfo function for cleaning up StringInfos
destroyStringInfo() is a counterpart to makeStringInfo(), freeing a
palloc'd StringInfo and its data. This is a convenience function to
align the StringInfo API with the PQExpBuffer API. Originally added
in the OAuth patchset, it was extracted and committed separately in
order to aid upcoming JSON work.
Author: Daniel Gustafsson <daniel@yesql.se>
Author: Jacob Champion <jacob.champion@enterprisedb.com>
Reviewed-by: Michael Paquier <michael@paquier.xyz>
Discussion: https://postgr.es/m/CAOYmi+mWdTd6ujtyF7MsvXvk7ToLRVG_tYAcaGbQLvf=N4KrQw@mail.gmail.com
Diffstat (limited to 'src/include/lib/stringinfo.h')
| -rw-r--r-- | src/include/lib/stringinfo.h | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/src/include/lib/stringinfo.h b/src/include/lib/stringinfo.h index 2cd636b01cf..cd9632e3fca 100644 --- a/src/include/lib/stringinfo.h +++ b/src/include/lib/stringinfo.h @@ -87,7 +87,8 @@ typedef StringInfoData *StringInfo; * to be len + 1 in size. * * To destroy a StringInfo, pfree() the data buffer, and then pfree() the - * StringInfoData if it was palloc'd. There's no special support for this. + * StringInfoData if it was palloc'd. For StringInfos created with + * makeStringInfo(), destroyStringInfo() is provided for this purpose. * However, if the StringInfo was initialized using initReadOnlyStringInfo() * then the caller will need to consider if it is safe to pfree the data * buffer. @@ -233,4 +234,10 @@ extern void appendBinaryStringInfoNT(StringInfo str, */ extern void enlargeStringInfo(StringInfo str, int needed); +/*------------------------ + * destroyStringInfo + * Frees a StringInfo and its buffer (opposite of makeStringInfo()). + */ +extern void destroyStringInfo(StringInfo str); + #endif /* STRINGINFO_H */ |