bswap(3) — Linux manual page

bswap(3)                Library Functions Manual                bswap(3)

NAME

       bswap_16, bswap_32, bswap_64 - reverse order of bytes

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <byteswap.h>

       uint16_t bswap_16(uint16_t x);
       uint32_t bswap_32(uint32_t x);
       uint64_t bswap_64(uint64_t x);

DESCRIPTION

       These functions return a value in which the order of the bytes in
       their 2-, 4-, or 8-byte arguments is reversed.

RETURN VALUE

       These functions return the value of their argument with the bytes
       reversed.

ERRORS

       These functions always succeed.

STANDARDS

       GNU.

EXAMPLES

       The program below swaps the bytes of the 8-byte integer supplied
       as its command-line argument.  The following shell session
       demonstrates the use of the program:

           $ ./a.out 0x0123456789abcdef
           0x123456789abcdef ==> 0xefcdab8967452301

   Program source

       #include <byteswap.h>
       #include <inttypes.h>
       #include <stdint.h>
       #include <stdio.h>
       #include <stdlib.h>

       int
       main(int argc, char *argv[])
       {
           uint64_t x;

           if (argc != 2) {
               fprintf(stderr, "Usage: %s <num>\n", argv[0]);
               exit(EXIT_FAILURE);
           }

           x = strtoull(argv[1], NULL, 0);
           printf("%#" PRIx64 " ==> %#" PRIx64 "\n", x, bswap_64(x));

           exit(EXIT_SUCCESS);
       }

SEE ALSO

       byteorder(3), endian(3)

COLOPHON

       This page is part of the man-pages (Linux kernel and C library
       user-space interface documentation) project.  Information about
       the project can be found at 
       ⟨https://www.kernel.org/doc/man-pages/⟩.  If you have a bug report
       for this manual page, see
       ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩.
       This page was obtained from the tarball man-pages-6.9.1.tar.gz
       fetched from
       ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ on
       2024-06-26.  If you discover any rendering problems in this HTML
       version of the page, or you believe there is a better or more up-
       to-date source for the page, or you have corrections or
       improvements to the information in this COLOPHON (which is not
       part of the original manual page), send a mail to
       man-pages@man7.org

Linux man-pages 6.9.1          2024-06-15                       bswap(3)

Pages that refer to this page: byteorder(3), endian(3)

---