|
@@ -37,14 +37,17 @@
|
|
|
//! assert_eq!(utf8_percent_encode("foo <bar>", FRAGMENT).to_string(), "foo%20%3Cbar%3E");
|
|
//! assert_eq!(utf8_percent_encode("foo <bar>", FRAGMENT).to_string(), "foo%20%3Cbar%3E");
|
|
|
//! ```
|
|
//! ```
|
|
|
|
|
|
|
|
-#![cfg_attr(not(feature = "std"), no_std)]
|
|
|
|
|
-
|
|
|
|
|
-#[cfg(not(feature = "std"))]
|
|
|
|
|
|
|
+#![no_std]
|
|
|
|
|
+#[cfg(feature = "alloc")]
|
|
|
|
|
+extern crate alloc;
|
|
|
|
|
+
|
|
|
|
|
+#[cfg(feature = "alloc")]
|
|
|
|
|
+use alloc::{
|
|
|
|
|
+ borrow::{Cow, ToOwned},
|
|
|
|
|
+ string::String,
|
|
|
|
|
+ vec::Vec,
|
|
|
|
|
+};
|
|
|
use core::{fmt, mem, slice, str};
|
|
use core::{fmt, mem, slice, str};
|
|
|
-#[cfg(feature = "std")]
|
|
|
|
|
-use std::borrow::Cow;
|
|
|
|
|
-#[cfg(feature = "std")]
|
|
|
|
|
-use std::{fmt, mem, slice, str};
|
|
|
|
|
|
|
|
|
|
/// Represents a set of characters or bytes in the ASCII range.
|
|
/// Represents a set of characters or bytes in the ASCII range.
|
|
|
///
|
|
///
|
|
@@ -293,7 +296,7 @@ impl<'a> fmt::Display for PercentEncode<'a> {
|
|
|
}
|
|
}
|
|
|
}
|
|
}
|
|
|
|
|
|
|
|
-#[cfg(feature = "std")]
|
|
|
|
|
|
|
+#[cfg(feature = "alloc")]
|
|
|
impl<'a> From<PercentEncode<'a>> for Cow<'a, str> {
|
|
impl<'a> From<PercentEncode<'a>> for Cow<'a, str> {
|
|
|
fn from(mut iter: PercentEncode<'a>) -> Self {
|
|
fn from(mut iter: PercentEncode<'a>) -> Self {
|
|
|
match iter.next() {
|
|
match iter.next() {
|
|
@@ -332,18 +335,13 @@ pub fn percent_decode_str(input: &str) -> PercentDecode<'_> {
|
|
|
/// * Implements `Iterator<Item = u8>` and therefore has a `.collect::<Vec<u8>>()` method,
|
|
/// * Implements `Iterator<Item = u8>` and therefore has a `.collect::<Vec<u8>>()` method,
|
|
|
/// * Has `decode_utf8()` and `decode_utf8_lossy()` methods.
|
|
/// * Has `decode_utf8()` and `decode_utf8_lossy()` methods.
|
|
|
///
|
|
///
|
|
|
-#[cfg_attr(
|
|
|
|
|
- feature = "std",
|
|
|
|
|
- doc = r##"
|
|
|
|
|
-# Examples
|
|
|
|
|
-
|
|
|
|
|
-```
|
|
|
|
|
-use percent_encoding::percent_decode;
|
|
|
|
|
-
|
|
|
|
|
-assert_eq!(percent_decode(b"foo%20bar%3f").decode_utf8().unwrap(), "foo bar?");
|
|
|
|
|
-```
|
|
|
|
|
-"##
|
|
|
|
|
-)]
|
|
|
|
|
|
|
+/// # Examples
|
|
|
|
|
+///
|
|
|
|
|
+/// ```
|
|
|
|
|
+/// use percent_encoding::percent_decode;
|
|
|
|
|
+///
|
|
|
|
|
+/// assert_eq!(percent_decode(b"foo%20bar%3f").decode_utf8().unwrap(), "foo bar?");
|
|
|
|
|
+/// ```
|
|
|
#[inline]
|
|
#[inline]
|
|
|
pub fn percent_decode(input: &[u8]) -> PercentDecode<'_> {
|
|
pub fn percent_decode(input: &[u8]) -> PercentDecode<'_> {
|
|
|
PercentDecode {
|
|
PercentDecode {
|
|
@@ -384,7 +382,7 @@ impl<'a> Iterator for PercentDecode<'a> {
|
|
|
}
|
|
}
|
|
|
}
|
|
}
|
|
|
|
|
|
|
|
-#[cfg(feature = "std")]
|
|
|
|
|
|
|
+#[cfg(feature = "alloc")]
|
|
|
impl<'a> From<PercentDecode<'a>> for Cow<'a, [u8]> {
|
|
impl<'a> From<PercentDecode<'a>> for Cow<'a, [u8]> {
|
|
|
fn from(iter: PercentDecode<'a>) -> Self {
|
|
fn from(iter: PercentDecode<'a>) -> Self {
|
|
|
match iter.if_any() {
|
|
match iter.if_any() {
|
|
@@ -396,7 +394,7 @@ impl<'a> From<PercentDecode<'a>> for Cow<'a, [u8]> {
|
|
|
|
|
|
|
|
impl<'a> PercentDecode<'a> {
|
|
impl<'a> PercentDecode<'a> {
|
|
|
/// If the percent-decoding is different from the input, return it as a new bytes vector.
|
|
/// If the percent-decoding is different from the input, return it as a new bytes vector.
|
|
|
- #[cfg(feature = "std")]
|
|
|
|
|
|
|
+ #[cfg(feature = "alloc")]
|
|
|
fn if_any(&self) -> Option<Vec<u8>> {
|
|
fn if_any(&self) -> Option<Vec<u8>> {
|
|
|
let mut bytes_iter = self.bytes.clone();
|
|
let mut bytes_iter = self.bytes.clone();
|
|
|
while bytes_iter.any(|&b| b == b'%') {
|
|
while bytes_iter.any(|&b| b == b'%') {
|
|
@@ -416,7 +414,7 @@ impl<'a> PercentDecode<'a> {
|
|
|
/// Decode the result of percent-decoding as UTF-8.
|
|
/// Decode the result of percent-decoding as UTF-8.
|
|
|
///
|
|
///
|
|
|
/// This is return `Err` when the percent-decoded bytes are not well-formed in UTF-8.
|
|
/// This is return `Err` when the percent-decoded bytes are not well-formed in UTF-8.
|
|
|
- #[cfg(feature = "std")]
|
|
|
|
|
|
|
+ #[cfg(feature = "alloc")]
|
|
|
pub fn decode_utf8(self) -> Result<Cow<'a, str>, str::Utf8Error> {
|
|
pub fn decode_utf8(self) -> Result<Cow<'a, str>, str::Utf8Error> {
|
|
|
match self.clone().into() {
|
|
match self.clone().into() {
|
|
|
Cow::Borrowed(bytes) => match str::from_utf8(bytes) {
|
|
Cow::Borrowed(bytes) => match str::from_utf8(bytes) {
|
|
@@ -434,13 +432,13 @@ impl<'a> PercentDecode<'a> {
|
|
|
///
|
|
///
|
|
|
/// Invalid UTF-8 percent-encoded byte sequences will be replaced � U+FFFD,
|
|
/// Invalid UTF-8 percent-encoded byte sequences will be replaced � U+FFFD,
|
|
|
/// the replacement character.
|
|
/// the replacement character.
|
|
|
- #[cfg(feature = "std")]
|
|
|
|
|
|
|
+ #[cfg(feature = "alloc")]
|
|
|
pub fn decode_utf8_lossy(self) -> Cow<'a, str> {
|
|
pub fn decode_utf8_lossy(self) -> Cow<'a, str> {
|
|
|
decode_utf8_lossy(self.clone().into())
|
|
decode_utf8_lossy(self.clone().into())
|
|
|
}
|
|
}
|
|
|
}
|
|
}
|
|
|
|
|
|
|
|
-#[cfg(feature = "std")]
|
|
|
|
|
|
|
+#[cfg(feature = "alloc")]
|
|
|
fn decode_utf8_lossy(input: Cow<'_, [u8]>) -> Cow<'_, str> {
|
|
fn decode_utf8_lossy(input: Cow<'_, [u8]>) -> Cow<'_, str> {
|
|
|
// Note: This function is duplicated in `form_urlencoded/src/query_encoding.rs`.
|
|
// Note: This function is duplicated in `form_urlencoded/src/query_encoding.rs`.
|
|
|
match input {
|
|
match input {
|