auto merge of #18880 : barosl/rust/doc-fail-to-panic, r=alexcrichton
I found some occurrences of "failure" and "fails" in the documentation. I changed them to "panics" if it means a task panic. Otherwise I left it as is, or changed it to "errors" to clearly distinguish them. Also, I made a minor fix that is breaking the layout of a module page. "Example" is shown in an irrelevant place from the following page: http://doc.rust-lang.org/std/os/index.html
This commit is contained in:
commit
1e4e55aebc
22 changed files with 135 additions and 134 deletions
|
@ -258,9 +258,9 @@ impl Bitv {
|
||||||
|
|
||||||
/// Retrieves the value at index `i`.
|
/// Retrieves the value at index `i`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `i` is out of bounds.
|
/// Panics if `i` is out of bounds.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -285,9 +285,9 @@ impl Bitv {
|
||||||
|
|
||||||
/// Sets the value of a bit at a index `i`.
|
/// Sets the value of a bit at a index `i`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `i` is out of bounds.
|
/// Panics if `i` is out of bounds.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -353,9 +353,9 @@ impl Bitv {
|
||||||
/// Sets `self` to the union of `self` and `other`. Both bitvectors must be
|
/// Sets `self` to the union of `self` and `other`. Both bitvectors must be
|
||||||
/// the same length. Returns `true` if `self` changed.
|
/// the same length. Returns `true` if `self` changed.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the bitvectors are of different lengths.
|
/// Panics if the bitvectors are of different lengths.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -383,9 +383,9 @@ impl Bitv {
|
||||||
/// Sets `self` to the intersection of `self` and `other`. Both bitvectors
|
/// Sets `self` to the intersection of `self` and `other`. Both bitvectors
|
||||||
/// must be the same length. Returns `true` if `self` changed.
|
/// must be the same length. Returns `true` if `self` changed.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the bitvectors are of different lengths.
|
/// Panics if the bitvectors are of different lengths.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -413,9 +413,9 @@ impl Bitv {
|
||||||
/// element of `other` at the same index. Both bitvectors must be the same
|
/// element of `other` at the same index. Both bitvectors must be the same
|
||||||
/// length. Returns `true` if `self` changed.
|
/// length. Returns `true` if `self` changed.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the bitvectors are of different length.
|
/// Panics if the bitvectors are of different length.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -580,9 +580,9 @@ impl Bitv {
|
||||||
/// Compares a `Bitv` to a slice of `bool`s.
|
/// Compares a `Bitv` to a slice of `bool`s.
|
||||||
/// Both the `Bitv` and slice must have the same length.
|
/// Both the `Bitv` and slice must have the same length.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the the `Bitv` and slice are of different length.
|
/// Panics if the the `Bitv` and slice are of different length.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -718,7 +718,7 @@ impl Bitv {
|
||||||
|
|
||||||
/// Shortens by one element and returns the removed element.
|
/// Shortens by one element and returns the removed element.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Assert if empty.
|
/// Assert if empty.
|
||||||
///
|
///
|
||||||
|
|
|
@ -498,9 +498,9 @@ impl String {
|
||||||
|
|
||||||
/// Shortens a string to the specified length.
|
/// Shortens a string to the specified length.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `new_len` > current length,
|
/// Panics if `new_len` > current length,
|
||||||
/// or if `new_len` is not a character boundary.
|
/// or if `new_len` is not a character boundary.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
|
|
|
@ -941,9 +941,9 @@ impl<T> Vec<T> {
|
||||||
|
|
||||||
/// Appends an element to the back of a collection.
|
/// Appends an element to the back of a collection.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the number of elements in the vector overflows a `uint`.
|
/// Panics if the number of elements in the vector overflows a `uint`.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -1462,9 +1462,9 @@ impl<T> Vec<T> {
|
||||||
/// Converts a `Vec<T>` to a `Vec<U>` where `T` and `U` have the same
|
/// Converts a `Vec<T>` to a `Vec<U>` where `T` and `U` have the same
|
||||||
/// size and in case they are not zero-sized the same minimal alignment.
|
/// size and in case they are not zero-sized the same minimal alignment.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `T` and `U` have differing sizes or are not zero-sized and
|
/// Panics if `T` and `U` have differing sizes or are not zero-sized and
|
||||||
/// have differing minimal alignments.
|
/// have differing minimal alignments.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
|
|
|
@ -102,9 +102,9 @@ impl AtomicBool {
|
||||||
|
|
||||||
/// Load the value
|
/// Load the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Release` or `AcqRel`.
|
/// Panics if `order` is `Release` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn load(&self, order: Ordering) -> bool {
|
pub fn load(&self, order: Ordering) -> bool {
|
||||||
unsafe { atomic_load(self.v.get() as *const uint, order) > 0 }
|
unsafe { atomic_load(self.v.get() as *const uint, order) > 0 }
|
||||||
|
@ -112,9 +112,9 @@ impl AtomicBool {
|
||||||
|
|
||||||
/// Store the value
|
/// Store the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Acquire` or `AcqRel`.
|
/// Panics if `order` is `Acquire` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn store(&self, val: bool, order: Ordering) {
|
pub fn store(&self, val: bool, order: Ordering) {
|
||||||
let val = if val { UINT_TRUE } else { 0 };
|
let val = if val { UINT_TRUE } else { 0 };
|
||||||
|
@ -313,9 +313,9 @@ impl AtomicInt {
|
||||||
|
|
||||||
/// Load the value
|
/// Load the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Release` or `AcqRel`.
|
/// Panics if `order` is `Release` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn load(&self, order: Ordering) -> int {
|
pub fn load(&self, order: Ordering) -> int {
|
||||||
unsafe { atomic_load(self.v.get() as *const int, order) }
|
unsafe { atomic_load(self.v.get() as *const int, order) }
|
||||||
|
@ -323,9 +323,9 @@ impl AtomicInt {
|
||||||
|
|
||||||
/// Store the value
|
/// Store the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Acquire` or `AcqRel`.
|
/// Panics if `order` is `Acquire` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn store(&self, val: int, order: Ordering) {
|
pub fn store(&self, val: int, order: Ordering) {
|
||||||
unsafe { atomic_store(self.v.get(), val, order); }
|
unsafe { atomic_store(self.v.get(), val, order); }
|
||||||
|
@ -435,9 +435,9 @@ impl AtomicUint {
|
||||||
|
|
||||||
/// Load the value
|
/// Load the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Release` or `AcqRel`.
|
/// Panics if `order` is `Release` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn load(&self, order: Ordering) -> uint {
|
pub fn load(&self, order: Ordering) -> uint {
|
||||||
unsafe { atomic_load(self.v.get() as *const uint, order) }
|
unsafe { atomic_load(self.v.get() as *const uint, order) }
|
||||||
|
@ -445,9 +445,9 @@ impl AtomicUint {
|
||||||
|
|
||||||
/// Store the value
|
/// Store the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Acquire` or `AcqRel`.
|
/// Panics if `order` is `Acquire` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn store(&self, val: uint, order: Ordering) {
|
pub fn store(&self, val: uint, order: Ordering) {
|
||||||
unsafe { atomic_store(self.v.get(), val, order); }
|
unsafe { atomic_store(self.v.get(), val, order); }
|
||||||
|
@ -557,9 +557,9 @@ impl<T> AtomicPtr<T> {
|
||||||
|
|
||||||
/// Load the value
|
/// Load the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Release` or `AcqRel`.
|
/// Panics if `order` is `Release` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn load(&self, order: Ordering) -> *mut T {
|
pub fn load(&self, order: Ordering) -> *mut T {
|
||||||
unsafe {
|
unsafe {
|
||||||
|
@ -569,9 +569,9 @@ impl<T> AtomicPtr<T> {
|
||||||
|
|
||||||
/// Store the value
|
/// Store the value
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Acquire` or `AcqRel`.
|
/// Panics if `order` is `Acquire` or `AcqRel`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn store(&self, ptr: *mut T, order: Ordering) {
|
pub fn store(&self, ptr: *mut T, order: Ordering) {
|
||||||
unsafe { atomic_store(self.p.get(), ptr as uint, order); }
|
unsafe { atomic_store(self.p.get(), ptr as uint, order); }
|
||||||
|
@ -729,9 +729,9 @@ unsafe fn atomic_xor<T>(dst: *mut T, val: T, order: Ordering) -> T {
|
||||||
///
|
///
|
||||||
/// Accepts `Acquire`, `Release`, `AcqRel` and `SeqCst` orderings.
|
/// Accepts `Acquire`, `Release`, `AcqRel` and `SeqCst` orderings.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `order` is `Relaxed`
|
/// Panics if `order` is `Relaxed`
|
||||||
#[inline]
|
#[inline]
|
||||||
#[stable]
|
#[stable]
|
||||||
pub fn fence(order: Ordering) {
|
pub fn fence(order: Ordering) {
|
||||||
|
|
|
@ -274,9 +274,9 @@ impl<T> RefCell<T> {
|
||||||
/// The borrow lasts until the returned `Ref` exits scope. Multiple
|
/// The borrow lasts until the returned `Ref` exits scope. Multiple
|
||||||
/// immutable borrows can be taken out at the same time.
|
/// immutable borrows can be taken out at the same time.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the value is currently mutably borrowed.
|
/// Panics if the value is currently mutably borrowed.
|
||||||
#[unstable]
|
#[unstable]
|
||||||
pub fn borrow<'a>(&'a self) -> Ref<'a, T> {
|
pub fn borrow<'a>(&'a self) -> Ref<'a, T> {
|
||||||
match self.try_borrow() {
|
match self.try_borrow() {
|
||||||
|
@ -307,9 +307,9 @@ impl<T> RefCell<T> {
|
||||||
/// The borrow lasts until the returned `RefMut` exits scope. The value
|
/// The borrow lasts until the returned `RefMut` exits scope. The value
|
||||||
/// cannot be borrowed while this borrow is active.
|
/// cannot be borrowed while this borrow is active.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the value is currently borrowed.
|
/// Panics if the value is currently borrowed.
|
||||||
#[unstable]
|
#[unstable]
|
||||||
pub fn borrow_mut<'a>(&'a self) -> RefMut<'a, T> {
|
pub fn borrow_mut<'a>(&'a self) -> RefMut<'a, T> {
|
||||||
match self.try_borrow_mut() {
|
match self.try_borrow_mut() {
|
||||||
|
|
|
@ -87,9 +87,9 @@ pub fn from_u32(i: u32) -> Option<char> {
|
||||||
/// Returns `true` if `c` is a valid digit under `radix`, and `false`
|
/// Returns `true` if `c` is a valid digit under `radix`, and `false`
|
||||||
/// otherwise.
|
/// otherwise.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given a `radix` > 36.
|
/// Panics if given a `radix` > 36.
|
||||||
///
|
///
|
||||||
/// # Note
|
/// # Note
|
||||||
///
|
///
|
||||||
|
@ -113,9 +113,9 @@ pub fn is_digit_radix(c: char, radix: uint) -> bool {
|
||||||
/// 'b' or 'B', 11, etc. Returns none if the `char` does not
|
/// 'b' or 'B', 11, etc. Returns none if the `char` does not
|
||||||
/// refer to a digit in the given radix.
|
/// refer to a digit in the given radix.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given a `radix` outside the range `[0..36]`.
|
/// Panics if given a `radix` outside the range `[0..36]`.
|
||||||
///
|
///
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn to_digit(c: char, radix: uint) -> Option<uint> {
|
pub fn to_digit(c: char, radix: uint) -> Option<uint> {
|
||||||
|
@ -140,9 +140,9 @@ pub fn to_digit(c: char, radix: uint) -> Option<uint> {
|
||||||
/// Returns `Some(char)` if `num` represents one digit under `radix`,
|
/// Returns `Some(char)` if `num` represents one digit under `radix`,
|
||||||
/// using one character of `0-9` or `a-z`, or `None` if it doesn't.
|
/// using one character of `0-9` or `a-z`, or `None` if it doesn't.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given an `radix` > 36.
|
/// Panics if given an `radix` > 36.
|
||||||
///
|
///
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn from_digit(num: uint, radix: uint) -> Option<char> {
|
pub fn from_digit(num: uint, radix: uint) -> Option<char> {
|
||||||
|
@ -240,9 +240,9 @@ pub trait Char {
|
||||||
/// Returns `true` if `c` is a valid digit under `radix`, and `false`
|
/// Returns `true` if `c` is a valid digit under `radix`, and `false`
|
||||||
/// otherwise.
|
/// otherwise.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given a radix > 36.
|
/// Panics if given a radix > 36.
|
||||||
fn is_digit_radix(&self, radix: uint) -> bool;
|
fn is_digit_radix(&self, radix: uint) -> bool;
|
||||||
|
|
||||||
/// Converts a character to the corresponding digit.
|
/// Converts a character to the corresponding digit.
|
||||||
|
@ -253,9 +253,9 @@ pub trait Char {
|
||||||
/// 9. If `c` is 'a' or 'A', 10. If `c` is 'b' or 'B', 11, etc. Returns
|
/// 9. If `c` is 'a' or 'A', 10. If `c` is 'b' or 'B', 11, etc. Returns
|
||||||
/// none if the character does not refer to a digit in the given radix.
|
/// none if the character does not refer to a digit in the given radix.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given a radix outside the range [0..36].
|
/// Panics if given a radix outside the range [0..36].
|
||||||
fn to_digit(&self, radix: uint) -> Option<uint>;
|
fn to_digit(&self, radix: uint) -> Option<uint>;
|
||||||
|
|
||||||
/// Converts a number to the character representing it.
|
/// Converts a number to the character representing it.
|
||||||
|
@ -265,9 +265,9 @@ pub trait Char {
|
||||||
/// Returns `Some(char)` if `num` represents one digit under `radix`,
|
/// Returns `Some(char)` if `num` represents one digit under `radix`,
|
||||||
/// using one character of `0-9` or `a-z`, or `None` if it doesn't.
|
/// using one character of `0-9` or `a-z`, or `None` if it doesn't.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if given a radix > 36.
|
/// Panics if given a radix > 36.
|
||||||
fn from_digit(num: uint, radix: uint) -> Option<Self>;
|
fn from_digit(num: uint, radix: uint) -> Option<Self>;
|
||||||
|
|
||||||
/// Returns the hexadecimal Unicode escape of a character.
|
/// Returns the hexadecimal Unicode escape of a character.
|
||||||
|
|
|
@ -72,11 +72,11 @@ static DIGIT_E_RADIX: uint = ('e' as uint) - ('a' as uint) + 11u;
|
||||||
* - `f` - A closure to invoke with the bytes representing the
|
* - `f` - A closure to invoke with the bytes representing the
|
||||||
* float.
|
* float.
|
||||||
*
|
*
|
||||||
* # Failure
|
* # Panics
|
||||||
* - Fails if `radix` < 2 or `radix` > 36.
|
* - Panics if `radix` < 2 or `radix` > 36.
|
||||||
* - Fails if `radix` > 14 and `exp_format` is `ExpDec` due to conflict
|
* - Panics if `radix` > 14 and `exp_format` is `ExpDec` due to conflict
|
||||||
* between digit and exponent sign `'e'`.
|
* between digit and exponent sign `'e'`.
|
||||||
* - Fails if `radix` > 25 and `exp_format` is `ExpBin` due to conflict
|
* - Panics if `radix` > 25 and `exp_format` is `ExpBin` due to conflict
|
||||||
* between digit and exponent sign `'p'`.
|
* between digit and exponent sign `'p'`.
|
||||||
*/
|
*/
|
||||||
pub fn float_to_str_bytes_common<T: Float, U>(
|
pub fn float_to_str_bytes_common<T: Float, U>(
|
||||||
|
|
|
@ -62,7 +62,7 @@ use raw::Slice as RawSlice;
|
||||||
pub trait SlicePrelude<T> for Sized? {
|
pub trait SlicePrelude<T> for Sized? {
|
||||||
/// Returns a subslice spanning the interval [`start`, `end`).
|
/// Returns a subslice spanning the interval [`start`, `end`).
|
||||||
///
|
///
|
||||||
/// Fails when the end of the new slice lies beyond the end of the
|
/// Panics when the end of the new slice lies beyond the end of the
|
||||||
/// original slice (i.e. when `end > self.len()`) or when `start > end`.
|
/// original slice (i.e. when `end > self.len()`) or when `start > end`.
|
||||||
///
|
///
|
||||||
/// Slicing with `start` equal to `end` yields an empty slice.
|
/// Slicing with `start` equal to `end` yields an empty slice.
|
||||||
|
@ -71,7 +71,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
|
|
||||||
/// Returns a subslice from `start` to the end of the slice.
|
/// Returns a subslice from `start` to the end of the slice.
|
||||||
///
|
///
|
||||||
/// Fails when `start` is strictly greater than the length of the original slice.
|
/// Panics when `start` is strictly greater than the length of the original slice.
|
||||||
///
|
///
|
||||||
/// Slicing from `self.len()` yields an empty slice.
|
/// Slicing from `self.len()` yields an empty slice.
|
||||||
#[unstable = "waiting on final error conventions/slicing syntax"]
|
#[unstable = "waiting on final error conventions/slicing syntax"]
|
||||||
|
@ -79,7 +79,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
|
|
||||||
/// Returns a subslice from the start of the slice to `end`.
|
/// Returns a subslice from the start of the slice to `end`.
|
||||||
///
|
///
|
||||||
/// Fails when `end` is strictly greater than the length of the original slice.
|
/// Panics when `end` is strictly greater than the length of the original slice.
|
||||||
///
|
///
|
||||||
/// Slicing to `0` yields an empty slice.
|
/// Slicing to `0` yields an empty slice.
|
||||||
#[unstable = "waiting on final error conventions/slicing syntax"]
|
#[unstable = "waiting on final error conventions/slicing syntax"]
|
||||||
|
@ -91,7 +91,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
/// the index `mid` itself) and the second will contain all
|
/// the index `mid` itself) and the second will contain all
|
||||||
/// indices from `[mid, len)` (excluding the index `len` itself).
|
/// indices from `[mid, len)` (excluding the index `len` itself).
|
||||||
///
|
///
|
||||||
/// Fails if `mid > len`.
|
/// Panics if `mid > len`.
|
||||||
#[unstable = "waiting on final error conventions"]
|
#[unstable = "waiting on final error conventions"]
|
||||||
fn split_at<'a>(&'a self, mid: uint) -> (&'a [T], &'a [T]);
|
fn split_at<'a>(&'a self, mid: uint) -> (&'a [T], &'a [T]);
|
||||||
|
|
||||||
|
@ -121,9 +121,9 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
/// `size`. The windows overlap. If the slice is shorter than
|
/// `size`. The windows overlap. If the slice is shorter than
|
||||||
/// `size`, the iterator returns no values.
|
/// `size`, the iterator returns no values.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `size` is 0.
|
/// Panics if `size` is 0.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -144,9 +144,9 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
/// length of the slice, then the last chunk will not have length
|
/// length of the slice, then the last chunk will not have length
|
||||||
/// `size`.
|
/// `size`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `size` is 0.
|
/// Panics if `size` is 0.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -267,7 +267,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
|
|
||||||
/// Returns a mutable subslice spanning the interval [`start`, `end`).
|
/// Returns a mutable subslice spanning the interval [`start`, `end`).
|
||||||
///
|
///
|
||||||
/// Fails when the end of the new slice lies beyond the end of the
|
/// Panics when the end of the new slice lies beyond the end of the
|
||||||
/// original slice (i.e. when `end > self.len()`) or when `start > end`.
|
/// original slice (i.e. when `end > self.len()`) or when `start > end`.
|
||||||
///
|
///
|
||||||
/// Slicing with `start` equal to `end` yields an empty slice.
|
/// Slicing with `start` equal to `end` yields an empty slice.
|
||||||
|
@ -276,7 +276,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
|
|
||||||
/// Returns a mutable subslice from `start` to the end of the slice.
|
/// Returns a mutable subslice from `start` to the end of the slice.
|
||||||
///
|
///
|
||||||
/// Fails when `start` is strictly greater than the length of the original slice.
|
/// Panics when `start` is strictly greater than the length of the original slice.
|
||||||
///
|
///
|
||||||
/// Slicing from `self.len()` yields an empty slice.
|
/// Slicing from `self.len()` yields an empty slice.
|
||||||
#[unstable = "waiting on final error conventions"]
|
#[unstable = "waiting on final error conventions"]
|
||||||
|
@ -284,7 +284,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
|
|
||||||
/// Returns a mutable subslice from the start of the slice to `end`.
|
/// Returns a mutable subslice from the start of the slice to `end`.
|
||||||
///
|
///
|
||||||
/// Fails when `end` is strictly greater than the length of the original slice.
|
/// Panics when `end` is strictly greater than the length of the original slice.
|
||||||
///
|
///
|
||||||
/// Slicing to `0` yields an empty slice.
|
/// Slicing to `0` yields an empty slice.
|
||||||
#[unstable = "waiting on final error conventions"]
|
#[unstable = "waiting on final error conventions"]
|
||||||
|
@ -333,15 +333,15 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
/// not divide the length of the slice, then the last chunk will not
|
/// not divide the length of the slice, then the last chunk will not
|
||||||
/// have length `chunk_size`.
|
/// have length `chunk_size`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `chunk_size` is 0.
|
/// Panics if `chunk_size` is 0.
|
||||||
#[unstable = "waiting on iterator type name conventions"]
|
#[unstable = "waiting on iterator type name conventions"]
|
||||||
fn chunks_mut<'a>(&'a mut self, chunk_size: uint) -> MutChunks<'a, T>;
|
fn chunks_mut<'a>(&'a mut self, chunk_size: uint) -> MutChunks<'a, T>;
|
||||||
|
|
||||||
/// Swaps two elements in a slice.
|
/// Swaps two elements in a slice.
|
||||||
///
|
///
|
||||||
/// Fails if `a` or `b` are out of bounds.
|
/// Panics if `a` or `b` are out of bounds.
|
||||||
///
|
///
|
||||||
/// # Arguments
|
/// # Arguments
|
||||||
///
|
///
|
||||||
|
@ -364,7 +364,7 @@ pub trait SlicePrelude<T> for Sized? {
|
||||||
/// the index `mid` itself) and the second will contain all
|
/// the index `mid` itself) and the second will contain all
|
||||||
/// indices from `[mid, len)` (excluding the index `len` itself).
|
/// indices from `[mid, len)` (excluding the index `len` itself).
|
||||||
///
|
///
|
||||||
/// Fails if `mid > len`.
|
/// Panics if `mid > len`.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -1641,7 +1641,7 @@ pub mod bytes {
|
||||||
|
|
||||||
/// Copies data from `src` to `dst`
|
/// Copies data from `src` to `dst`
|
||||||
///
|
///
|
||||||
/// `src` and `dst` must not overlap. Fails if the length of `dst`
|
/// `src` and `dst` must not overlap. Panics if the length of `dst`
|
||||||
/// is less than the length of `src`.
|
/// is less than the length of `src`.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn copy_memory(dst: &mut [u8], src: &[u8]) {
|
pub fn copy_memory(dst: &mut [u8], src: &[u8]) {
|
||||||
|
|
|
@ -1084,7 +1084,7 @@ pub mod raw {
|
||||||
///
|
///
|
||||||
/// Returns the substring from [`begin`..`end`).
|
/// Returns the substring from [`begin`..`end`).
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// If begin is greater than end.
|
/// If begin is greater than end.
|
||||||
/// If end is greater than the length of the string.
|
/// If end is greater than the length of the string.
|
||||||
|
@ -1432,7 +1432,7 @@ pub trait StrPrelude for Sized? {
|
||||||
///
|
///
|
||||||
/// This operation is `O(1)`.
|
/// This operation is `O(1)`.
|
||||||
///
|
///
|
||||||
/// Fails when `begin` and `end` do not point to valid characters
|
/// Panics when `begin` and `end` do not point to valid characters
|
||||||
/// or point beyond the last character of the string.
|
/// or point beyond the last character of the string.
|
||||||
///
|
///
|
||||||
/// See also `slice_to` and `slice_from` for slicing prefixes and
|
/// See also `slice_to` and `slice_from` for slicing prefixes and
|
||||||
|
@ -1463,7 +1463,7 @@ pub trait StrPrelude for Sized? {
|
||||||
///
|
///
|
||||||
/// Equivalent to `self.slice(begin, self.len())`.
|
/// Equivalent to `self.slice(begin, self.len())`.
|
||||||
///
|
///
|
||||||
/// Fails when `begin` does not point to a valid character, or is
|
/// Panics when `begin` does not point to a valid character, or is
|
||||||
/// out of bounds.
|
/// out of bounds.
|
||||||
///
|
///
|
||||||
/// See also `slice`, `slice_to` and `slice_chars`.
|
/// See also `slice`, `slice_to` and `slice_chars`.
|
||||||
|
@ -1474,7 +1474,7 @@ pub trait StrPrelude for Sized? {
|
||||||
///
|
///
|
||||||
/// Equivalent to `self.slice(0, end)`.
|
/// Equivalent to `self.slice(0, end)`.
|
||||||
///
|
///
|
||||||
/// Fails when `end` does not point to a valid character, or is
|
/// Panics when `end` does not point to a valid character, or is
|
||||||
/// out of bounds.
|
/// out of bounds.
|
||||||
///
|
///
|
||||||
/// See also `slice`, `slice_from` and `slice_chars`.
|
/// See also `slice`, `slice_from` and `slice_chars`.
|
||||||
|
@ -1493,7 +1493,7 @@ pub trait StrPrelude for Sized? {
|
||||||
/// variants that use byte indices rather than code point
|
/// variants that use byte indices rather than code point
|
||||||
/// indices.
|
/// indices.
|
||||||
///
|
///
|
||||||
/// Fails if `begin` > `end` or the either `begin` or `end` are
|
/// Panics if `begin` > `end` or the either `begin` or `end` are
|
||||||
/// beyond the last character of the string.
|
/// beyond the last character of the string.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
|
@ -1577,7 +1577,7 @@ pub trait StrPrelude for Sized? {
|
||||||
/// The start and end of the string (when `index == self.len()`)
|
/// The start and end of the string (when `index == self.len()`)
|
||||||
/// are considered to be boundaries.
|
/// are considered to be boundaries.
|
||||||
///
|
///
|
||||||
/// Fails if `index` is greater than `self.len()`.
|
/// Panics if `index` is greater than `self.len()`.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -1645,7 +1645,7 @@ pub trait StrPrelude for Sized? {
|
||||||
/// A record {ch: char, next: uint} containing the char value and the byte
|
/// A record {ch: char, next: uint} containing the char value and the byte
|
||||||
/// index of the next Unicode character.
|
/// index of the next Unicode character.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// If `i` is greater than or equal to the length of the string.
|
/// If `i` is greater than or equal to the length of the string.
|
||||||
/// If `i` is not the index of the beginning of a valid UTF-8 character.
|
/// If `i` is not the index of the beginning of a valid UTF-8 character.
|
||||||
|
@ -1657,7 +1657,7 @@ pub trait StrPrelude for Sized? {
|
||||||
///
|
///
|
||||||
/// Returns 0 for next index if called on start index 0.
|
/// Returns 0 for next index if called on start index 0.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// If `i` is greater than the length of the string.
|
/// If `i` is greater than the length of the string.
|
||||||
/// If `i` is not an index following a valid UTF-8 character.
|
/// If `i` is not an index following a valid UTF-8 character.
|
||||||
|
@ -1674,7 +1674,7 @@ pub trait StrPrelude for Sized? {
|
||||||
/// assert_eq!(s.char_at(4), 'c');
|
/// assert_eq!(s.char_at(4), 'c');
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// If `i` is greater than or equal to the length of the string.
|
/// If `i` is greater than or equal to the length of the string.
|
||||||
/// If `i` is not the index of the beginning of a valid UTF-8 character.
|
/// If `i` is not the index of the beginning of a valid UTF-8 character.
|
||||||
|
@ -1682,7 +1682,7 @@ pub trait StrPrelude for Sized? {
|
||||||
|
|
||||||
/// Plucks the character ending at the `i`th byte of a string.
|
/// Plucks the character ending at the `i`th byte of a string.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// If `i` is greater than the length of the string.
|
/// If `i` is greater than the length of the string.
|
||||||
/// If `i` is not an index following a valid UTF-8 character.
|
/// If `i` is not an index following a valid UTF-8 character.
|
||||||
|
@ -1790,7 +1790,7 @@ pub trait StrPrelude for Sized? {
|
||||||
|
|
||||||
/// Returns the byte offset of an inner slice relative to an enclosing outer slice.
|
/// Returns the byte offset of an inner slice relative to an enclosing outer slice.
|
||||||
///
|
///
|
||||||
/// Fails if `inner` is not a direct slice contained within self.
|
/// Panics if `inner` is not a direct slice contained within self.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
|
|
@ -562,7 +562,7 @@ impl fmt::Show for Fail_ {
|
||||||
///
|
///
|
||||||
/// On success returns `Ok(Matches)`. Use methods such as `opt_present`
|
/// On success returns `Ok(Matches)`. Use methods such as `opt_present`
|
||||||
/// `opt_str`, etc. to interrogate results.
|
/// `opt_str`, etc. to interrogate results.
|
||||||
/// # Failure
|
/// # Errors
|
||||||
///
|
///
|
||||||
/// Returns `Err(Fail_)` on failure: use the `Show` implementation of `Fail_` to display
|
/// Returns `Err(Fail_)` on failure: use the `Show` implementation of `Fail_` to display
|
||||||
/// information about it.
|
/// information about it.
|
||||||
|
|
|
@ -141,9 +141,9 @@ impl CString {
|
||||||
/// API, so avoid calling it with a pointer to memory managed by Rust's
|
/// API, so avoid calling it with a pointer to memory managed by Rust's
|
||||||
/// allocator API, as the behaviour would not be well defined.
|
/// allocator API, as the behaviour would not be well defined.
|
||||||
///
|
///
|
||||||
///# Failure
|
///# Panics
|
||||||
///
|
///
|
||||||
/// Fails if `buf` is null
|
/// Panics if `buf` is null
|
||||||
pub unsafe fn new(buf: *const libc::c_char, owns_buffer: bool) -> CString {
|
pub unsafe fn new(buf: *const libc::c_char, owns_buffer: bool) -> CString {
|
||||||
assert!(!buf.is_null());
|
assert!(!buf.is_null());
|
||||||
CString { buf: buf, owns_buffer_: owns_buffer }
|
CString { buf: buf, owns_buffer_: owns_buffer }
|
||||||
|
@ -291,9 +291,9 @@ impl fmt::Show for CString {
|
||||||
pub trait ToCStr for Sized? {
|
pub trait ToCStr for Sized? {
|
||||||
/// Copy the receiver into a CString.
|
/// Copy the receiver into a CString.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the receiver has an interior null.
|
/// Panics the task if the receiver has an interior null.
|
||||||
fn to_c_str(&self) -> CString;
|
fn to_c_str(&self) -> CString;
|
||||||
|
|
||||||
/// Unsafe variant of `to_c_str()` that doesn't check for nulls.
|
/// Unsafe variant of `to_c_str()` that doesn't check for nulls.
|
||||||
|
@ -314,9 +314,9 @@ pub trait ToCStr for Sized? {
|
||||||
/// }
|
/// }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the receiver has an interior null.
|
/// Panics the task if the receiver has an interior null.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn with_c_str<T>(&self, f: |*const libc::c_char| -> T) -> T {
|
fn with_c_str<T>(&self, f: |*const libc::c_char| -> T) -> T {
|
||||||
let c_str = self.to_c_str();
|
let c_str = self.to_c_str();
|
||||||
|
|
|
@ -1237,9 +1237,9 @@ impl<K: Eq + Hash<S>, V: Clone, S, H: Hasher<S>> HashMap<K, V, H> {
|
||||||
|
|
||||||
/// Return a copy of the value corresponding to the key.
|
/// Return a copy of the value corresponding to the key.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the key is not present.
|
/// Panics if the key is not present.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
|
|
@ -489,9 +489,9 @@ impl<K, V, M: Deref<RawTable<K, V>>> GapThenFull<K, V, M> {
|
||||||
/// Rounds up to a multiple of a power of two. Returns the closest multiple
|
/// Rounds up to a multiple of a power of two. Returns the closest multiple
|
||||||
/// of `target_alignment` that is higher or equal to `unrounded`.
|
/// of `target_alignment` that is higher or equal to `unrounded`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `target_alignment` is not a power of two.
|
/// Panics if `target_alignment` is not a power of two.
|
||||||
fn round_up_to_next(unrounded: uint, target_alignment: uint) -> uint {
|
fn round_up_to_next(unrounded: uint, target_alignment: uint) -> uint {
|
||||||
assert!(target_alignment.is_power_of_two());
|
assert!(target_alignment.is_power_of_two());
|
||||||
(unrounded + target_alignment - 1) & !(target_alignment - 1)
|
(unrounded + target_alignment - 1) & !(target_alignment - 1)
|
||||||
|
|
|
@ -914,9 +914,9 @@ impl<'a> Reader for &'a mut Reader+'a {
|
||||||
/// Similar to `slice()` except this function only bounds the slice on the
|
/// Similar to `slice()` except this function only bounds the slice on the
|
||||||
/// capacity of `v`, not the length.
|
/// capacity of `v`, not the length.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails when `start` or `end` point outside the capacity of `v`, or when
|
/// Panics when `start` or `end` point outside the capacity of `v`, or when
|
||||||
/// `start` > `end`.
|
/// `start` > `end`.
|
||||||
// Private function here because we aren't sure if we want to expose this as
|
// Private function here because we aren't sure if we want to expose this as
|
||||||
// API yet. If so, it should be a method on Vec.
|
// API yet. If so, it should be a method on Vec.
|
||||||
|
|
|
@ -88,8 +88,8 @@ pub enum SignFormat {
|
||||||
* It returns a tuple because there can be ambiguity between a special value
|
* It returns a tuple because there can be ambiguity between a special value
|
||||||
* and a number representation at higher bases.
|
* and a number representation at higher bases.
|
||||||
*
|
*
|
||||||
* # Failure
|
* # Panics
|
||||||
* - Fails if `radix` < 2 or `radix` > 36.
|
* - Panics if `radix` < 2 or `radix` > 36.
|
||||||
*/
|
*/
|
||||||
fn int_to_str_bytes_common<T: Int>(num: T, radix: uint, sign: SignFormat, f: |u8|) {
|
fn int_to_str_bytes_common<T: Int>(num: T, radix: uint, sign: SignFormat, f: |u8|) {
|
||||||
assert!(2 <= radix && radix <= 36);
|
assert!(2 <= radix && radix <= 36);
|
||||||
|
@ -172,11 +172,11 @@ fn int_to_str_bytes_common<T: Int>(num: T, radix: uint, sign: SignFormat, f: |u8
|
||||||
* It returns a tuple because there can be ambiguity between a special value
|
* It returns a tuple because there can be ambiguity between a special value
|
||||||
* and a number representation at higher bases.
|
* and a number representation at higher bases.
|
||||||
*
|
*
|
||||||
* # Failure
|
* # Panics
|
||||||
* - Fails if `radix` < 2 or `radix` > 36.
|
* - Panics if `radix` < 2 or `radix` > 36.
|
||||||
* - Fails if `radix` > 14 and `exp_format` is `ExpDec` due to conflict
|
* - Panics if `radix` > 14 and `exp_format` is `ExpDec` due to conflict
|
||||||
* between digit and exponent sign `'e'`.
|
* between digit and exponent sign `'e'`.
|
||||||
* - Fails if `radix` > 25 and `exp_format` is `ExpBin` due to conflict
|
* - Panics if `radix` > 25 and `exp_format` is `ExpBin` due to conflict
|
||||||
* between digit and exponent sign `'p'`.
|
* between digit and exponent sign `'p'`.
|
||||||
*/
|
*/
|
||||||
pub fn float_to_str_bytes_common<T: Float>(
|
pub fn float_to_str_bytes_common<T: Float>(
|
||||||
|
|
|
@ -322,9 +322,9 @@ pub fn env_as_bytes() -> Vec<(Vec<u8>,Vec<u8>)> {
|
||||||
/// Any invalid UTF-8 bytes in the value are replaced by \uFFFD. See
|
/// Any invalid UTF-8 bytes in the value are replaced by \uFFFD. See
|
||||||
/// `String::from_utf8_lossy()` for details.
|
/// `String::from_utf8_lossy()` for details.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `n` has any interior NULs.
|
/// Panics if `n` has any interior NULs.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
@ -345,9 +345,9 @@ pub fn getenv(n: &str) -> Option<String> {
|
||||||
/// Fetches the environment variable `n` byte vector from the current process,
|
/// Fetches the environment variable `n` byte vector from the current process,
|
||||||
/// returning None if the variable isn't set.
|
/// returning None if the variable isn't set.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if `n` has any interior NULs.
|
/// Panics if `n` has any interior NULs.
|
||||||
pub fn getenv_as_bytes(n: &str) -> Option<Vec<u8>> {
|
pub fn getenv_as_bytes(n: &str) -> Option<Vec<u8>> {
|
||||||
use c_str::CString;
|
use c_str::CString;
|
||||||
|
|
||||||
|
@ -889,6 +889,7 @@ pub fn errno() -> uint {
|
||||||
}
|
}
|
||||||
|
|
||||||
/// Return the string corresponding to an `errno()` value of `errnum`.
|
/// Return the string corresponding to an `errno()` value of `errnum`.
|
||||||
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
/// ```rust
|
/// ```rust
|
||||||
/// use std::os;
|
/// use std::os;
|
||||||
|
@ -1474,7 +1475,7 @@ impl MemoryMap {
|
||||||
|
|
||||||
#[cfg(windows)]
|
#[cfg(windows)]
|
||||||
impl Drop for MemoryMap {
|
impl Drop for MemoryMap {
|
||||||
/// Unmap the mapping. Fails the task if any of `VirtualFree`,
|
/// Unmap the mapping. Panics the task if any of `VirtualFree`,
|
||||||
/// `UnmapViewOfFile`, or `CloseHandle` fail.
|
/// `UnmapViewOfFile`, or `CloseHandle` fail.
|
||||||
fn drop(&mut self) {
|
fn drop(&mut self) {
|
||||||
use libc::types::os::arch::extra::{LPCVOID, HANDLE};
|
use libc::types::os::arch::extra::{LPCVOID, HANDLE};
|
||||||
|
|
|
@ -154,9 +154,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the path contains a NUL.
|
/// Panics the task if the path contains a NUL.
|
||||||
///
|
///
|
||||||
/// See individual Path impls for additional restrictions.
|
/// See individual Path impls for additional restrictions.
|
||||||
#[inline]
|
#[inline]
|
||||||
|
@ -443,9 +443,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the filename contains a NUL.
|
/// Panics the task if the filename contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn set_filename<T: BytesContainer>(&mut self, filename: T) {
|
fn set_filename<T: BytesContainer>(&mut self, filename: T) {
|
||||||
assert!(!contains_nul(&filename));
|
assert!(!contains_nul(&filename));
|
||||||
|
@ -469,9 +469,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the extension contains a NUL.
|
/// Panics the task if the extension contains a NUL.
|
||||||
fn set_extension<T: BytesContainer>(&mut self, extension: T) {
|
fn set_extension<T: BytesContainer>(&mut self, extension: T) {
|
||||||
assert!(!contains_nul(&extension));
|
assert!(!contains_nul(&extension));
|
||||||
|
|
||||||
|
@ -518,9 +518,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the filename contains a NUL.
|
/// Panics the task if the filename contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn with_filename<T: BytesContainer>(&self, filename: T) -> Self {
|
fn with_filename<T: BytesContainer>(&self, filename: T) -> Self {
|
||||||
let mut p = self.clone();
|
let mut p = self.clone();
|
||||||
|
@ -543,9 +543,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the extension contains a NUL.
|
/// Panics the task if the extension contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn with_extension<T: BytesContainer>(&self, extension: T) -> Self {
|
fn with_extension<T: BytesContainer>(&self, extension: T) -> Self {
|
||||||
let mut p = self.clone();
|
let mut p = self.clone();
|
||||||
|
@ -602,9 +602,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the path contains a NUL.
|
/// Panics the task if the path contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn push<T: BytesContainer>(&mut self, path: T) {
|
fn push<T: BytesContainer>(&mut self, path: T) {
|
||||||
assert!(!contains_nul(&path));
|
assert!(!contains_nul(&path));
|
||||||
|
@ -671,9 +671,9 @@ pub trait GenericPath: Clone + GenericPathUnsafe {
|
||||||
/// # }
|
/// # }
|
||||||
/// ```
|
/// ```
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the path contains a NUL.
|
/// Panics the task if the path contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
fn join<T: BytesContainer>(&self, path: T) -> Self {
|
fn join<T: BytesContainer>(&self, path: T) -> Self {
|
||||||
let mut p = self.clone();
|
let mut p = self.clone();
|
||||||
|
|
|
@ -327,9 +327,9 @@ impl GenericPath for Path {
|
||||||
impl Path {
|
impl Path {
|
||||||
/// Returns a new Path from a byte vector or string
|
/// Returns a new Path from a byte vector or string
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails the task if the vector contains a NUL.
|
/// Panics the task if the vector contains a NUL.
|
||||||
#[inline]
|
#[inline]
|
||||||
pub fn new<T: BytesContainer>(path: T) -> Path {
|
pub fn new<T: BytesContainer>(path: T) -> Path {
|
||||||
GenericPath::new(path)
|
GenericPath::new(path)
|
||||||
|
|
|
@ -159,9 +159,9 @@ impl BytesContainer for Path {
|
||||||
impl GenericPathUnsafe for Path {
|
impl GenericPathUnsafe for Path {
|
||||||
/// See `GenericPathUnsafe::from_vec_unchecked`.
|
/// See `GenericPathUnsafe::from_vec_unchecked`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if not valid UTF-8.
|
/// Panics if not valid UTF-8.
|
||||||
#[inline]
|
#[inline]
|
||||||
unsafe fn new_unchecked<T: BytesContainer>(path: T) -> Path {
|
unsafe fn new_unchecked<T: BytesContainer>(path: T) -> Path {
|
||||||
let (prefix, path) = Path::normalize_(path.container_as_str().unwrap());
|
let (prefix, path) = Path::normalize_(path.container_as_str().unwrap());
|
||||||
|
@ -173,9 +173,9 @@ impl GenericPathUnsafe for Path {
|
||||||
|
|
||||||
/// See `GenericPathUnsafe::set_filename_unchecked`.
|
/// See `GenericPathUnsafe::set_filename_unchecked`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if not valid UTF-8.
|
/// Panics if not valid UTF-8.
|
||||||
unsafe fn set_filename_unchecked<T: BytesContainer>(&mut self, filename: T) {
|
unsafe fn set_filename_unchecked<T: BytesContainer>(&mut self, filename: T) {
|
||||||
let filename = filename.container_as_str().unwrap();
|
let filename = filename.container_as_str().unwrap();
|
||||||
match self.sepidx_or_prefix_len() {
|
match self.sepidx_or_prefix_len() {
|
||||||
|
@ -600,9 +600,9 @@ impl GenericPath for Path {
|
||||||
impl Path {
|
impl Path {
|
||||||
/// Returns a new `Path` from a `BytesContainer`.
|
/// Returns a new `Path` from a `BytesContainer`.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Fails if the vector contains a `NUL`, or if it contains invalid UTF-8.
|
/// Panics if the vector contains a `NUL`, or if it contains invalid UTF-8.
|
||||||
///
|
///
|
||||||
/// # Example
|
/// # Example
|
||||||
///
|
///
|
||||||
|
|
|
@ -43,7 +43,7 @@
|
||||||
//! "rendezvous" channel where each sender atomically hands off a message to
|
//! "rendezvous" channel where each sender atomically hands off a message to
|
||||||
//! a receiver.
|
//! a receiver.
|
||||||
//!
|
//!
|
||||||
//! ## Failure Propagation
|
//! ## Panic Propagation
|
||||||
//!
|
//!
|
||||||
//! In addition to being a core primitive for communicating in rust, channels
|
//! In addition to being a core primitive for communicating in rust, channels
|
||||||
//! are the points at which panics are propagated among tasks. Whenever the one
|
//! are the points at which panics are propagated among tasks. Whenever the one
|
||||||
|
|
|
@ -345,9 +345,9 @@ impl<T: Send + Sync> RWLock<T> {
|
||||||
/// Access the underlying data immutably. May run concurrently with other
|
/// Access the underlying data immutably. May run concurrently with other
|
||||||
/// reading tasks.
|
/// reading tasks.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// Failing will unlock the lock while unwinding. However, unlike all other
|
/// Panicking will unlock the lock while unwinding. However, unlike all other
|
||||||
/// access modes, this will not poison the lock.
|
/// access modes, this will not poison the lock.
|
||||||
pub fn read<'a>(&'a self) -> RWLockReadGuard<'a, T> {
|
pub fn read<'a>(&'a self) -> RWLockReadGuard<'a, T> {
|
||||||
let guard = self.lock.read();
|
let guard = self.lock.read();
|
||||||
|
|
|
@ -1116,7 +1116,7 @@ impl MetricMap {
|
||||||
|
|
||||||
/// Load MetricDiff from a file.
|
/// Load MetricDiff from a file.
|
||||||
///
|
///
|
||||||
/// # Failure
|
/// # Panics
|
||||||
///
|
///
|
||||||
/// This function will panic if the path does not exist or the path does not
|
/// This function will panic if the path does not exist or the path does not
|
||||||
/// contain a valid metric map.
|
/// contain a valid metric map.
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue