Crate coreExperimental [stability]
[-]
[+]
[src]
The Rust Core Library
The Rust Core Library is the dependency-free foundation of The Rust Standard Library. It is the portable glue between the language and its libraries, defining the intrinsic and primitive building blocks of all Rust code. It links to no upstream libraries, no system libraries, and no libc.
The core library is minimal: it isn't even aware of heap allocation, nor does it provide concurrency or I/O. These things require platform integration, and this library is platform-agnostic.
It is not recommended to use the core library. The stable functionality of libcore is reexported from the standard library. The composition of this library is subject to change over time; only the interface exposed through libstd is intended to be stable.
How to use the core library
This library is built on the assumption of a few existing symbols:
memcpy
,memcmp
,memset
- These are core memory routines which are often generated by LLVM. Additionally, this library can make explicit calls to these functions. Their signatures are the same as found in C. These functions are often provided by the system libc, but can also be provided bylibrlibc
which is distributed with the standard rust distribution.rust_begin_unwind
- This function takes three arguments, afmt::Arguments
, a&str
, and auint
. These three arguments dictate the panic message, the file at which panic was invoked, and the line. It is up to consumers of this core library to define this panic function; it is only required to never return.
Primitive Types
char | Character manipulation. |
f32 | Operations and constants for 32-bits floats ( |
f64 | Operations and constants for 64-bits floats ( |
i16 | Operations and constants for signed 16-bits integers ( |
i32 | Operations and constants for signed 32-bits integers ( |
i64 | Operations and constants for signed 64-bits integers ( |
i8 | Operations and constants for signed 8-bits integers ( |
int | Operations and constants for architecture-sized signed integers ( |
slice | Slice management and manipulation |
str | String manipulation |
u16 | Operations and constants for unsigned 16-bits integers ( |
u32 | Operations and constants for unsigned 32-bits integers ( |
u64 | Operations and constants for unsigned 64-bits integer ( |
u8 | Operations and constants for unsigned 8-bits integers ( |
uint | Operations and constants for architecture-sized unsigned integers ( |
Modules
any | Traits for dynamic typing of any |
atomic | Core atomic primitives |
borrow | A module for working with borrowed data. |
cell | Shareable mutable containers. |
char | Character manipulation. |
clone | The |
cmp | Defines the |
default | The |
f32 | Operations and constants for 32-bits floats ( |
f64 | Operations and constants for 64-bits floats ( |
finally | The Finally trait provides a method, |
fmt | Utilities for formatting and printing strings |
hash | Generic hashing support. |
i16 | Operations and constants for signed 16-bits integers ( |
i32 | Operations and constants for signed 32-bits integers ( |
i64 | Operations and constants for signed 64-bits integers ( |
i8 | Operations and constants for signed 8-bits integers ( |
int | Operations and constants for architecture-sized signed integers ( |
intrinsics | rustc compiler intrinsics. |
iter | Composable external iterators |
kinds | Primitive traits representing basic 'kinds' of types |
mem | Basic functions for dealing with memory |
nonzero | Exposes the NonZero lang item which provides optimization hints. |
num | Numeric traits and functions for the built-in numeric types. |
ops | Overloadable operators |
option | Optional values |
panicking | Panic support for libcore |
prelude | The core prelude |
ptr | Operations on unsafe pointers, |
raw | Contains struct definitions for the layout of compiler built-in types. |
result | Error handling with the |
simd | SIMD vectors. |
slice | Slice management and manipulation |
str | String manipulation |
u16 | Operations and constants for unsigned 16-bits integers ( |
u32 | Operations and constants for unsigned 32-bits integers ( |
u64 | Operations and constants for unsigned 64-bits integer ( |
u8 | Operations and constants for unsigned 8-bits integers ( |
uint | Operations and constants for architecture-sized unsigned integers ( |
Macros
assert! | Runtime assertion, for details see std::macros |
assert_eq! | Runtime assertion for equality, for details see std::macros |
debug_assert! | Runtime assertion, disableable at compile time with |
debug_assert_eq! | Runtime assertion for equality, only without |
panic! | Entry point of task panic, for details, see std::macros |
try! | Short circuiting evaluation on Err |
unreachable! | |
write! | Writing a formatted string into a writer |
writeln! | Writing a formatted string plus a newline into a writer |