fa7cbb5a46
Add libunicode; move unicode functions from core
- created new crate, libunicode, below libstd
- split `Char` trait into `Char` (libcore) and `UnicodeChar` (libunicode)
- Unicode-aware functions now live in libunicode
- `is_alphabetic`, `is_XID_start`, `is_XID_continue`, `is_lowercase`,
`is_uppercase`, `is_whitespace`, `is_alphanumeric`, `is_control`, `is_digit`,
`to_uppercase`, `to_lowercase`
- added `width` method in UnicodeChar trait
- determines printed width of character in columns, or None if it is a non-NULL control character
- takes a boolean argument indicating whether the present context is CJK or not (characters with 'A'mbiguous widths are double-wide in CJK contexts, single-wide otherwise)
- split `StrSlice` into `StrSlice` (libcore) and `UnicodeStrSlice` (libunicode)
- functionality formerly in `StrSlice` that relied upon Unicode functionality from `Char` is now in `UnicodeStrSlice`
- `words`, `is_whitespace`, `is_alphanumeric`, `trim`, `trim_left`, `trim_right`
- also moved `Words` type alias into libunicode because `words` method is in `UnicodeStrSlice`
- unified Unicode tables from libcollections, libcore, and libregex into libunicode
- updated `unicode.py` in `src/etc` to generate aforementioned tables
- generated new tables based on latest Unicode data
- added `UnicodeChar` and `UnicodeStrSlice` traits to prelude
- libunicode is now the collection point for the `std::char` module, combining the libunicode functionality with the `Char` functionality from libcore
- thus, moved doc comment for `char` from `core::char` to `unicode::char`
- libcollections remains the collection point for `std::str`
The Unicode-aware functions that previously lived in the `Char` and `StrSlice` traits are no longer available to programs that only use libcore. To regain use of these methods, include the libunicode crate and `use` the `UnicodeChar` and/or `UnicodeStrSlice` traits:
extern crate unicode;
use unicode::UnicodeChar;
use unicode::UnicodeStrSlice;
use unicode::Words; // if you want to use the words() method
NOTE: this does *not* impact programs that use libstd, since UnicodeChar and UnicodeStrSlice have been added to the prelude.
closes #15224
[breaking-change]
99 lines
4.5 KiB
Rust
99 lines
4.5 KiB
Rust
// Copyright 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 Rust prelude
|
|
//!
|
|
//! Because `std` is required by most serious Rust software, it is
|
|
//! imported at the topmost level of every crate by default, as if the
|
|
//! first line of each crate was
|
|
//!
|
|
//! ```ignore
|
|
//! extern crate std;
|
|
//! ```
|
|
//!
|
|
//! This means that the contents of std can be accessed from any context
|
|
//! with the `std::` path prefix, as in `use std::vec`, `use std::task::spawn`,
|
|
//! etc.
|
|
//!
|
|
//! Additionally, `std` contains a `prelude` module that reexports many of the
|
|
//! most common traits, types and functions. The contents of the prelude are
|
|
//! imported into every *module* by default. Implicitly, all modules behave as if
|
|
//! they contained the following prologue:
|
|
//!
|
|
//! ```ignore
|
|
//! use std::prelude::*;
|
|
//! ```
|
|
//!
|
|
//! The prelude is primarily concerned with exporting *traits* that are so
|
|
//! pervasive that it would be obnoxious to import for every use, particularly
|
|
//! those that define methods on primitive types. It does include a few
|
|
//! particularly useful standalone functions, like `from_str`, `range`, and
|
|
//! `drop`, `spawn`, and `channel`.
|
|
|
|
#![experimental]
|
|
|
|
// Reexported core operators
|
|
#[doc(no_inline)] pub use kinds::{Copy, Send, Sized, Share};
|
|
#[doc(no_inline)] pub use ops::{Add, Sub, Mul, Div, Rem, Neg, Not};
|
|
#[doc(no_inline)] pub use ops::{BitAnd, BitOr, BitXor};
|
|
#[doc(no_inline)] pub use ops::{Drop, Deref, DerefMut};
|
|
#[doc(no_inline)] pub use ops::{Shl, Shr};
|
|
#[doc(no_inline)] #[cfg(not(stage0))] pub use ops::{Index, IndexMut};
|
|
#[doc(no_inline)] pub use option::{Option, Some, None};
|
|
#[doc(no_inline)] pub use result::{Result, Ok, Err};
|
|
|
|
// Reexported functions
|
|
#[doc(no_inline)] pub use from_str::from_str;
|
|
#[doc(no_inline)] pub use iter::range;
|
|
#[doc(no_inline)] pub use mem::drop;
|
|
|
|
// Reexported types and traits
|
|
|
|
#[doc(no_inline)] pub use ascii::{Ascii, AsciiCast, OwnedAsciiCast, AsciiStr};
|
|
#[doc(no_inline)] pub use ascii::IntoBytes;
|
|
#[doc(no_inline)] pub use c_str::ToCStr;
|
|
#[doc(no_inline)] pub use char::Char;
|
|
#[doc(no_inline)] pub use clone::Clone;
|
|
#[doc(no_inline)] pub use cmp::{PartialEq, PartialOrd, Eq, Ord};
|
|
#[doc(no_inline)] pub use cmp::{Ordering, Less, Equal, Greater, Equiv};
|
|
#[doc(no_inline)] pub use collections::{Collection, Mutable, Map, MutableMap};
|
|
#[doc(no_inline)] pub use collections::{Set, MutableSet};
|
|
#[doc(no_inline)] pub use iter::{FromIterator, Extendable, ExactSize};
|
|
#[doc(no_inline)] pub use iter::{Iterator, DoubleEndedIterator};
|
|
#[doc(no_inline)] pub use iter::{RandomAccessIterator, CloneableIterator};
|
|
#[doc(no_inline)] pub use iter::{OrdIterator, MutableDoubleEndedIterator};
|
|
#[doc(no_inline)] pub use num::{Num, NumCast, CheckedAdd, CheckedSub, CheckedMul, CheckedDiv};
|
|
#[doc(no_inline)] pub use num::{Signed, Unsigned, Primitive, Int, Float};
|
|
#[doc(no_inline)] pub use num::{FloatMath, ToPrimitive, FromPrimitive};
|
|
#[doc(no_inline)] pub use owned::Box;
|
|
#[doc(no_inline)] pub use path::{GenericPath, Path, PosixPath, WindowsPath};
|
|
#[doc(no_inline)] pub use ptr::RawPtr;
|
|
#[doc(no_inline)] pub use io::{Buffer, Writer, Reader, Seek};
|
|
#[doc(no_inline)] pub use str::{Str, StrVector, StrSlice, OwnedStr};
|
|
#[doc(no_inline)] pub use str::{IntoMaybeOwned, StrAllocating};
|
|
#[doc(no_inline)] pub use to_str::{ToString, IntoStr};
|
|
#[doc(no_inline)] pub use tuple::{Tuple1, Tuple2, Tuple3, Tuple4};
|
|
#[doc(no_inline)] pub use tuple::{Tuple5, Tuple6, Tuple7, Tuple8};
|
|
#[doc(no_inline)] pub use tuple::{Tuple9, Tuple10, Tuple11, Tuple12};
|
|
#[doc(no_inline)] pub use slice::{CloneableVector, ImmutableCloneableVector};
|
|
#[doc(no_inline)] pub use slice::{MutableCloneableVector, MutableOrdVector};
|
|
#[doc(no_inline)] pub use slice::{ImmutableVector, MutableVector};
|
|
#[doc(no_inline)] pub use slice::{ImmutableEqVector, ImmutableOrdVector};
|
|
#[doc(no_inline)] pub use slice::{Vector, VectorVector};
|
|
#[doc(no_inline)] pub use slice::MutableVectorAllocating;
|
|
#[doc(no_inline)] pub use string::String;
|
|
#[doc(no_inline)] pub use unicode::{UnicodeChar, UnicodeStrSlice};
|
|
#[doc(no_inline)] pub use vec::Vec;
|
|
|
|
// Reexported runtime types
|
|
#[doc(no_inline)] pub use comm::{sync_channel, channel};
|
|
#[doc(no_inline)] pub use comm::{SyncSender, Sender, Receiver};
|
|
#[doc(no_inline)] pub use task::spawn;
|