NAME

       memswap - swap the contents of two memory blocks

SYNOPSIS

       #include <publib.h>
       void memswap(void *block1, void *block2, size_t n);

DESCRIPTION

       memswap  will  swap the contents of the two blocks pointed by its first two arguments.  The last argument
       gives the size of the memory blocks.

EXAMPLE

       To swap two structs, one might do the following.

            struct tm tm1, tm2;

            memswap(&tm1, &tm2, sizeof(struct tm));

BUGS

       Using memswap to swap small portions of memory is inefficient.  It is not worth it  to  use  it  to  swap
       variables  of  any of the basic types, for instance.  Use inline code for such cases.  However, for large
       portions of memory, e.g., arrays, it is convenient.

       memswap can't swap variables whose address can't be taken.  This excludes  variables  with  the  register
       specifier  and  bitfields  in structs.  But then, there is no way to write a function (or macro) that can
       handle any kind of arguments.  Life is hard.

SEE ALSO

       publib(3)

AUTHOR

       Lars Wirzenius (lars.wirzenius@helsinki.fi)