9348700007
This commit is an implementation of [RFC 1044][rfc] which adds additional surface area to the `std::fs` module. All new APIs are `#[unstable]` behind assorted feature names for each one. [rfc]: https://github.com/rust-lang/rfcs/pull/1044 The new APIs added are: * `fs::canonicalize` - bindings to `realpath` on unix and `GetFinalPathNameByHandle` on windows. * `fs::symlink_metadata` - similar to `lstat` on unix * `fs::FileType` and accessor methods as `is_{file,dir,symlink}` * `fs::Metadata::file_type` - accessor for the raw file type * `fs::DirEntry::metadata` - acquisition of metadata which is free on Windows but requires a syscall on unix. * `fs::DirEntry::file_type` - access the file type which may not require a syscall on most platforms. * `fs::DirEntry::file_name` - access just the file name without leading components. * `fs::PathExt::symlink_metadata` - convenience method for the top-level function. * `fs::PathExt::canonicalize` - convenience method for the top-level function. * `fs::PathExt::read_link` - convenience method for the top-level function. * `fs::PathExt::read_dir` - convenience method for the top-level function. * `std::os::raw` - type definitions for raw OS/C types available on all platforms. * `std::os::$platform` - new modules have been added for all currently supported platforms (e.g. those more specific than just `unix`). * `std::os::$platform::raw` - platform-specific type definitions. These modules are populated with the bare essentials necessary for lowing I/O types into their raw representations, and currently largely consist of the `stat` definition for unix platforms. This commit also deprecates `Metadata::{modified, accessed}` in favor of inspecting the raw representations via the lowering methods of `Metadata`.
63 lines
1.9 KiB
Rust
63 lines
1.9 KiB
Rust
// Copyright 2015 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
//! Unix-specific extension to the primitives in the `std::ffi` module
|
|
|
|
#![stable(feature = "rust1", since = "1.0.0")]
|
|
|
|
use ffi::{OsStr, OsString};
|
|
use mem;
|
|
use prelude::v1::*;
|
|
use sys::os_str::Buf;
|
|
use sys_common::{FromInner, IntoInner, AsInner};
|
|
|
|
/// Unix-specific extensions to `OsString`.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub trait OsStringExt {
|
|
/// Creates an `OsString` from a byte vector.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
fn from_vec(vec: Vec<u8>) -> Self;
|
|
|
|
/// Yields the underlying byte vector of this `OsString`.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
fn into_vec(self) -> Vec<u8>;
|
|
}
|
|
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
impl OsStringExt for OsString {
|
|
fn from_vec(vec: Vec<u8>) -> OsString {
|
|
FromInner::from_inner(Buf { inner: vec })
|
|
}
|
|
fn into_vec(self) -> Vec<u8> {
|
|
self.into_inner().inner
|
|
}
|
|
}
|
|
|
|
/// Unix-specific extensions to `OsStr`.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
pub trait OsStrExt {
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
fn from_bytes(slice: &[u8]) -> &Self;
|
|
|
|
/// Gets the underlying byte view of the `OsStr` slice.
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
fn as_bytes(&self) -> &[u8];
|
|
}
|
|
|
|
#[stable(feature = "rust1", since = "1.0.0")]
|
|
impl OsStrExt for OsStr {
|
|
fn from_bytes(slice: &[u8]) -> &OsStr {
|
|
unsafe { mem::transmute(slice) }
|
|
}
|
|
fn as_bytes(&self) -> &[u8] {
|
|
&self.as_inner().inner
|
|
}
|
|
}
|