diff options
| author | Lennart Poettering <lennart@poettering.net> | 2024-09-06 11:30:23 +0200 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2024-09-06 14:10:12 +0200 |
| commit | 22f3f2cebd1918cfc8cc2e8a2404b051048b7bfc (patch) | |
| tree | 3d1416bdca1dc089b8a6d0c151007a15056d0e9c /man/sd_bus_message_read_strv.xml | |
| parent | coredump: set ProtectHome to read-only (diff) | |
| download | systemd-22f3f2cebd1918cfc8cc2e8a2404b051048b7bfc.tar.xz systemd-22f3f2cebd1918cfc8cc2e8a2404b051048b7bfc.zip | |
man: document that sd_bus_message_read_strv() happily spits out empty arrays as NULL
Fixes: #34163
Diffstat (limited to '')
| -rw-r--r-- | man/sd_bus_message_read_strv.xml | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/man/sd_bus_message_read_strv.xml b/man/sd_bus_message_read_strv.xml index 3b4910d7cb..9b479349b6 100644 --- a/man/sd_bus_message_read_strv.xml +++ b/man/sd_bus_message_read_strv.xml @@ -49,7 +49,9 @@ 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 <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 input-output parameter. If <parameter>*l</parameter> is <constant>NULL</constant>, if behaves identically |