std::hint::black_box - Rust
Description: API documentation for the Rust `black_box` fn in crate `std`.
Keywords: rust, rustlang, rust-lang, black_box

# [−][src]Function std::hint::black_box

    pub fn black_box<T>(dummy: T) -> T

🔬 This is a nightly-only experimental API. (`test` #50297)

An identity function that hints to the compiler to be maximally pessimistic about what `black_box` could do.

Unlike `std::convert::identity`, a Rust compiler is encouraged to assume that `black_box` can use `x` in any possible valid way that Rust code is allowed to without introducing undefined behavior in the calling code. This property makes `black_box` useful for writing code in which certain optimizations are not desired, such as benchmarks.

Note however, that `black_box` is only (and can only be) provided on a "best-effort" basis. The extent to which it can block optimisations may vary depending upon the platform and code-gen backend used. Programs cannot rely on `black_box` for correctness in any way.

# 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`)