X11::Xlib::Struct - Base class for X11 packed structures
Base class for the various exposed C-structs of Xlib, which are represented as a blessed scalar-ref of the raw bytes of the struct. This makes them more efficient than fully inflating/deflating perl hashrefs for every Xlib call.
All attribute accessors are defined in XS.
This is a 'magic' attribute that can be attached to all structs (except for XEvent where it is a real attribute). Many times a struct will have
my $struct= X11::Xlib::....->new( %optional_fields );
The constructor sets all fields to their initial value (i.e. zero) and then applies the list of key/value pairs. Warns on un-known field names.
Set all struct fields to a sensible initial value (like zero)
$struct->pack( \%fields, $consume, $warn );
Pack field values into the bytes of the struct. Only %fields is required.
%fields
If $consume is true, then remove any key of %fields that was processed.
$consume
If $warn is true, then emit a warning if any un-recognized field was given.
$warn
$struct->apply( \%fields ); $struct->apply( field => $val, ... );
Alias for pack(\%fields, 1, 1) . For each given field, update that member of the struct. Emits a warning if the hash contains unknown fields.
pack(\%fields, 1, 1)
my $hashref= $struct->unpack();
Extract all fields as Perl data.
Access the scalar holding the bytes of the struct.
Olivier Thauvin, <nanardon@nanardon.zarb.org>
Michael Conrad, <mike@nrdvana.net>
Copyright (C) 2009-2010 by Olivier Thauvin
Copyright (C) 2017 by Michael Conrad
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.
To install X11::Xlib, copy and paste the appropriate command in to your terminal.
cpanm
cpanm X11::Xlib
CPAN shell
perl -MCPAN -e shell install X11::Xlib
For more information on module installation, please visit the detailed CPAN module installation guide.