NAME 
src/packfile/pf_items.c - Fetch/store packfile data
DESCRIPTION
Low level packfile functions to fetch and store Parrot data,
i.e.
INTVAL,
FLOATVAL,
STRING ...
PF_fetch_<item>() functions retrieve the datatype item from the opcode stream and convert byteordering or binary format on the fly,
depending on the packfile header.
PF_store_<item>() functions write the datatype item to the stream as is.
These functions don't check the available size.
PF_size_<item>() functions return the store size of item in opcode_t units.
Functions
static void cvt_num12_num8- convert i386 LE 12 byte long double to IEEE 754 8 byte double
static void cvt_num12_num8_be- RT#48260: Not yet documented!!!
static void cvt_num12_num8_le- RT#48260: Not yet documented!!!
static opcode_t fetch_op_test- RT#48260: Not yet documented!!!
static opcode_t fetch_op_mixed_le- opcode fetch helper function
- This is mostly wrong or at least untested
- Fetch an opcode and convert to LE
static opcode_t fetch_op_mixed_be- Fetch an opcode and convert to BE
static opcode_t fetch_op_be_4- RT#48260: Not yet documented!!!
static opcode_t fetch_op_be_8- RT#48260: Not yet documented!!!
static opcode_t fetch_op_le_4- RT#48260: Not yet documented!!!
static opcode_t fetch_op_le_8- RT#48260: Not yet documented!!!
opcode_t PF_fetch_opcode- Fetch an
opcode_tfrom the stream, converting byteorder if needed. opcode_t *PF_store_opcode- Store an
opcode_tto stream as is. size_t PF_size_opcode- Return size of an item in
opcode_tunits, which is 1 per definitionem. INTVAL PF_fetch_integer- Fetch an
INTVALfrom the stream, converting byteorder if needed. - XXX assumes
sizeof (INTVAL) == sizeof (opcode_t)- we don't haveINTVALsize in the PackFile header. opcode_t *PF_store_integer- Store an
INTVALto stream as is. size_t PF_size_integer- Return store size of
INTVALinopcode_tunits. FLOATVAL PF_fetch_number- Fetch a
FLOATVALfrom the stream, converting byteorder if needed. Then advance stream pointer by amount of packfile float size. opcode_t *PF_store_number- Write a
FLOATVALto the opcode stream as is. size_t PF_size_number- Return store size of FLOATVAL in opcode_t units.
STRING *PF_fetch_string- Fetch a
STRINGfrom bytecode and return a newSTRING. - Opcode format is:
opcode_t *PF_store_string- Write a STRING to the opcode stream.
size_t PF_size_string- Report store size of
STRINGinopcode_tunits. char *PF_fetch_cstring- Fetch a cstring from bytecode and return an allocated copy
opcode_t *PF_store_cstring- Write a 0-terminated string to the stream.
size_t PF_size_cstring- Return store size of a C-string in
opcode_tunits. void PackFile_assign_transforms- Assign transform functions to vtable.
opcode_t flags
opcode_t encoding
opcode_t type
opcode_t size
* data
HISTORY
Initial review by leo 2003.11.21
Most routines moved from src/packfile.c.
Renamed PackFile_* to PF_*
TODO
<PF_store_<type()>> - write an opcode_t stream to cursor in natural byte-ordering.
<PF_fetch_<type()>> - read items and possibly convert the foreign format.
<PF_size_<type()>> - return the needed size in opcode_t units.
