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:

Primitive Types

char

Character manipulation.

f32

Operations and constants for 32-bits floats (f32 type)

f64

Operations and constants for 64-bits floats (f64 type)

i16

Operations and constants for signed 16-bits integers (i16 type)

i32

Operations and constants for signed 32-bits integers (i32 type)

i64

Operations and constants for signed 64-bits integers (i64 type)

i8

Operations and constants for signed 8-bits integers (i8 type)

int

Operations and constants for architecture-sized signed integers (int type)

slice

Slice management and manipulation

str

String manipulation

u16

Operations and constants for unsigned 16-bits integers (u16 type)

u32

Operations and constants for unsigned 32-bits integers (u32 type)

u64

Operations and constants for unsigned 64-bits integer (u64 type)

u8

Operations and constants for unsigned 8-bits integers (u8 type)

uint

Operations and constants for architecture-sized unsigned integers (uint type)

Modules

any

Traits for dynamic typing of any 'static type (through runtime reflection)

atomic

Core atomic primitives

borrow

A module for working with borrowed data.

cell

Shareable mutable containers.

char

Character manipulation.

clone

The Clone trait for types that cannot be 'implicitly copied'

cmp

Defines the PartialOrd and PartialEq comparison traits.

default

The Default trait for types which may have meaningful default values.

f32

Operations and constants for 32-bits floats (f32 type)

f64

Operations and constants for 64-bits floats (f64 type)

finally

The Finally trait provides a method, finally on stack closures that emulates Java-style try/finally blocks.

fmt

Utilities for formatting and printing strings

hash

Generic hashing support.

i16

Operations and constants for signed 16-bits integers (i16 type)

i32

Operations and constants for signed 32-bits integers (i32 type)

i64

Operations and constants for signed 64-bits integers (i64 type)

i8

Operations and constants for signed 8-bits integers (i8 type)

int

Operations and constants for architecture-sized signed integers (int type)

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, *const T, and *mut T.

raw

Contains struct definitions for the layout of compiler built-in types.

result

Error handling with the Result type

simd

SIMD vectors.

slice

Slice management and manipulation

str

String manipulation

u16

Operations and constants for unsigned 16-bits integers (u16 type)

u32

Operations and constants for unsigned 32-bits integers (u32 type)

u64

Operations and constants for unsigned 64-bits integer (u64 type)

u8

Operations and constants for unsigned 8-bits integers (u8 type)

uint

Operations and constants for architecture-sized unsigned integers (uint type)

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 --cfg ndebug

debug_assert_eq!

Runtime assertion for equality, only without --cfg ndebug

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