1Data::HexDump::XXD(3) User Contributed Perl DocumentationData::HexDump::XXD(3)
2
6 Data::HexDump::XXD - format hexadecimal dump like xxd
7
9 This document describes Data::HexDump::XXD version 0.0.1
10
12 use Data::HexDump::XXD qw( xxd xxd_r );
13 my $dump_string = xxd($binary_data);
15 my @dumped_lines = xxd($binary_data);
16 my $binary = xxd_r($xxd_like_string);
18 my $binary = xxd_r(@xxd_like_lines);
19
21 Produce an hexadecimal dump like the program xxd would do, and do the
22 reverse as well.
23 At the moment, only straight dumping is supported, and reverse assumes
25 the same.
26
28 my $dump = xxd($bindata);
29 my @dump_lines = xxd($bindata);
30 my $dump = xxd_unpack($bindata);
31 my @dump_lines = xxd_unpack($bindata);
32 Produce an hex dump of the input $bindata. The dump can be either a
33 single string or a list of lines depending on the calling context.
34 "xxd_unpack()" and "xxd()" are synonimous.
36 my $bindata = xxd_r($dump);
38 my $bindata = xxd_r(@dump_lines);
39 my $bindata = xxd_pack($dump);
40 my $bindata = xxd_pack(@dump_lines);
41 Reverse an xxd-style hexadecimal dump. You can either provide a
42 single string or an array of lines; in the first case, the line
43 terminator is assumed to be a single newline character. Like xxd,
44 the ASCII dump is ignored and only the hexadecimal part is taken
45 into account.
46
48 Data::HexDump::XXD requires no configuration files or environment
49 variables.
50
52 Among the non-core, only "version".
53
55 It is currently limited to the basic behaviour of xxd. Note that plain
56 hex dump is pretty straightforward in Perl, you simply have to call:
57 my $hex = unpack 'H*', $bindata;
59 Note also that the high nybble is always assumed to come first in dumps
61 (see "perldoc -f unpack", "H" template).
62 No bugs have been reported.
64 Please report any bugs or feature requests through http://rt.cpan.org/
66
68 Flavio Poletti "<flavio [at] polettix [dot] it>"
69
71 Copyright (c) 2007, Flavio Poletti "<flavio [at] polettix [dot] it>".
72 All rights reserved.
73 This module is free software; you can redistribute it and/or modify it
75 under the same terms as Perl itself. See perlartistic and perlgpl.
76 Questo modulo e software libero: potete ridistribuirlo e/o modificarlo
78 negli stessi termini di Perl stesso. Vedete anche perlartistic e
79 perlgpl.
80
82 BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
83 FOR THE SOFTWARE, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT
84 WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER
85 PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF ANY KIND,
86 EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
87 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE
88 ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH
89 YOU. SHOULD THE SOFTWARE PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
90 NECESSARY SERVICING, REPAIR, OR CORRECTION.
91 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
93 WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
94 REDISTRIBUTE THE SOFTWARE AS PERMITTED BY THE ABOVE LICENCE, BE LIABLE
95 TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL, OR
96 CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
97 SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
98 RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
99 FAILURE OF THE SOFTWARE TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
100 SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
101 DAMAGES.
102
104 Poiche questo software viene dato con una licenza gratuita, non c'e
105 alcuna garanzia associata ad esso, ai fini e per quanto permesso dalle
106 leggi applicabili. A meno di quanto possa essere specificato altrove,
107 il proprietario e detentore del copyright fornisce questo software
108 "cosi com'e" senza garanzia di alcun tipo, sia essa espressa o
109 implicita, includendo fra l'altro (senza pero limitarsi a questo)
110 eventuali garanzie implicite di commerciabilita e adeguatezza per uno
111 scopo particolare. L'intero rischio riguardo alla qualita ed alle
112 prestazioni di questo software rimane a voi. Se il software dovesse
113 dimostrarsi difettoso, vi assumete tutte le responsabilita ed i costi
114 per tutti i necessari servizi, riparazioni o correzioni.
115 In nessun caso, a meno che cio non sia richiesto dalle leggi vigenti o
117 sia regolato da un accordo scritto, alcuno dei detentori del diritto di
118 copyright, o qualunque altra parte che possa modificare, o
119 redistribuire questo software cosi come consentito dalla licenza di cui
120 sopra, potra essere considerato responsabile nei vostri confronti per
121 danni, ivi inclusi danni generali, speciali, incidentali o
122 conseguenziali, derivanti dall'utilizzo o dall'incapacita di utilizzo
123 di questo software. Cio include, a puro titolo di esempio e senza
124 limitarsi ad essi, la perdita di dati, l'alterazione involontaria o
125 indesiderata di dati, le perdite sostenute da voi o da terze parti o un
126 fallimento del software ad operare con un qualsivoglia altro software.
127 Tale negazione di garanzia rimane in essere anche se i dententori del
128 copyright, o qualsiasi altra parte, e stata avvisata della possibilita
129 di tali danneggiamenti.
130 Se decidete di utilizzare questo software, lo fate a vostro rischio e
132 pericolo. Se pensate che i termini di questa negazione di garanzia non
133 si confacciano alle vostre esigenze, o al vostro modo di considerare un
134 software, o ancora al modo in cui avete sempre trattato software di
135 terze parti, non usatelo. Se lo usate, accettate espressamente questa
136 negazione di garanzia e la piena responsabilita per qualsiasi tipo di
137 danno, di qualsiasi natura, possa derivarne.
138perl v5.30.1 2020-01-29 Data::HexDump::XXD(3)