rust/src/libstd/to_str.rs
Alex Crichton b78b749810 Remove all ToStr impls, add Show impls
This commit changes the ToStr trait to:

    impl<T: fmt::Show> ToStr for T {
        fn to_str(&self) -> ~str { format!("{}", *self) }
    }

The ToStr trait has been on the chopping block for quite awhile now, and this is
the final nail in its coffin. The trait and the corresponding method are not
being removed as part of this commit, but rather any implementations of the
`ToStr` trait are being forbidden because of the generic impl. The new way to
get the `to_str()` method to work is to implement `fmt::Show`.

Formatting into a `&mut Writer` (as `format!` does) is much more efficient than
`ToStr` when building up large strings. The `ToStr` trait forces many
intermediate allocations to be made while the `fmt::Show` trait allows
incremental buildup in the same heap allocated buffer. Additionally, the
`fmt::Show` trait is much more extensible in terms of interoperation with other
`Writer` instances and in more situations. By design the `ToStr` trait requires
at least one allocation whereas the `fmt::Show` trait does not require any
allocations.

Closes #8242
Closes #9806
2014-02-23 20:51:56 -08:00

61 lines
1.7 KiB
Rust

// Copyright 2012-2013 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.
/*!
The `ToStr` trait for converting to strings
*/
use fmt;
/// A generic trait for converting a value to a string
pub trait ToStr {
/// Converts the value of `self` to an owned string
fn to_str(&self) -> ~str;
}
/// Trait for converting a type to a string, consuming it in the process.
pub trait IntoStr {
/// Consume and convert to a string.
fn into_str(self) -> ~str;
}
impl<T: fmt::Show> ToStr for T {
fn to_str(&self) -> ~str { format!("{}", *self) }
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_simple_types() {
assert_eq!(1i.to_str(), ~"1");
assert_eq!((-1i).to_str(), ~"-1");
assert_eq!(200u.to_str(), ~"200");
assert_eq!(2u8.to_str(), ~"2");
assert_eq!(true.to_str(), ~"true");
assert_eq!(false.to_str(), ~"false");
assert_eq!(().to_str(), ~"()");
assert_eq!((~"hi").to_str(), ~"hi");
}
#[test]
fn test_vectors() {
let x: ~[int] = ~[];
assert_eq!(x.to_str(), ~"[]");
assert_eq!((~[1]).to_str(), ~"[1]");
assert_eq!((~[1, 2, 3]).to_str(), ~"[1, 2, 3]");
assert!((~[~[], ~[1], ~[1, 1]]).to_str() ==
~"[[], [1], [1, 1]]");
}
}