pack-d 0.1.0

Binary I/O helper


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

pack-d

License

Licensed under MIT License. See LICENSE file.

Installation

Download source/pack.d and add it to your project.

About

Pack-D is small binary IO helper written in D Programming Language based on Python's struct module.

Example

import binary.pack;
import std.stdio;

void main()
{
    int a, b, c;
    ubyte[] bytes;
    
    /// Packing 3 integers to binary
    bytes = pack(20, 30, 40);
    
    /// Unpack 3 integers from bytes to a, b and c
    bytes.unpack(a, b, c);
    writefln("%d %d %d", a, b, c); // 20 30 40
    
    /// Pack 2 shorts and a string
    bytes = pack!`hhs`(42, 18, "hello, world!");
    writeln(bytes.unpack!`hhs`); /// Tuple!(short, short, string)(42, 18, "hello, world!")
}

Format reference

Most Pack-D functions use a format string to define types of values. Format string can be ommited and value types are inferred, although it is strongly recommended to specify it whenever possible.

Available modifier characters

CharacterEffect
=Change to native endian
<Change to little endian
>Change to big endian
@Change to network byte order(big endian)

Available type specifiers

CharacterTypeSize
cchar1
bbyte1
Bubyte1
hshort2
Hushort2
iint4
Iuint4
pptrdiff_t4/8
Psize_t4/8
llong8
Lulong8
ffloat4
ddouble8
sstringstring length + nul
Sstringstring length
x-1 (null/skip byte)

TIP: Common rule for (almost) all type specifiers is that all lowercase letters represent signed types and

uppercase letters represent unsigned type.

Additionaly all type specifiers can be preceded by number of occurences. For example, pack!"cc"('a', 'b') is equivalent to pack!"2c"('a', 'b'). Note that behaviour is different with strings: if type specifier is preceded by a number and parameter is an array, n characters are packed. For example: pack!"5c"("Hello World") will pack only first 5 characters.

Quick API reference

  • pack([string format])(T... params)

Packs specified parameters according to format. Passing inconvertible parameter and type specifier, results in static assert failure. All packed data is returned as ubyte[].

  • pack([string format])(File file, T... params)

Works exacly like previous one, except that all packed data is written to file.

  • unpack([string format])([ref] Range range, T... params)

Unpacks data from range and writes it to params. Range is taken by refernce is possible (auto ref), which means passed array of bytes is modified. To prevent that, pass yourarray.save as first parameter.

NOTE: Specified Range must be a valid input range of ubyte element type.

  • unpack(string format)([ref] Range range)
    unpack(string format)(File file)

Works exacly like previous one, except that all data is returned as tuple. In this overload format is required.

  • unpacker(string format)(Range range)

Returns instance of Unpacker struct. Usefull when there's repeating binary encoded data.

   ubyte[] bytes = pack!`<hshs`(1, "one", 2, "two");
   auto unpacker = unpacker!`<hs`(bytes);
   
   foreach(num, str; unpacker)
   {
       writeln(num, " ", str); // Prints 1 one\n 2 two
   }
Authors:
  • Robert PasiƄski
Dependencies:
none
Versions:
1.0.1 2016-Jul-29
1.0.0 2016-Jul-28
0.3.0 2014-Aug-26
0.2.0 2014-Mar-17
0.1.0 2014-Mar-09
Show all 6 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 2 downloads this month

  • 317 downloads total

Score:
1.9
Short URL:
pack-d.dub.pm