SD_BUS_MESSAGE_READ_STRV(3)sd_bus_message_read_strvSD_BUS_MESSAGE_READ_STRV(3)

NAME
       sd_bus_message_read_strv, sd_bus_message_read_strv_extend - Access an
       array of strings in a message

SYNOPSIS
       #include <systemd/sd-bus.h>

       int sd_bus_message_read_strv(sd_bus_message *m, char ***l);

       int sd_bus_message_read_strv_extend(sd_bus_message *m, char ***l);

DESCRIPTION
       sd_bus_message_read_strv() reads an array of string-like items from the
       message m. The "read pointer" in the message must be right before an
       array of strings (D-Bus type "as"), object paths (D-Bus type "ao"), or
       signatures (D-Bus type "ag"). On success, a pointer to a
       NULL-terminated array of strings (strv) is returned in the output
       parameter l. Note that ownership of this array is transferred to the
       caller. Hence, the caller is responsible for freeing this array and its
       contents.

       sd_bus_message_read_strv_extend() is similar, but the second parameter
       is an input-output parameter. If *l is NULL, if behaves identically to
       sd_bus_message_read_strv(). Otherwise, *l must point to a strv, which
       will be reallocated and extended with additional strings. This function
       is particularly useful when combining multiple lists of strings in a
       message or messages into a single array of strings.

RETURN VALUE
       On success, these functions return a non-negative integer. On failure,
       they return a negative errno-style error code.

   Errors
       Returned errors may indicate the following problems:

       -EINVAL
           m or l are NULL.

       -EPERM
           The message is not sealed.

       -EBADMSG
           The message cannot be parsed.

       -ENXIO
           The message "read pointer" is not right before an array of the
           appropriate type.

SEE ALSO
       systemd(1), sd-bus(3), sd_bus_message_read(3)

systemd 252                                        SD_BUS_MESSAGE_READ_STRV(3)

Czas wygenerowania: 0.00034 sek.

Created with the man page lookup class by Andrew Collington.
Based on a C man page viewer by Vadim Pavlov
Unicode soft-hyphen fix (as used by RedHat) by Dan Edwards
Some optimisations by Eli Argon
Caching idea and code contribution by James Richardson

Copyright © 2003-2025 Linux.pl
Hosted by Hosting Linux.pl