core::ptr::swap_nonoverlapping - Rust
Description: API documentation for the Rust `swap_nonoverlapping` fn in crate `core`.
Keywords: rust, rustlang, rust-lang, swap_nonoverlapping

# 1.27.0[−][src]Function core::ptr::swap_nonoverlapping

    pub unsafe fn swap_nonoverlapping<T>(x: *mut T, y: *mut T, count: usize)

Swaps `count * size_of::<T>()` bytes between the two regions of memory beginning at `x` and `y`. The two regions must not overlap.

# Safety

Behavior is undefined if any of the following conditions are violated:

- Both `x` and `y` must be valid for reads and writes of `count * size_of::<T>()` bytes.

- Both `x` and `y` must be properly aligned.

- The region of memory beginning at `x` with a size of `count * size_of::<T>()` bytes must not overlap with the region of memory beginning at `y` with the same size.

Note that even if the effectively copied size (`count * size_of::<T>()`) is `0`, the pointers must be non-NULL and properly aligned.

# Examples

Basic usage:

    use std::ptr;

    let mut x = [1, 2, 3, 4];
    let mut y = [7, 8, 9];

    unsafe {
        ptr::swap_nonoverlapping(x.as_mut_ptr(), y.as_mut_ptr(), 2);
    }

    assert_eq!(x, [7, 8, 3, 4]);
    assert_eq!(y, [1, 2, 9]);Run

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g., `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g., `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g., `str,u8` or `String,struct:Vec,test`)