Crate nostd

Expand description

nostd provides essential std-like types in no_std environments.

This crate re-exports types from the alloc and core crates under the familiar std path while also offering alternative implementations for types not available in those crates.

nostd aims to help port code written for std to no_std with minimal changes, often requiring only a replacement of std:: with nostd::.

⚠️ Warning: A successful build does not guarantee that the code will work as expected. Exercise caution and thoroughly test your application before using it in production.

§Features

std::prelude emulation

use nostd::prelude::*;
// Now you can access `Box`, `String`, `Vec`, etc.

std::io emulation by core2 (feature: io)
std::collections::hash_(map|set) emulation by hashbrown (feature: hashbrown)

§Usage

Add this to your Cargo.toml:

[dependencies]
nostd = "0.1"

By default, nostd is intended to be used in no_std environment. To use it in std environment, enable the std feature:

[features]
default = ["std"]
std = ["nostd/std"]

Modules§

alloc
any: Utilities for dynamic typing or type reflection.
arch: SIMD and vendor intrinsics module.
array: Utilities for the array primitive type.
ascii: Operations on ASCII strings and characters.
borrow
boxed: The Box<T> type for heap allocation.
bstr
cell: Shareable mutable containers.
char: Utilities for the char primitive type.
clone: The Clone trait for types that cannot be ‘implicitly copied’.
cmp: Utilities for comparing and ordering values.
collections
convert: Traits for conversions between types.
default: The Default trait for types with a default value.
error: Interfaces for working with Errors.
f32: Constants for the f32 single-precision floating point type.
f64: Constants for the f64 double-precision floating point type.
ffi
fmt
future: Asynchronous basic functionality.
hash: Generic hashing support.
hint: Hints to compiler that affects how code should be emitted or optimized.
i8Deprecation planned: Redundant constants module for the i8 primitive type.
i16Deprecation planned: Redundant constants module for the i16 primitive type.
i32Deprecation planned: Redundant constants module for the i32 primitive type.
i64Deprecation planned: Redundant constants module for the i64 primitive type.
i128Deprecation planned: Redundant constants module for the i128 primitive type.
io: Traits, helpers, and type definitions for core I/O functionality.
isizeDeprecation planned: Redundant constants module for the isize primitive type.
iter: Composable external iteration.
marker: Primitive traits and types representing basic properties of types.
mem: Basic functions for dealing with memory.
net: Networking primitives for IP communication.
num: Numeric traits and functions for the built-in numeric types.
ops: Overloadable operators.
option: Optional values.
panic: Panic support in the standard library.
pin: Types that pin data to a location in memory.
prelude: The nostd prelude
primitive: This module reexports the primitive types to allow usage that is not possibly shadowed by other declared types.
ptr: Manually manage memory through raw pointers.
rc: Single-threaded reference-counting pointers. ‘Rc’ stands for ‘Reference Counted’.
result: Error handling with the Result type.
slice
str
string: A UTF-8–encoded, growable string.
sync
task
time: Temporal quantification.
u8Deprecation planned: Redundant constants module for the u8 primitive type.
u16Deprecation planned: Redundant constants module for the u16 primitive type.
u32Deprecation planned: Redundant constants module for the u32 primitive type.
u64Deprecation planned: Redundant constants module for the u64 primitive type.
u128Deprecation planned: Redundant constants module for the u128 primitive type.
usizeDeprecation planned: Redundant constants module for the usize primitive type.
vec: A contiguous growable array type with heap-allocated contents, written Vec<T>.
wtf8
assert_matchesExperimental: Unstable module containing the unstable assert_matches macro.
async_iterExperimental: Composable asynchronous iteration.
autodiffExperimental: Unstable module containing the unstable autodiff macro.
contractsExperimental: Unstable module containing the unstable contracts lang items and attribute macros.
f16Experimental: Constants for the f16 half-precision floating point type.
f128Experimental: Constants for the f128 quadruple-precision floating point type.
fromExperimental: Unstable module containing the unstable From derive macro.
indexExperimental: Helper types for indexing slices.
intrinsicsExperimental: Compiler intrinsics.
osExperimental: OS-specific functionality.
panickingExperimental: Panic support for core
patExperimental: Helper module for exporting the pattern_type macro
profilingExperimental: Profiling markers for compiler instrumentation.
randomExperimental: Random value generation.
rangeExperimental: Experimental replacement range types
simdExperimental: Portable SIMD module.
ub_checksExperimental: Provides the assert_unsafe_precondition macro as well as some utility functions that cover common preconditions.
unsafe_binderExperimental: Operators used to turn types into unsafe binders and back.

Macros§

assert: Asserts that a boolean expression is true at runtime.
assert_eq: Asserts that two expressions are equal to each other (using PartialEq).
assert_ne: Asserts that two expressions are not equal to each other (using PartialEq).
cfg: Evaluates boolean combinations of configuration flags at compile-time.
column: Expands to the column number at which it was invoked.
compile_error: Causes compilation to fail with the given error message when encountered.
concat: Concatenates literals into a static string slice.
debug_assert: Asserts that a boolean expression is true at runtime.
debug_assert_eq: Asserts that two expressions are equal to each other.
debug_assert_ne: Asserts that two expressions are not equal to each other.
env: Inspects an environment variable at compile time.
export
file: Expands to the file name in which it was invoked.
format: Creates a String using interpolation of runtime expressions.
format_args: Constructs parameters for the other string-formatting macros.
import
include: Parses a file as an expression or an item according to the context.
include_bytes: Includes a file as a reference to a byte array.
include_str: Includes a UTF-8 encoded file as a string.
line: Expands to the line number on which it was invoked.
matches: Returns whether the given expression matches the provided pattern.
module_path: Expands to a string that represents the current module path.
option_env: Optionally inspects an environment variable at compile time.
panic: Panics the current thread.
stringify: Stringifies its arguments.
todo: Indicates unfinished code.
tryDeprecated: Unwraps a result or propagates its error.
unimplemented: Indicates unimplemented code by panicking with a message of “not implemented”.
unreachable: Indicates unreachable code.
vec: Creates a Vec containing the arguments.
write: Writes formatted data into a buffer.
writeln: Writes formatted data into a buffer, with a newline appended.
assert_unsafe_preconditionExperimental: Checks that the preconditions of an unsafe function are followed.
cfg_selectExperimental: Selects code at compile-time based on cfg predicates.
concat_bytesExperimental: Concatenates literals into a byte slice.
const_format_argsExperimental: Same as format_args, but can be used in some const contexts.
log_syntaxExperimental: Prints passed tokens into the standard output.
pattern_typeExperimental: Creates a pattern type.
trace_macrosExperimental: Enables or disables tracing functionality used for debugging other macros.

Crate nostd

Crate nostd Copy item path

§Features

§Usage

Modules§

Macros§

Crate nostd