1#![cfg_attr(not(restricted_std), stable(feature = "rust1", since = "1.0.0"))]
217#![cfg_attr(
218 restricted_std,
219 unstable(
220 feature = "restricted_std",
221 issue = "none",
222 reason = "You have attempted to use a standard library built for a platform that it doesn't \
223 know how to support. Consider building it for a known environment, disabling it with \
224 `#![no_std]` or overriding this warning by enabling this feature."
225 )
226)]
227#![rustc_preserve_ub_checks]
228#![doc(
229 html_playground_url = "https://play.rust-lang.org/",
230 issue_tracker_base_url = "https://github.com/rust-lang/rust/issues/",
231 test(no_crate_inject, attr(deny(warnings))),
232 test(attr(allow(dead_code, deprecated, unused_variables, unused_mut)))
233)]
234#![doc(rust_logo)]
235#![doc(auto_cfg(hide(no_global_oom_handling)))]
236#![no_std]
238#![needs_panic_runtime]
240#![warn(deprecated_in_future)]
243#![warn(missing_docs)]
244#![warn(unreachable_pub)]
245#![warn(missing_debug_implementations)]
246#![allow(explicit_outlives_requirements)]
247#![allow(unused_lifetimes)]
248#![allow(internal_features)]
249#![deny(implicit_provenance_casts)]
250#![deny(unsafe_op_in_unsafe_fn)]
251#![allow(rustdoc::redundant_explicit_links)]
252#![warn(rustdoc::unescaped_backticks)]
253#![deny(ffi_unwind_calls)]
255#![allow(unused_features)]
257#![cfg_attr(
260 test,
261 feature(internal_output_capture, print_internals, super_let, update_panic_count, rt)
262)]
263#![cfg_attr(
264 all(target_vendor = "fortanix", target_env = "sgx"),
265 feature(slice_index_methods, coerce_unsized, sgx_platform)
266)]
267#![cfg_attr(all(test, target_os = "uefi"), feature(uefi_std))]
268#![cfg_attr(target_family = "wasm", feature(stdarch_wasm_atomic_wait))]
269#![cfg_attr(target_arch = "wasm64", feature(simd_wasm64))]
270#![feature(alloc_error_handler)]
274#![feature(allocator_internals)]
275#![feature(allow_internal_unsafe)]
276#![feature(allow_internal_unstable)]
277#![feature(asm_experimental_arch)]
278#![feature(autodiff)]
279#![feature(cfg_sanitizer_cfi)]
280#![feature(cfg_target_has_threads)]
281#![feature(cfg_target_thread_local)]
282#![feature(cfi_encoding)]
283#![feature(const_trait_impl)]
284#![feature(decl_macro)]
285#![feature(deprecated_suggestion)]
286#![feature(diagnostic_on_move)]
287#![feature(doc_cfg)]
288#![feature(doc_masked)]
289#![feature(doc_notable_trait)]
290#![feature(dropck_eyepatch)]
291#![feature(exact_div)]
292#![feature(f16)]
293#![feature(f128)]
294#![feature(ffi_const)]
295#![feature(gpu_offload)]
296#![feature(impl_restriction)]
297#![feature(intra_doc_pointers)]
298#![feature(lang_items)]
299#![feature(link_cfg)]
300#![feature(linkage)]
301#![feature(macro_metavar_expr_concat)]
302#![feature(min_specialization)]
303#![feature(must_not_suspend)]
304#![feature(needs_panic_runtime)]
305#![feature(negative_impls)]
306#![feature(optimize_attribute)]
307#![feature(prelude_import)]
308#![feature(rustc_attrs)]
309#![feature(rustdoc_internals)]
310#![feature(staged_api)]
311#![feature(stmt_expr_attributes)]
312#![feature(strict_provenance_lints)]
313#![feature(thread_local)]
314#![feature(try_blocks)]
315#![feature(try_trait_v2)]
316#![feature(type_alias_impl_trait)]
317#![feature(unwrap_infallible)]
318#![feature(borrowed_buf_init)]
323#![feature(bstr)]
324#![feature(bstr_internals)]
325#![feature(c_size_t)]
326#![feature(can_vector)]
327#![feature(cast_maybe_uninit)]
328#![feature(char_internals)]
329#![feature(clone_to_uninit)]
330#![feature(const_clone)]
331#![feature(const_convert)]
332#![feature(const_default)]
333#![feature(core_float_math)]
334#![feature(core_intrinsics)]
335#![feature(core_io)]
336#![feature(core_io_borrowed_buf)]
337#![feature(core_io_internals)]
338#![feature(cstr_display)]
339#![feature(cursor_split)]
340#![feature(derive_const)]
341#![feature(duration_constants)]
342#![feature(error_generic_member_access)]
343#![feature(error_iter)]
344#![feature(exact_size_is_empty)]
345#![feature(exclusive_wrapper)]
346#![feature(extend_one)]
347#![feature(float_gamma)]
348#![feature(float_minimum_maximum)]
349#![feature(fmt_internals)]
350#![feature(fn_static)]
351#![feature(formatting_options)]
352#![feature(funnel_shifts)]
353#![feature(generic_atomic)]
354#![feature(hash_map_internals)]
355#![feature(hash_map_macro)]
356#![feature(hasher_prefixfree_extras)]
357#![feature(hashmap_internals)]
358#![feature(hint_must_use)]
359#![feature(int_from_ascii)]
360#![feature(io_error_inprogress)]
361#![feature(io_error_input_output_error)]
362#![feature(io_error_more)]
363#![feature(io_error_too_many_open_files)]
364#![feature(io_error_uncategorized)]
365#![feature(io_slice_as_bytes)]
366#![feature(ip)]
367#![feature(iter_advance_by)]
368#![feature(iter_next_chunk)]
369#![feature(maybe_dangling)]
370#![feature(maybe_uninit_array_assume_init)]
371#![feature(maybe_uninit_fill)]
372#![feature(panic_can_unwind)]
373#![feature(panic_internals)]
374#![feature(pin_coerce_unsized_trait)]
375#![feature(pointer_is_aligned_to)]
376#![feature(portable_simd)]
377#![feature(ptr_as_uninit)]
378#![feature(ptr_cast_slice)]
379#![feature(ptr_mask)]
380#![feature(random)]
381#![feature(raw_os_error_ty)]
382#![feature(seek_io_take_position)]
383#![feature(seek_stream_len)]
384#![feature(share_trait)]
385#![feature(slice_internals)]
386#![feature(slice_ptr_get)]
387#![feature(slice_range)]
388#![feature(slice_split_once)]
389#![feature(std_internals)]
390#![feature(str_internals)]
391#![feature(sync_unsafe_cell)]
392#![feature(temporary_niche_types)]
393#![feature(trim_prefix_suffix)]
394#![feature(ub_checks)]
395#![feature(uint_carryless_mul)]
396#![feature(unsafe_pinned)]
397#![feature(used_with_arg)]
398#![feature(write_all_vectored)]
399#![feature(alloc_io)]
404#![feature(allocator_api)]
405#![feature(buf_read_has_data_left)]
406#![feature(clone_from_ref)]
407#![feature(get_mut_unchecked)]
408#![feature(map_try_insert)]
409#![feature(read_buf)]
410#![feature(slice_concat_trait)]
411#![feature(thin_box)]
412#![feature(try_reserve_kind)]
413#![feature(try_with_capacity)]
414#![feature(unique_rc_arc)]
415#![feature(wtf8_internals)]
416#![feature(panic_unwind)]
421#![feature(stdarch_internal)]
426#![feature(async_iterator)]
431#![feature(cfg_accessible)]
432#![feature(cfg_eval)]
433#![feature(concat_bytes)]
434#![feature(const_format_args)]
435#![feature(custom_test_frameworks)]
436#![feature(edition_panic)]
437#![feature(format_args_nl)]
438#![feature(log_syntax)]
439#![feature(test)]
440#![feature(trace_macros)]
441#![feature(io_const_error)]
448#![default_lib_allocator]
451#![unstable_removed(
453 feature = "concat_idents",
454 reason = "Replaced by the macro_metavar_expr_concat feature",
455 link = "https://github.com/rust-lang/rust/issues/29599#issuecomment-2986866250",
456 since = "1.90.0"
457)]
458
459pub mod prelude;
462
463#[prelude_import]
466#[allow(unused)]
467use prelude::rust_2024::*;
468
469#[cfg(test)]
471extern crate test;
472
473#[allow(unused_imports)] #[macro_use]
475extern crate alloc as alloc_crate;
476
477#[doc(masked)]
480#[allow(unused_extern_crates)]
481#[cfg(not(all(windows, target_env = "msvc")))]
482extern crate libc;
483
484#[doc(masked)]
486#[allow(unused_extern_crates)]
487extern crate unwind;
488
489#[doc(masked)]
493#[allow(unused_extern_crates)]
494#[cfg(all(
495 not(all(windows, target_env = "msvc", not(target_vendor = "uwp"))),
496 feature = "miniz_oxide"
497))]
498extern crate miniz_oxide;
499
500#[cfg(test)]
507extern crate std as realstd;
508
509#[macro_use]
511mod macros;
512
513#[macro_use]
516pub mod rt;
517
518#[stable(feature = "rust1", since = "1.0.0")]
519pub use core::any;
520#[stable(feature = "core_array", since = "1.35.0")]
521pub use core::array;
522#[unstable(feature = "async_iterator", issue = "79024")]
523pub use core::async_iter;
524#[stable(feature = "rust1", since = "1.0.0")]
525pub use core::cell;
526#[stable(feature = "rust1", since = "1.0.0")]
527pub use core::char;
528#[stable(feature = "rust1", since = "1.0.0")]
529pub use core::clone;
530#[stable(feature = "rust1", since = "1.0.0")]
531pub use core::cmp;
532#[stable(feature = "rust1", since = "1.0.0")]
533pub use core::convert;
534#[stable(feature = "rust1", since = "1.0.0")]
535pub use core::default;
536#[unstable(feature = "field_projections", issue = "145383")]
537pub use core::field;
538#[stable(feature = "futures_api", since = "1.36.0")]
539pub use core::future;
540#[stable(feature = "core_hint", since = "1.27.0")]
541pub use core::hint;
542#[stable(feature = "rust1", since = "1.0.0")]
543#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
544pub use core::i8;
545#[stable(feature = "rust1", since = "1.0.0")]
546#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
547pub use core::i16;
548#[stable(feature = "rust1", since = "1.0.0")]
549#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
550pub use core::i32;
551#[stable(feature = "rust1", since = "1.0.0")]
552#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
553pub use core::i64;
554#[stable(feature = "i128", since = "1.26.0")]
555#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
556pub use core::i128;
557#[stable(feature = "rust1", since = "1.0.0")]
558pub use core::intrinsics;
559#[stable(feature = "rust1", since = "1.0.0")]
560#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
561pub use core::isize;
562#[stable(feature = "rust1", since = "1.0.0")]
563pub use core::iter;
564#[stable(feature = "rust1", since = "1.0.0")]
565pub use core::marker;
566#[stable(feature = "rust1", since = "1.0.0")]
567pub use core::mem;
568#[stable(feature = "rust1", since = "1.0.0")]
569pub use core::ops;
570#[stable(feature = "rust1", since = "1.0.0")]
571pub use core::option;
572#[stable(feature = "pin", since = "1.33.0")]
573pub use core::pin;
574#[stable(feature = "rust1", since = "1.0.0")]
575pub use core::ptr;
576#[stable(feature = "new_range_api", since = "1.96.0")]
577pub use core::range;
578#[stable(feature = "rust1", since = "1.0.0")]
579pub use core::result;
580#[stable(feature = "rust1", since = "1.0.0")]
581#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
582pub use core::u8;
583#[stable(feature = "rust1", since = "1.0.0")]
584#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
585pub use core::u16;
586#[stable(feature = "rust1", since = "1.0.0")]
587#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
588pub use core::u32;
589#[stable(feature = "rust1", since = "1.0.0")]
590#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
591pub use core::u64;
592#[stable(feature = "i128", since = "1.26.0")]
593#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
594pub use core::u128;
595#[unstable(feature = "unsafe_binders", issue = "130516")]
596pub use core::unsafe_binder;
597#[stable(feature = "rust1", since = "1.0.0")]
598#[allow(deprecated, deprecated_in_future, clippy::legacy_numeric_constants)]
599pub use core::usize;
600
601#[stable(feature = "rust1", since = "1.0.0")]
602pub use alloc_crate::borrow;
603#[stable(feature = "rust1", since = "1.0.0")]
604pub use alloc_crate::boxed;
605#[stable(feature = "rust1", since = "1.0.0")]
606pub use alloc_crate::fmt;
607#[stable(feature = "rust1", since = "1.0.0")]
608pub use alloc_crate::format;
609#[stable(feature = "rust1", since = "1.0.0")]
610pub use alloc_crate::rc;
611#[stable(feature = "rust1", since = "1.0.0")]
612pub use alloc_crate::slice;
613#[stable(feature = "rust1", since = "1.0.0")]
614pub use alloc_crate::str;
615#[stable(feature = "rust1", since = "1.0.0")]
616pub use alloc_crate::string;
617#[stable(feature = "rust1", since = "1.0.0")]
618pub use alloc_crate::vec;
619
620#[path = "num/f128.rs"]
621pub mod f128;
622#[path = "num/f16.rs"]
623pub mod f16;
624#[path = "num/f32.rs"]
625pub mod f32;
626#[path = "num/f64.rs"]
627pub mod f64;
628
629#[macro_use]
630pub mod thread;
631pub mod ascii;
632pub mod backtrace;
633#[unstable(feature = "bstr", issue = "134915")]
634pub mod bstr;
635pub mod collections;
636pub mod env;
637pub mod error;
638pub mod ffi;
639pub mod fs;
640pub mod hash;
641pub mod io;
642pub mod net;
643pub mod num;
644#[allow(unreachable_pub)]
645pub mod os;
646pub mod panic;
647#[unstable(feature = "pattern_type_macro", issue = "123646")]
648pub mod pat;
649pub mod path;
650pub mod process;
651#[unstable(feature = "random", issue = "130703")]
652pub mod random;
653pub mod sync;
654pub mod time;
655#[unstable(feature = "view_type_macro", issue = "155938")]
656pub mod view;
657
658#[path = "../../portable-simd/crates/std_float/src/lib.rs"]
661#[allow(missing_debug_implementations, dead_code, unsafe_op_in_unsafe_fn)]
662#[allow(rustdoc::bare_urls)]
663#[unstable(feature = "portable_simd", issue = "86656")]
664mod std_float;
665
666#[unstable(feature = "portable_simd", issue = "86656")]
667pub mod simd {
668 #![doc = include_str!("../../portable-simd/crates/core_simd/src/core_simd_docs.md")]
669
670 #[doc(inline)]
671 pub use core::simd::*;
672
673 #[doc(inline)]
674 pub use crate::std_float::StdFloat;
675}
676
677#[unstable(feature = "autodiff", issue = "124509")]
678#[doc = include_str!("../../core/src/autodiff.md")]
679pub mod autodiff {
680 pub use core::autodiff::{autodiff_forward, autodiff_reverse};
682}
683
684#[unstable(feature = "gpu_offload", issue = "131513")]
685#[doc = include_str!("../../core/src/offload.md")]
686pub mod offload {
687 pub use core::offload::{offload, offload_kernel};
688}
689
690#[stable(feature = "futures_api", since = "1.36.0")]
691pub mod task {
692 #[doc(inline)]
695 #[stable(feature = "wake_trait", since = "1.51.0")]
696 pub use alloc::task::*;
697 #[doc(inline)]
698 #[stable(feature = "futures_api", since = "1.36.0")]
699 pub use core::task::*;
700}
701
702#[doc = include_str!("../../stdarch/crates/core_arch/src/core_arch_docs.md")]
703#[stable(feature = "simd_arch", since = "1.27.0")]
704pub mod arch {
705 #[stable(feature = "simd_arch", since = "1.27.0")]
706 #[doc(no_inline)] pub use core::arch::*;
712
713 #[stable(feature = "simd_aarch64", since = "1.60.0")]
714 pub use std_detect::is_aarch64_feature_detected;
715 #[unstable(feature = "stdarch_arm_feature_detection", issue = "111190")]
716 pub use std_detect::is_arm_feature_detected;
717 #[stable(feature = "stdarch_loongarch_feature", since = "1.89.0")]
718 pub use std_detect::is_loongarch_feature_detected;
719 #[stable(feature = "riscv_ratified", since = "1.78.0")]
720 pub use std_detect::is_riscv_feature_detected;
721 #[stable(feature = "stdarch_s390x_feature_detection", since = "1.93.0")]
722 pub use std_detect::is_s390x_feature_detected;
723 #[stable(feature = "simd_x86", since = "1.27.0")]
724 pub use std_detect::is_x86_feature_detected;
725 #[unstable(feature = "stdarch_mips_feature_detection", issue = "111188")]
726 pub use std_detect::{is_mips_feature_detected, is_mips64_feature_detected};
727 #[unstable(feature = "stdarch_powerpc_feature_detection", issue = "111191")]
728 pub use std_detect::{is_powerpc_feature_detected, is_powerpc64_feature_detected};
729}
730
731#[stable(feature = "simd_x86", since = "1.27.0")]
733pub use std_detect::is_x86_feature_detected;
734
735#[allow(unreachable_pub)]
736mod sys;
737
738pub mod alloc;
739
740mod panicking;
742
743#[path = "../../backtrace/src/lib.rs"]
744#[allow(dead_code, unused_attributes, implicit_provenance_casts, unsafe_op_in_unsafe_fn)]
745#[allow(clippy::len_zero, clippy::needless_borrow, clippy::filter_map_next)] mod backtrace_rs;
747
748#[stable(feature = "cfg_select", since = "1.95.0")]
749pub use core::cfg_select;
750#[unstable(
751 feature = "concat_bytes",
752 issue = "87555",
753 reason = "`concat_bytes` is not stable enough for use and is subject to change"
754)]
755pub use core::concat_bytes;
756#[allow(clippy::useless_attribute)]
757#[expect(
758 ineffective_unstable_reexports,
759 reason = "accepted as stable after accidental stabilization in 1.96, see #154645"
760)]
761#[unstable(feature = "derive_macro_global_path", issue = "154645")]
762pub use core::derive;
763#[stable(feature = "matches_macro", since = "1.42.0")]
764#[allow(deprecated, deprecated_in_future)]
765pub use core::matches;
766#[stable(feature = "core_primitive", since = "1.43.0")]
767pub use core::primitive;
768#[stable(feature = "todo_macro", since = "1.40.0")]
769#[allow(deprecated, deprecated_in_future)]
770pub use core::todo;
771#[stable(feature = "builtin_macro_prelude", since = "1.38.0")]
773pub use core::{
774 assert, cfg, column, compile_error, concat, const_format_args, env, file, format_args,
775 format_args_nl, include, include_bytes, include_str, line, log_syntax, module_path, option_env,
776 stringify, trace_macros,
777};
778#[stable(feature = "rust1", since = "1.0.0")]
780#[allow(deprecated, deprecated_in_future)]
781pub use core::{
782 assert_eq, assert_ne, debug_assert, debug_assert_eq, debug_assert_ne, r#try, unimplemented,
783 unreachable, write, writeln,
784};
785#[stable(feature = "assert_matches", since = "1.96.0")]
786pub use core::{assert_matches, debug_assert_matches};
787
788#[unstable(feature = "derive_from", issue = "144889")]
790pub mod from {
792 #[unstable(feature = "derive_from", issue = "144889")]
793 pub use core::from::From;
794}
795
796include!("../../core/src/attribute_docs.rs");
803
804include!("../../core/src/keyword_docs.rs");
808
809include!("../../core/src/primitive_docs.rs");
813
814#[unstable(feature = "restricted_std", issue = "none")]
818mod __restricted_std_workaround {}
819
820#[cfg(test)]
821#[allow(dead_code)] pub(crate) mod test_helpers;