File: //proc/self/root/usr/include/hphp/runtime/base/zend-pack.h
/*
+----------------------------------------------------------------------+
| HipHop for PHP |
+----------------------------------------------------------------------+
| Copyright (c) 2010-present Facebook, Inc. (http://www.facebook.com) |
| Copyright (c) 1998-2010 Zend Technologies Ltd. (http://www.zend.com) |
+----------------------------------------------------------------------+
| This source file is subject to version 2.00 of the Zend license, |
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
| http://www.zend.com/license/2_00.txt. |
| If you did not receive a copy of the Zend license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@zend.com so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
*/
#ifndef incl_HPHP_ZEND_PACK_H_
#define incl_HPHP_ZEND_PACK_H_
#include <cstdint>
namespace HPHP {
///////////////////////////////////////////////////////////////////////////////
// pack/unpack
struct Variant;
struct String;
struct Array;
/**
* Implemented formats are A, a, h, H, c, C, s, S, i, I, l, L, n, N, f, d,
* x, X, Z and @.
*/
struct ZendPack {
ZendPack();
/**
* Takes one or more arguments and packs them into a binary string according
* to the format argument. pack() idea stolen from Perl (implemented formats
* behave the same as there).
*/
Variant pack(const String& fmt, const Array& argv);
/**
* Unpack binary string into named array elements according to format
* argument.
*
* unpack() is based on Perl's unpack(), but is modified a bit from there.
* Rather than depending on error-prone ordered lists or syntactically
* unpleasant pass-by-reference, we return an object with named parameters
* (like *_fetch_object()). Syntax is "f[repeat]name/...", where "f" is the
* formatter char (like pack()), "[repeat]" is the optional repeater
* argument, and "name" is the name of the variable to use.
* Example: "c2chars/nints" will return an object with fields
* chars1, chars2, and ints.
* Numeric pack types will return numbers, a and A will return strings,
* f and d will return doubles.
*/
Variant unpack(const String& fmt, const String& data);
private:
// Whether machine is little endian
char machine_little_endian;
// Mapping of byte from char (8bit) to int32 for machine endian
int64_t byte_map[1];
// Mappings of bytes from int (machine dependent) to int for machine endian
int64_t int_map[sizeof(int)];
// Mappings of bytes from shorts (16bit) for all endian environments
int64_t machine_endian_short_map[2];
int64_t big_endian_short_map[2];
int64_t little_endian_short_map[2];
// Mappings of bytes from int32s (32bit) for all endian environments
int64_t machine_endian_int32_map[4];
int64_t big_endian_int32_map[4];
int64_t little_endian_int32_map[4];
/* Mappings of bytes from int64s (64bit) for all endian environments */
int64_t machine_endian_int64_map[8];
int64_t big_endian_int64_map[8];
int64_t little_endian_int64_map[8];
void pack(const Variant& val, int64_t size, int64_t *map, char *output);
int64_t unpack(const char *data, int64_t size, int issigned, int64_t *map);
};
///////////////////////////////////////////////////////////////////////////////
}
#endif // incl_HPHP_ZEND_PACK_H_