morgan/systemd
1
0
Fork 0
mirror of https://github.com/morgan9e/systemd synced 2026-04-15 00:47:10 +09:00
Code Issues Packages Projects Releases Wiki Activity

man: document that sd_bus_message_read_strv() happily spits out empty arrays as NULL

Browse Source 
Fixes: #34163
This commit is contained in:
Lennart Poettering
2024-09-06 11:30:23 +02:00
parent 4ac1755be2
commit 22f3f2cebd
1 changed files with 3 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
man/sd_bus_message_read_strv.xml
View File

@@ -49,7 +49,9 @@
signatures (D-Bus type <literal>ag</literal>). On success, a pointer to a signatures (D-Bus type <literal>ag</literal>). On success, a pointer to a
<constant>NULL</constant>-terminated array of strings (strv) is returned in the output parameter <constant>NULL</constant>-terminated array of strings (strv) is returned in the output parameter
<parameter>l</parameter>. Note that ownership of this array is transferred to the caller. Hence, the <parameter>l</parameter>. Note that ownership of this array is transferred to the caller. Hence, the
caller is responsible for freeing this array and its contents.</para> caller is responsible for freeing this array and its contents. Also note that as a matter of
optimization, if an empty array is encountered a <constant>NULL</constant> pointer might be returned
here, and should be considered equivalent to an array with zero entries.</para>
<para><function>sd_bus_message_read_strv_extend()</function> is similar, but the second parameter is an <para><function>sd_bus_message_read_strv_extend()</function> is similar, but the second parameter is an
input-output parameter. If <parameter>*l</parameter> is <constant>NULL</constant>, if behaves identically input-output parameter. If <parameter>*l</parameter> is <constant>NULL</constant>, if behaves identically