swab(3)

swab3

Swap adjacent bytes

Usage

#include <unistd.h>

void

swab(const void * restrict src, void * restrict dst, ssize_t len);

Library

Standard C Library (libc, -lc)

Overview

The function swab() copies len bytes from the location referenced by src to the location referenced by dst, swapping adjacent bytes.

The argument len must be an even number. If len is less than zero, nothing will be done.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 40 times.

  1. 2.0.5–3.4
  2. 3.5–3.5.1
  3. 4.0
  4. 4.1–4.4
  5. 4.5–4.11
  6. 5.0–5.4
  7. 5.5
  8. 6.0–6.3
  9. 6.4
  10. 7.0
  11. 7.1
  12. 7.2
  13. 7.3
  14. 7.4
  15. 8.0
  16. 8.1
  17. 8.2
  18. 8.3
  19. 8.4
  20. 9.0
  21. 9.1
  22. 9.2
  23. 9.3
  24. 10.0
  25. 10.1
  26. 10.2
  27. 10.3
  28. 10.4
  29. 11.0
  30. 11.1
  31. 11.2
  32. 11.3
  33. 11.4
  34. 12.0
  35. 12.1
  36. 12.2
  37. 12.3
  38. 12.4
  39. 13.0–13.2
  40. 13.3–14.5
  41. 15.0–16.0

History

A swab() function appeared in Version 7 AT&T UNIX.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.