58 lines
1.8 KiB
Rust
58 lines
1.8 KiB
Rust
//! Platform-specific extensions to `std` for Windows.
|
|
//!
|
|
//! Provides access to platform-level information for Windows, and exposes
|
|
//! Windows-specific idioms that would otherwise be inappropriate as part
|
|
//! the core `std` library. These extensions allow developers to use
|
|
//! `std` types and idioms with Windows in a way that the normal
|
|
//! platform-agnostic idioms would not normally support.
|
|
//!
|
|
//! # Examples
|
|
//!
|
|
//! ```no_run
|
|
//! use std::fs::File;
|
|
//! use std::os::windows::prelude::*;
|
|
//!
|
|
//! fn main() -> std::io::Result<()> {
|
|
//! let f = File::create("foo.txt")?;
|
|
//! let handle = f.as_raw_handle();
|
|
//!
|
|
//! // use handle with native windows bindings
|
|
//!
|
|
//! Ok(())
|
|
//! }
|
|
//! ```
|
|
|
|
#![stable(feature = "rust1", since = "1.0.0")]
|
|
#![doc(cfg(windows))]
|
|
|
|
pub mod ffi;
|
|
pub mod fs;
|
|
pub mod io;
|
|
pub mod process;
|
|
pub mod raw;
|
|
pub mod thread;
|
|
|
|
/// A prelude for conveniently writing platform-specific code.
|
|
///
|
|
/// Includes all extension traits, and some important type definitions.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub mod prelude {
|
|
#[doc(no_inline)]
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use super::ffi::{OsStrExt, OsStringExt};
|
|
#[doc(no_inline)]
|
|
#[stable(feature = "file_offset", since = "1.15.0")]
|
|
pub use super::fs::FileExt;
|
|
#[doc(no_inline)]
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use super::fs::{MetadataExt, OpenOptionsExt};
|
|
#[doc(no_inline)]
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use super::io::{
|
|
AsHandle, AsSocket, BorrowedHandle, BorrowedSocket, FromRawHandle, FromRawSocket,
|
|
HandleOrInvalid, IntoRawHandle, IntoRawSocket, OwnedHandle, OwnedSocket,
|
|
};
|
|
#[doc(no_inline)]
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub use super::io::{AsRawHandle, AsRawSocket, RawHandle, RawSocket};
|
|
}
|