swap.3 revision da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ds ;G \\*(;G\\f\\$1\\$3\\f\\$2
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.if !\\$4 .Af \\$2 \\$1 "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ie \\$3 .ft \\$1
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.nr ;G \\n(.f
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.Af "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7" "\\$8" "\\$9"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ft \\n(;G \}
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 \\n(.f "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 5 1 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.aF 1 5 "\\$1" "\\$2" "\\$3" "\\$4" "\\$5" "\\$6" "\\$7"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EX \" start example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.ta 1i 2i 3i 4i 5i 6i
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.de EE \" end example
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinswap \- integral representation conversion routines
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH SYNOPSIS
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "#include <swap.h>"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "int swapop(const void* internal, const void* external, int width);
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "int_max swapget(int op, const void* from, int width);"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "void* swapput(int op, void* to, int width, int_max value);"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L "void* swapmem(int op, const void* from, void* to, size_t n);"
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH DESCRIPTION
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThese routines convert integral constants between internal and
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinexternal representations.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThey are used to handle binary data generated by foreign programs.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinNew binary data representations should use the compact canonical form
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinprovided by the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR sfio (3)
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR sgetu .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinreturns the swap operation required to convert the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbyte integer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.L external
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbyte integer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.LR internal .
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe swap operation is a bit mask:
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinNo swapping necessary.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinThe largest native integral type is defined by the macro
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinin the header
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chindescribed in
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.IR int (3).
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinreturns the
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbyte integer in the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinswapped according to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbyte integer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chininto the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinswapped according to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinis returned.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinbytes from the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinto the buffer
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinaccording to
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chinmay be the same.
da2e3ebdc1edfbc5028edf1354e7dd2fa69a7968chin.SH "SEE ALSO"