1#![cfg_attr(not(restricted_std), stable(feature = "rust1", since = "1.0.0"))]
220#![cfg_attr(
221 restricted_std,
222 unstable(
223 feature = "restricted_std",
224 issue = "none",
225 reason = "You have attempted to use a standard library built for a platform that it doesn't \
226 know how to support. Consider building it for a known environment, disabling it with \
227 `#![no_std]` or overriding this warning by enabling this feature."
228 )
229)]
230#![rustc_preserve_ub_checks]
231#![doc(
232 html_playground_url = "https://play.rust-lang.org/",
233 issue_tracker_base_url = "https://github.com/rust-lang/rust/issues/",
234 test(no_crate_inject, attr(deny(warnings))),
235 test(attr(allow(dead_code, deprecated, unused_variables, unused_mut)))
236)]
237#![doc(rust_logo)]
238#![doc(cfg_hide(
239 not(test),
240 not(any(test, bootstrap)),
241 no_global_oom_handling,
242 not(no_global_oom_handling)
243))]
244#![no_std]
246#![needs_panic_runtime]
248#![warn(deprecated_in_future)]
251#![warn(missing_docs)]
252#![warn(missing_debug_implementations)]
253#![allow(explicit_outlives_requirements)]
254#![allow(unused_lifetimes)]
255#![allow(internal_features)]
256#![deny(fuzzy_provenance_casts)]
257#![deny(unsafe_op_in_unsafe_fn)]
258#![allow(rustdoc::redundant_explicit_links)]
259#![warn(rustdoc::unescaped_backticks)]
260#![deny(ffi_unwind_calls)]
262#![allow(unused_features)]
264#![cfg_attr(test, feature(internal_output_capture, print_internals, update_panic_count, rt))]
267#![cfg_attr(
268 all(target_vendor = "fortanix", target_env = "sgx"),
269 feature(slice_index_methods, coerce_unsized, sgx_platform)
270)]
271#![cfg_attr(any(windows, target_os = "uefi"), feature(round_char_boundary))]
272#![cfg_attr(target_family = "wasm", feature(stdarch_wasm_atomic_wait))]
273#![cfg_attr(target_arch = "wasm64", feature(simd_wasm64))]
274#![cfg_attr(not(bootstrap), feature(autodiff))]
280#![feature(alloc_error_handler)]
281#![feature(allocator_internals)]
282#![feature(allow_internal_unsafe)]
283#![feature(allow_internal_unstable)]
284#![feature(asm_experimental_arch)]
285#![feature(cfg_sanitizer_cfi)]
286#![feature(cfg_target_thread_local)]
287#![feature(cfi_encoding)]
288#![feature(char_max_len)]
289#![feature(concat_idents)]
290#![feature(core_float_math)]
291#![feature(decl_macro)]
292#![feature(deprecated_suggestion)]
293#![feature(doc_cfg)]
294#![feature(doc_cfg_hide)]
295#![feature(doc_masked)]
296#![feature(doc_notable_trait)]
297#![feature(dropck_eyepatch)]
298#![feature(extended_varargs_abi_support)]
299#![feature(f128)]
300#![feature(f16)]
301#![feature(ffi_const)]
302#![feature(formatting_options)]
303#![feature(if_let_guard)]
304#![feature(intra_doc_pointers)]
305#![feature(iter_advance_by)]
306#![feature(iter_next_chunk)]
307#![feature(lang_items)]
308#![feature(link_cfg)]
309#![feature(linkage)]
310#![feature(macro_metavar_expr_concat)]
311#![feature(maybe_uninit_fill)]
312#![feature(min_specialization)]
313#![feature(must_not_suspend)]
314#![feature(needs_panic_runtime)]
315#![feature(negative_impls)]
316#![feature(never_type)]
317#![feature(optimize_attribute)]
318#![feature(prelude_import)]
319#![feature(rustc_attrs)]
320#![feature(rustdoc_internals)]
321#![feature(staged_api)]
322#![feature(stmt_expr_attributes)]
323#![feature(strict_provenance_lints)]
324#![feature(thread_local)]
325#![feature(try_blocks)]
326#![feature(try_trait_v2)]
327#![feature(type_alias_impl_trait)]
328#![feature(unsigned_signed_diff)]
329#![feature(array_chunks)]
334#![feature(bstr)]
335#![feature(bstr_internals)]
336#![feature(char_internals)]
337#![feature(clone_to_uninit)]
338#![feature(core_intrinsics)]
339#![feature(core_io_borrowed_buf)]
340#![feature(duration_constants)]
341#![feature(error_generic_member_access)]
342#![feature(error_iter)]
343#![feature(exact_size_is_empty)]
344#![feature(exclusive_wrapper)]
345#![feature(extend_one)]
346#![feature(float_algebraic)]
347#![feature(float_gamma)]
348#![feature(float_minimum_maximum)]
349#![feature(fmt_internals)]
350#![feature(generic_atomic)]
351#![feature(hasher_prefixfree_extras)]
352#![feature(hashmap_internals)]
353#![feature(hint_must_use)]
354#![feature(ip)]
355#![feature(lazy_get)]
356#![feature(maybe_uninit_slice)]
357#![feature(maybe_uninit_write_slice)]
358#![feature(nonnull_provenance)]
359#![feature(panic_can_unwind)]
360#![feature(panic_internals)]
361#![feature(pin_coerce_unsized_trait)]
362#![feature(pointer_is_aligned_to)]
363#![feature(portable_simd)]
364#![feature(ptr_as_uninit)]
365#![feature(ptr_mask)]
366#![feature(random)]
367#![feature(slice_internals)]
368#![feature(slice_ptr_get)]
369#![feature(slice_range)]
370#![feature(std_internals)]
371#![feature(str_internals)]
372#![feature(strict_provenance_atomic_ptr)]
373#![feature(sync_unsafe_cell)]
374#![feature(temporary_niche_types)]
375#![feature(ub_checks)]
376#![feature(used_with_arg)]
377#![feature(alloc_layout_extra)]
382#![feature(allocator_api)]
383#![feature(get_mut_unchecked)]
384#![feature(map_try_insert)]
385#![feature(new_zeroed_alloc)]
386#![feature(slice_concat_trait)]
387#![feature(thin_box)]
388#![feature(try_reserve_kind)]
389#![feature(try_with_capacity)]
390#![feature(unique_rc_arc)]
391#![feature(vec_into_raw_parts)]
392#![feature(panic_unwind)]
397#![feature(stdarch_internal)]
402#![feature(assert_matches)]
407#![feature(async_iterator)]
408#![feature(c_variadic)]
409#![feature(cfg_accessible)]
410#![feature(cfg_eval)]
411#![feature(concat_bytes)]
412#![feature(const_format_args)]
413#![feature(custom_test_frameworks)]
414#![feature(edition_panic)]
415#![feature(format_args_nl)]
416#![feature(log_syntax)]
417#![feature(test)]
418#![feature(trace_macros)]
419#![feature(io_const_error)]
426#![default_lib_allocator]
429
430#[prelude_import]
433#[allow(unused)]
434use prelude::rust_2021::*;
435
436#[cfg(test)]
438extern crate test;
439
440#[allow(unused_imports)] #[macro_use]
442extern crate alloc as alloc_crate;
443
444#[doc(masked)]
447#[allow(unused_extern_crates)]
448#[cfg(not(all(windows, target_env = "msvc")))]
449extern crate libc;
450
451#[doc(masked)]
453#[allow(unused_extern_crates)]
454extern crate unwind;
455
456#[doc(masked)]
460#[allow(unused_extern_crates)]
461#[cfg(all(
462 not(all(windows, target_env = "msvc", not(target_vendor = "uwp"))),
463 feature = "miniz_oxide"
464))]
465extern crate miniz_oxide;
466
467#[cfg(test)]
474extern crate std as realstd;
475
476#[macro_use]
478mod macros;
479
480#[macro_use]
483pub mod rt;
484
485pub mod prelude;
487
488#[stable(feature = "rust1", since = "1.0.0")]
489pub use core::any;
490#[stable(feature = "core_array", since = "1.35.0")]
491pub use core::array;
492#[unstable(feature = "async_iterator", issue = "79024")]
493pub use core::async_iter;
494#[stable(feature = "rust1", since = "1.0.0")]
495pub use core::cell;
496#[stable(feature = "rust1", since = "1.0.0")]
497pub use core::char;
498#[stable(feature = "rust1", since = "1.0.0")]
499pub use core::clone;
500#[stable(feature = "rust1", since = "1.0.0")]
501pub use core::cmp;
502#[stable(feature = "rust1", since = "1.0.0")]
503pub use core::convert;
504#[stable(feature = "rust1", since = "1.0.0")]
505pub use core::default;
506#[stable(feature = "futures_api", since = "1.36.0")]
507pub use core::future;
508#[stable(feature = "core_hint", since = "1.27.0")]
509pub use core::hint;
510#[stable(feature = "rust1", since = "1.0.0")]
511#[allow(deprecated, deprecated_in_future)]
512pub use core::i8;
513#[stable(feature = "rust1", since = "1.0.0")]
514#[allow(deprecated, deprecated_in_future)]
515pub use core::i16;
516#[stable(feature = "rust1", since = "1.0.0")]
517#[allow(deprecated, deprecated_in_future)]
518pub use core::i32;
519#[stable(feature = "rust1", since = "1.0.0")]
520#[allow(deprecated, deprecated_in_future)]
521pub use core::i64;
522#[stable(feature = "i128", since = "1.26.0")]
523#[allow(deprecated, deprecated_in_future)]
524pub use core::i128;
525#[stable(feature = "rust1", since = "1.0.0")]
526pub use core::intrinsics;
527#[stable(feature = "rust1", since = "1.0.0")]
528#[allow(deprecated, deprecated_in_future)]
529pub use core::isize;
530#[stable(feature = "rust1", since = "1.0.0")]
531pub use core::iter;
532#[stable(feature = "rust1", since = "1.0.0")]
533pub use core::marker;
534#[stable(feature = "rust1", since = "1.0.0")]
535pub use core::mem;
536#[stable(feature = "rust1", since = "1.0.0")]
537pub use core::ops;
538#[stable(feature = "rust1", since = "1.0.0")]
539pub use core::option;
540#[stable(feature = "pin", since = "1.33.0")]
541pub use core::pin;
542#[stable(feature = "rust1", since = "1.0.0")]
543pub use core::ptr;
544#[unstable(feature = "new_range_api", issue = "125687")]
545pub use core::range;
546#[stable(feature = "rust1", since = "1.0.0")]
547pub use core::result;
548#[stable(feature = "rust1", since = "1.0.0")]
549#[allow(deprecated, deprecated_in_future)]
550pub use core::u8;
551#[stable(feature = "rust1", since = "1.0.0")]
552#[allow(deprecated, deprecated_in_future)]
553pub use core::u16;
554#[stable(feature = "rust1", since = "1.0.0")]
555#[allow(deprecated, deprecated_in_future)]
556pub use core::u32;
557#[stable(feature = "rust1", since = "1.0.0")]
558#[allow(deprecated, deprecated_in_future)]
559pub use core::u64;
560#[stable(feature = "i128", since = "1.26.0")]
561#[allow(deprecated, deprecated_in_future)]
562pub use core::u128;
563#[unstable(feature = "unsafe_binders", issue = "130516")]
564pub use core::unsafe_binder;
565#[stable(feature = "rust1", since = "1.0.0")]
566#[allow(deprecated, deprecated_in_future)]
567pub use core::usize;
568
569#[stable(feature = "rust1", since = "1.0.0")]
570pub use alloc_crate::borrow;
571#[stable(feature = "rust1", since = "1.0.0")]
572pub use alloc_crate::boxed;
573#[stable(feature = "rust1", since = "1.0.0")]
574pub use alloc_crate::fmt;
575#[stable(feature = "rust1", since = "1.0.0")]
576pub use alloc_crate::format;
577#[stable(feature = "rust1", since = "1.0.0")]
578pub use alloc_crate::rc;
579#[stable(feature = "rust1", since = "1.0.0")]
580pub use alloc_crate::slice;
581#[stable(feature = "rust1", since = "1.0.0")]
582pub use alloc_crate::str;
583#[stable(feature = "rust1", since = "1.0.0")]
584pub use alloc_crate::string;
585#[stable(feature = "rust1", since = "1.0.0")]
586pub use alloc_crate::vec;
587
588#[path = "num/f128.rs"]
589pub mod f128;
590#[path = "num/f16.rs"]
591pub mod f16;
592#[path = "num/f32.rs"]
593pub mod f32;
594#[path = "num/f64.rs"]
595pub mod f64;
596
597#[macro_use]
598pub mod thread;
599pub mod ascii;
600pub mod backtrace;
601#[unstable(feature = "bstr", issue = "134915")]
602pub mod bstr;
603pub mod collections;
604pub mod env;
605pub mod error;
606pub mod ffi;
607pub mod fs;
608pub mod hash;
609pub mod io;
610pub mod net;
611pub mod num;
612pub mod os;
613pub mod panic;
614#[unstable(feature = "pattern_type_macro", issue = "123646")]
615pub mod pat;
616pub mod path;
617pub mod process;
618#[unstable(feature = "random", issue = "130703")]
619pub mod random;
620pub mod sync;
621pub mod time;
622
623#[path = "../../portable-simd/crates/std_float/src/lib.rs"]
626#[allow(missing_debug_implementations, dead_code, unsafe_op_in_unsafe_fn)]
627#[allow(rustdoc::bare_urls)]
628#[unstable(feature = "portable_simd", issue = "86656")]
629mod std_float;
630
631#[unstable(feature = "portable_simd", issue = "86656")]
632pub mod simd {
633 #![doc = include_str!("../../portable-simd/crates/core_simd/src/core_simd_docs.md")]
634
635 #[doc(inline)]
636 pub use core::simd::*;
637
638 #[doc(inline)]
639 pub use crate::std_float::StdFloat;
640}
641
642#[unstable(feature = "autodiff", issue = "124509")]
643#[cfg(not(bootstrap))]
644pub mod autodiff {
646 pub use core::autodiff::{autodiff_forward, autodiff_reverse};
648}
649
650#[stable(feature = "futures_api", since = "1.36.0")]
651pub mod task {
652 #[doc(inline)]
655 #[stable(feature = "wake_trait", since = "1.51.0")]
656 pub use alloc::task::*;
657 #[doc(inline)]
658 #[stable(feature = "futures_api", since = "1.36.0")]
659 pub use core::task::*;
660}
661
662#[doc = include_str!("../../stdarch/crates/core_arch/src/core_arch_docs.md")]
663#[stable(feature = "simd_arch", since = "1.27.0")]
664pub mod arch {
665 #[stable(feature = "simd_arch", since = "1.27.0")]
666 #[doc(no_inline)] pub use core::arch::*;
672
673 #[stable(feature = "simd_aarch64", since = "1.60.0")]
674 pub use std_detect::is_aarch64_feature_detected;
675 #[unstable(feature = "stdarch_arm_feature_detection", issue = "111190")]
676 pub use std_detect::is_arm_feature_detected;
677 #[unstable(feature = "is_loongarch_feature_detected", issue = "117425")]
678 pub use std_detect::is_loongarch_feature_detected;
679 #[unstable(feature = "is_riscv_feature_detected", issue = "111192")]
680 pub use std_detect::is_riscv_feature_detected;
681 #[unstable(feature = "stdarch_s390x_feature_detection", issue = "135413")]
682 pub use std_detect::is_s390x_feature_detected;
683 #[stable(feature = "simd_x86", since = "1.27.0")]
684 pub use std_detect::is_x86_feature_detected;
685 #[unstable(feature = "stdarch_mips_feature_detection", issue = "111188")]
686 pub use std_detect::{is_mips_feature_detected, is_mips64_feature_detected};
687 #[unstable(feature = "stdarch_powerpc_feature_detection", issue = "111191")]
688 pub use std_detect::{is_powerpc_feature_detected, is_powerpc64_feature_detected};
689}
690
691#[stable(feature = "simd_x86", since = "1.27.0")]
693pub use std_detect::is_x86_feature_detected;
694
695mod sys;
697mod sys_common;
698
699pub mod alloc;
700
701mod panicking;
703
704#[path = "../../backtrace/src/lib.rs"]
705#[allow(dead_code, unused_attributes, fuzzy_provenance_casts, unsafe_op_in_unsafe_fn)]
706mod backtrace_rs;
707
708#[unstable(feature = "cfg_select", issue = "115585")]
709pub use core::cfg_select;
710#[unstable(
711 feature = "concat_bytes",
712 issue = "87555",
713 reason = "`concat_bytes` is not stable enough for use and is subject to change"
714)]
715pub use core::concat_bytes;
716#[stable(feature = "matches_macro", since = "1.42.0")]
717#[allow(deprecated, deprecated_in_future)]
718pub use core::matches;
719#[stable(feature = "core_primitive", since = "1.43.0")]
720pub use core::primitive;
721#[stable(feature = "todo_macro", since = "1.40.0")]
722#[allow(deprecated, deprecated_in_future)]
723pub use core::todo;
724#[stable(feature = "builtin_macro_prelude", since = "1.38.0")]
726#[allow(deprecated)]
727pub use core::{
728 assert, assert_matches, cfg, column, compile_error, concat, concat_idents, const_format_args,
729 env, file, format_args, format_args_nl, include, include_bytes, include_str, line, log_syntax,
730 module_path, option_env, stringify, trace_macros,
731};
732#[stable(feature = "rust1", since = "1.0.0")]
734#[allow(deprecated, deprecated_in_future)]
735pub use core::{
736 assert_eq, assert_ne, debug_assert, debug_assert_eq, debug_assert_ne, r#try, unimplemented,
737 unreachable, write, writeln,
738};
739
740include!("../../core/src/primitive_docs.rs");
744
745include!("keyword_docs.rs");
749
750#[unstable(feature = "restricted_std", issue = "none")]
754mod __restricted_std_workaround {}
755
756mod sealed {
757 #[unstable(feature = "sealed", issue = "none")]
761 pub trait Sealed {}
762}
763
764#[cfg(test)]
765#[allow(dead_code)] pub(crate) mod test_helpers;