NAME
swab
—
swap adjacent bytes
LIBRARY
library “libc”
SYNOPSIS
#include
<unistd.h>
void
swab
(const
void * restrict src, void
* restrict dst, ssize_t
len);
DESCRIPTION
The functionswab
()
copies len bytes from the location referenced by
src to the location referenced by
dst, swapping adjacent bytes.
If len is negative or zero,
swab
() does
nothing. If len is odd, swab
()
copies len - 1 bytes and the disposition of the last
byte is unspecified.
SEE ALSO
STANDARDS
The swab
() function conforms to
IEEE Std 1003.1-2001 (“POSIX.1”).
HISTORY
A swab
() function appeared in
Version 7 AT&T UNIX. It was originally
documented to be “useful for carrying binary data between PDP11's and
other machines”.
In NetBSD 6.0 the type of len was changed from size_t to ssize_t for POSIX compliance.