comparison lispref/processes.texi @ 71035:3574bac9e172

(Bindat Functions): Rename `pos' and `raw-data' to `bindat-idx' and `bindat-raw' for clarity.

71034:ab929ce998c3

Evaluate @var{form}, a Lisp expression, for side-effect only.  If the
field name is specified, the value is bound to that field name.
@var{form} can access and update these dynamically bound variables:

@table @code
@item raw-data
The data as a byte array.

@item pos
Current position of the unpacking or packing operation.

@item struct
Alist.

@item last

@node Bindat Functions
@subsection Functions to Unpack and Pack Bytes

  In the following documentation, @var{spec} refers to a data layout
specification, @code{raw-data} to a byte array, and @var{struct} to an
alist representing unpacked field data.

@defun bindat-unpack spec raw-data &optional pos
This function unpacks data from the unibyte string or byte
array @code{raw-data}
according to @var{spec}.  Normally this starts unpacking at the
beginning of the byte array, but if @var{pos} is non-@code{nil}, it
specifies a zero-based starting position to use instead.

The value is an alist or nested alist in which each element describes
one unpacked field.
@end defun

@defun bindat-length spec struct
This function returns the total length of the data in @var{struct},
according to @var{spec}.
@end defun

@defun bindat-pack spec struct &optional raw-data pos
This function returns a byte array packed according to @var{spec} from
the data in the alist @var{struct}.  Normally it creates and fills a
new byte array starting at the beginning.  However, if @var{raw-data}
is non-@code{nil}, it specifies a pre-allocated unibyte string or vector to
pack into.  If @var{pos} is non-@code{nil}, it specifies the starting
offset for packing into @code{raw-data}.

When pre-allocating, you should make sure @code{(length @var{raw-data})}
meets or exceeds the total length to avoid an out-of-range error.
@end defun

@defun bindat-ip-to-string ip
Convert the Internet address vector @var{ip} to a string in the usual

71035:3574bac9e172

Evaluate @var{form}, a Lisp expression, for side-effect only.  If the
field name is specified, the value is bound to that field name.
@var{form} can access and update these dynamically bound variables:

@table @code
@item bindat-raw
The data as a byte array.

@item bindat-idx
Current index into bindat-raw of the unpacking or packing operation.

@item struct
Alist.

@item last

@node Bindat Functions
@subsection Functions to Unpack and Pack Bytes

  In the following documentation, @var{spec} refers to a data layout
specification, @code{bindat-raw} to a byte array, and @var{struct} to an
alist representing unpacked field data.

@defun bindat-unpack spec bindat-raw &optional bindat-idx
This function unpacks data from the unibyte string or byte
array @code{bindat-raw}
according to @var{spec}.  Normally this starts unpacking at the
beginning of the byte array, but if @var{bindat-idx} is non-@code{nil}, it
specifies a zero-based starting position to use instead.

The value is an alist or nested alist in which each element describes
one unpacked field.
@end defun

@defun bindat-length spec struct
This function returns the total length of the data in @var{struct},
according to @var{spec}.
@end defun

@defun bindat-pack spec struct &optional bindat-raw bindat-idx
This function returns a byte array packed according to @var{spec} from
the data in the alist @var{struct}.  Normally it creates and fills a
new byte array starting at the beginning.  However, if @var{bindat-raw}
is non-@code{nil}, it specifies a pre-allocated unibyte string or vector to
pack into.  If @var{bindat-idx} is non-@code{nil}, it specifies the starting
offset for packing into @code{bindat-raw}.

When pre-allocating, you should make sure @code{(length @var{bindat-raw})}
meets or exceeds the total length to avoid an out-of-range error.
@end defun

@defun bindat-ip-to-string ip
Convert the Internet address vector @var{ip} to a string in the usual