Project

hex_string

0.05
No commit activity in last 3 years
No release in over 3 years
String extensions to convert binary data to / from human readable hex tuples.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
 Dependencies

Development

~> 2.0.11
>= 1.0.0
>= 0.8.0
~> 0.6.4
 Project Readme

Description

HexString provides two String extension methods:

  • String#to_hex_string explodes a string of binary data into human-readable hex tuples, and
  • String#to_byte_string converts a string of human-readable hex digits into the corresponding bytes.

Examples

# Convert data to human-readable hex tuples:
>> "hello".to_hex_string
=> "68 65 6c 6c 6f"

# Compact a hex string into its data equivalent:
>> "77 6f 72 6c 64".to_byte_string
=> "world"

# (#to_byte_string is space and case-insensitive:)
>> "776F726C64".to_byte_string
=> "world"

# Peek at the first 4 bytes of an executable on OS X:
>> File.read("/bin/ls")[0..3].to_hex_string
=> "ca fe ba be"

# Omit spaces in hex string output:
>> "hello".to_hex_string(false)
=> "68656c6c6f"

Motivation

When working with binary message or file formats, we often want to have a peek at some segment of binary data and talk about individual byte values in human-relatable terms.

This sort of thing comes in handy during testing, debugging and data introspection, especially when it's inconvenient or impractical to capture the desired binary data to file in order to view it with a hex editor or other binary file reader.

We were inspired to publish this humble Gem after we found ourselves copying it by hand from project to project over the course of several years.

Authors