NAME<\/a> Net::DBus::Binding::Iterator \u2212 Reading and writing message parameters<\/p>\n Creating a new message<\/p>\n my $msg = new Net::DBus::Binding::Message::Signal; Reading from a message<\/p>\n my $msg = …get it from somewhere… Provides an iterator for reading or writing message fields. This module provides a Perl API<\/small> to access the dbus_message_iter_XXX methods in the C API.<\/small> The array and dictionary types are not yet supported, and there are bugs in the Quad support (ie it always returns \u22121!).<\/p>\n $res = $iter\u2212>has_next()<\/b><\/p>\n Determines if there are any more fields in the message itertor to be read. Returns a positive value if there are more fields, zero otherwise.<\/p>\n $success = $iter\u2212>next()<\/b><\/p>\n Skips the iterator onto the next field in the message. Returns a positive value if the current field pointer was successfully advanced, zero otherwise.<\/p>\n my $val = $iter\u2212>get_boolean()<\/b> Read or write a boolean value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_byte()<\/b> Read or write a single byte value from\/to the message iterator.<\/p>\n my $val = $iter\u2212>get_string()<\/b> Read or write a UTF\u22128<\/small> string value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_object_path()<\/b> Read or write a UTF\u22128<\/small> string value, whose contents is a valid object path, from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_signature()<\/b> Read or write a UTF\u22128<\/small> string, whose contents is a valid type signature, value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_int16()<\/b> Read or write a signed 16 bit value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_uint16()<\/b> Read or write an unsigned 16 bit value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_int32()<\/b> Read or write a signed 32 bit value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_uint32()<\/b> Read or write an unsigned 32 bit value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_int64()<\/b> Read or write a signed 64 bit value from\/to the message iterator. An error will be raised if this build of Perl does not support 64 bit integers<\/p>\n my $val = $iter\u2212>get_uint64()<\/b> Read or write an unsigned 64 bit value from\/to the message iterator. An error will be raised if this build of Perl does not support 64 bit integers<\/p>\n my $val = $iter\u2212>get_double()<\/b> Read or write a double precision floating point value from\/to the message iterator<\/p>\n my $val = $iter\u2212>get_unix_fd()<\/b> Read or write a unix_fd value from\/to the message iterator<\/p>\n my $value = $iter\u2212>get()<\/b> Get the current value pointed to by this iterator. If the optional $type parameter is supplied, the wire type will be compared with the desired type & a warning output if their differ. The $type value must be one of the “Net::DBus::Binding::Message::TYPE*” constants.<\/p>\n my $hashref = $iter\u2212>get_dict()<\/b><\/p>\n If the iterator currently points to a dictionary value, unmarshalls and returns the value as a hash reference.<\/p>\n my $hashref = $iter\u2212>get_array()<\/b><\/p>\n If the iterator currently points to an array value, unmarshalls and returns the value as a array reference.<\/p>\n my $hashref = $iter\u2212>get_variant()<\/b><\/p>\n If the iterator currently points to a variant value, unmarshalls and returns the value contained in the variant.<\/p>\n my $hashref = $iter\u2212>get_struct()<\/b><\/p>\n If the iterator currently points to an struct value, unmarshalls and returns the value as a array reference. The values in the array correspond to members of the struct.<\/p>\n $iter\u2212>append($value) Appends a value to the message associated with this iterator. The value is marshalled into wire format, according to the following rules.<\/p>\n If the $value is an instance of Net::DBus::Binding::Value, the embedded data type is used.<\/p>\n If the $type parameter is supplied, that is taken to represent the data type. The type must be one of the “Net::DBus::Binding::Message::TYPE_*” constants.<\/p>\n Otherwise, the data type is chosen to be a string, dict or array according to the perl data types SCALAR, HASH<\/small> or ARRAY.<\/small><\/p>\n my $type = $iter\u2212>guess_type($value)<\/p>\n Make a best guess at the on the wire data type to use for marshalling $value. If the value is a hash reference, the dictionary type is returned; if the value is an array reference the array type is returned; otherwise the string type is returned.<\/p>\n my $sig = $iter\u2212>format_signature($type)<\/p>\n Given a data type representation, construct a corresponding signature string<\/p>\n $iter\u2212>append_array($value, $type)<\/p>\n Append an array of values to the message. The $value parameter must be an array reference, whose elements all have the same data type specified by the $type parameter.<\/p>\n $iter\u2212>append_struct($value, $type)<\/p>\n Append a struct to the message. The $value parameter must be an array reference, whose elements correspond to members of the structure. The $type parameter encodes the type of each member of the struct.<\/p>\n $iter\u2212>append_dict($value, $type)<\/p>\n Append a dictionary to the message. The $value parameter must be an hash reference.The $type parameter encodes the type of the key and value of the hash.<\/p>\n $iter\u2212>append_variant($value)<\/p>\n Append a value to the message, encoded as a variant type. The $value can be of any type, however, the variant will be encoded as either a string, dictionary or array according to the rules of the “guess_type” method.<\/p>\n my $type = $iter\u2212>get_arg_type<\/p>\n Retrieves the type code of the value pointing to by this iterator. The returned code will correspond to one of the constants “Net::DBus::Binding::Message::TYPE_*”<\/p>\n my $type = $iter\u2212>get_element_type<\/p>\n If the iterator points to an array, retrieves the type code of array elements. The returned code will correspond to one of the constants “Net::DBus::Binding::Message::TYPE_*”<\/p>\n Daniel P. Berrange<\/p>\n Copyright (C) 2004\u22122011 Daniel P. Berrange<\/p>\n Net::DBus::Binding::Message<\/p>\n Net::DBus::Binding::Iterator \u2212 Reading and writing message parameters <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3007,3678],"class_list":["post-7364","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-man3","tag-netdbusbindingiterator"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7364","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=7364"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/7364\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=7364"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=7364"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=7364"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
SYNOPSIS<\/a>
DESCRIPTION<\/a>
METHODS<\/a>
AUTHOR<\/a>
COPYRIGHT<\/a>
SEE ALSO<\/a> <\/p>\n
\nNAME <\/a> <\/h2>\n
SYNOPSIS <\/a> <\/h2>\n
my $iterator = $msg\u2212>iterator;
$iterator\u2212>append_boolean(1);
$iterator\u2212>append_byte(123);<\/p>\n
my $iter = $msg\u2212>iterator();
my $i = 0;
while ($iter\u2212>has_next()) {
$iter\u2212>next();
$i++;
if ($i == 1) {
my $val = $iter\u2212>get_boolean();
} elsif ($i == 2) {
my $val = $iter\u2212>get_byte();
}
}<\/p>\nDESCRIPTION <\/a> <\/h2>\n
METHODS <\/a> <\/h2>\n
$iter\u2212>append_boolean($val);<\/p>\n
$iter\u2212>append_byte($val);<\/p>\n
$iter\u2212>append_string($val);<\/p>\n
$iter\u2212>append_object_path($val);<\/p>\n
$iter\u2212>append_signature($val);<\/p>\n
$iter\u2212>append_int16($val);<\/p>\n
$iter\u2212>append_uint16($val);<\/p>\n
$iter\u2212>append_int32($val);<\/p>\n
$iter\u2212>append_uint32($val);<\/p>\n
$iter\u2212>append_int64($val);<\/p>\n
$iter\u2212>append_uint64($val);<\/p>\n
$iter\u2212>append_double($val);<\/p>\n
$iter\u2212>append_unix_fd($val);<\/p>\n
my $value = $iter\u2212>get($type);<\/p>\n
$iter\u2212>append($value, $type)<\/p>\nAUTHOR <\/a> <\/h2>\n
COPYRIGHT <\/a> <\/h2>\n
SEE ALSO <\/a> <\/h2>\n
\n","protected":false},"excerpt":{"rendered":"