# 1.0.0[−][src]Function core::ptr::replace

    pub unsafe fn replace<T>(dst: *mut T, src: T) -> T

Moves `src` into the pointed `dst`, returning the previous `dst` value.

Neither value is dropped.

This function is semantically equivalent to `mem::replace` except that it operates on raw pointers instead of references. When references are available, `mem::replace` should be preferred.

# Safety

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

- `dst` must be valid for writes.

- `dst` must be properly aligned.

Note that even if `T` has size `0`, the pointer must be non-NULL and properly aligned.

# Examples

    use std::ptr;

    let mut rust = vec!['b', 'u', 's', 't'];

    // `mem::replace` would have the same effect without requiring the unsafe
    // block.
    let b = unsafe {
        ptr::replace(&mut rust[0], 'r')
    };

    assert_eq!(b, 'b');
    assert_eq!(rust, &['r', 'u', 's', 't']);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`)