walkgirl/hexdump.rb

   1 # ==============================================================================
   2 # EXTENDING CLASS STRING
   3 # ==============================================================================
   4 #
   5 # (C) Copyright 2004 by Tilo Sloboda <tools@unixgods.org>
   6 #
   7 # License:
   8 #         Freely available under the terms of the OpenSource "Artistic License"
   9 #         in combination with the Addendum A (below)
  10 #
  11 #         In case you did not get a copy of the license along with the software,
  12 #         it is also available at:   http://www.unixgods.org/~tilo/artistic-license.html
  13 #
  14 # Addendum A:
  15 #         THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU!
  16 #         SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  17 #         REPAIR OR CORRECTION.
  18 #
  19 #         IN NO EVENT WILL THE COPYRIGHT HOLDERS  BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL,
  20 #         SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  21 #         TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  22 #         INACCURATE OR USELESS OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM
  23 #         TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF THE COPYRIGHT HOLDERS OR OTHER PARTY HAS BEEN
  24 #         ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  25
  26
  27 class String
  28   #
  29   # prints out a good'ol hexdump of the data contained in the string
  30   #
  31   # parameters:     sparse:   true / false     do we want to print multiple lines with zero values?
  32
  33   def hexdump(sparse = false)
  34      selfsize = self.size
  35      first = true
  36
  37      print "\n index       0 1 2 3  4 5 6 7  8 9 A B  C D E F\n\n"
  38
  39      lines,rest = selfsize.divmod(16)
  40      address = 0; i = 0    # we count them independently for future extension.
  41
  42      while lines > 0
  43         str = self[i..i+15]
  44
  45         # we don't print lines with all zeroes, unless it's the last line
  46
  47         if str == "\0"*16     # if the 16 bytes are all zero
  48
  49           if (!sparse) || (sparse &&  lines == 1 && rest == 0)
  50              str.tr!("\000-\037\177-\377",'.')
  51              printf( "%08x    %8s %8s %8s %8s    %s\n",
  52                 address, self[i..i+3].unpack('H8'), self[i+4..i+7].unpack('H8'),
  53                 self[i+8..i+11].unpack('H8'), self[i+12..i+15].unpack('H8'), str)
  54           else
  55                 print "  ....      00 .. 00 00 .. 00 00 .. 00 00 .. 00    ................\n" if first
  56                 first = false
  57           end
  58
  59         else  # print string which is not all zeros
  60
  61           str.tr!("\000-\037\177-\377",'.')
  62           printf( "%08x    %8s %8s %8s %8s    %s\n",
  63                 address, self[i..i+3].unpack('H8'), self[i+4..i+7].unpack('H8'),
  64                 self[i+8..i+11].unpack('H8'), self[i+12..i+15].unpack('H8'), str)
  65           first = true
  66         end
  67         i += 16; address += 16; lines -= 1
  68      end
  69
  70      # now do the remaining bytes, which don't fit a full line..
  71      # yikes - this is truly ugly!  REWRITE THIS!!
  72
  73      if rest > 0
  74         chunks2,rest2 = rest.divmod(4)
  75         j = i; k = 0
  76         if (i < selfsize)
  77            printf( "%08x    ", address)
  78            while (i < selfsize)
  79                 printf "%02x", self[i]
  80                 i += 1; k += 1
  81                 print  " " if ((i % 4) == 0)
  82            end
  83            for i in (k..15)
  84                   print "  "
  85            end
  86            str = self[j..selfsize]
  87            str.tr!("\000-\037\177-\377",'.')
  88            print " " * (4 - chunks2+1)
  89            printf("  %s\n", str)
  90         end
  91      end
  92   end
  93
  94 end
  95
  96
  97
  98 __END__
  99
 100 require 'hexdump'
 101
 102 s =  "some random long string"
 103
 104 t =  s << "\0"*40  << s << "\0"*32 << s << "bla bla bla!"
 105 t.hexdump(true)
 106 t.hexdump(false)
 107
 108 4.times {t.chop!}
 109
 110 t.hexdump(true)
 111 t.hexdump(false)
 112
 113