6174b8d726
* Rename `utf16_items` to `decode_utf16`. "Items" is meaningless. * Move it to `rustc_unicode::char`, exposed in `std::char`. * Generalize it to any `u16` iterable, not just `&[u16]`. * Make it yield `Result` instead of a custom `Utf16Item` enum that was isomorphic to `Result`. This enable using the `FromIterator for Result` impl. * Add a `REPLACEMENT_CHARACTER` constant. * Document how `result.unwrap_or(REPLACEMENT_CHARACTER)` replaces `Utf16Item::to_char_lossy`.
60 lines
2.1 KiB
Rust
60 lines
2.1 KiB
Rust
// Copyright 2012-2014 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 Unicode Library
|
|
//!
|
|
//! Unicode-intensive functions for `char` and `str` types.
|
|
//!
|
|
//! This crate provides a collection of Unicode-related functionality,
|
|
//! including decompositions, conversions, etc., and provides traits
|
|
//! implementing these functions for the `char` and `str` types.
|
|
//!
|
|
//! The functionality included here is only that which is necessary to
|
|
//! provide for basic string-related manipulations. This crate does not
|
|
//! (yet) aim to provide a full set of Unicode tables.
|
|
|
|
// Do not remove on snapshot creation. Needed for bootstrap. (Issue #22364)
|
|
#![cfg_attr(stage0, feature(custom_attribute))]
|
|
#![crate_name = "rustc_unicode"]
|
|
#![unstable(feature = "unicode", issue = "27783")]
|
|
#![staged_api]
|
|
#![crate_type = "rlib"]
|
|
#![doc(html_logo_url = "https://www.rust-lang.org/logos/rust-logo-128x128-blk-v2.png",
|
|
html_favicon_url = "https://doc.rust-lang.org/favicon.ico",
|
|
html_root_url = "https://doc.rust-lang.org/nightly/",
|
|
html_playground_url = "https://play.rust-lang.org/",
|
|
issue_tracker_base_url = "https://github.com/rust-lang/rust/issues/",
|
|
test(no_crate_inject))]
|
|
#![no_std]
|
|
|
|
#![feature(char_from_unchecked)]
|
|
#![feature(core_char_ext)]
|
|
#![feature(core_slice_ext)]
|
|
#![feature(core_str_ext)]
|
|
#![feature(lang_items)]
|
|
#![feature(no_std)]
|
|
#![feature(staged_api)]
|
|
|
|
mod tables;
|
|
mod u_str;
|
|
pub mod char;
|
|
|
|
#[allow(deprecated)]
|
|
pub mod str {
|
|
pub use u_str::{UnicodeStr, SplitWhitespace};
|
|
pub use u_str::{utf8_char_width, is_utf16, Utf16Items, Utf16Item};
|
|
pub use u_str::{utf16_items, Utf16Encoder};
|
|
}
|
|
|
|
// For use in libcollections, not re-exported in libstd.
|
|
pub mod derived_property {
|
|
pub use tables::derived_property::{Cased, Case_Ignorable};
|
|
}
|