NAME    [Toc]    [Back]

       swab - Swap bytes

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       void swab(
               const void *src,
               void *dest,
               ssize_t nbytes );

       The  following  definition of the swab() function does not
       conform to current standards and  is  supported  only  for
       System V compatibility: void swab(
               const char *from,
               char *to,
               int nbytes );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       swab():  XPG4, XPG4-UNIX

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Points  to  the location of the string to copy.  Points to
       the location to which  the  resulting  string  is  copied.
       Specifies  the  number  of  bytes to be copied. The nbytes
       parameter should have  an  even  value.  When  the  nbytes
       parameter  is  odd,  the  swab()  function  uses  nbytes-1
       instead. For the System V version of the swab()  function,
       nbytes  must  also be non-negative. If nbytes is negative,
       nothing is done.

DESCRIPTION    [Toc]    [Back]

       The swab() function copies the number of  bytes  specified
       by  the  nbytes  parameter from the location pointed to by
       the src parameter to the array  pointed  to  by  the  dest
       parameter,  exchanging  adjacent  bytes.  If copying takes
       place between objects that overlap, the behavior is  undefined.

SEE ALSO    [Toc]    [Back]

       Standards: standards(5)



                                                          swab(3)