diff mbox series

[v2,14/28] rust: str: add `BStr` type

Message ID	20221202161502.385525-15-ojeda@kernel.org
State	New
Headers	Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; From: ojeda@kernel.org To: Miguel Ojeda <ojeda@kernel.org>, Wedson Almeida Filho <wedsonaf@gmail.com>, Alex Gaynor <alex.gaynor@gmail.com>, Boqun Feng <boqun.feng@gmail.com>, Gary Guo <gary@garyguo.net>, =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= <bjorn3_gh@protonmail.com> Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, patches@lists.linux.dev Subject: [PATCH v2 14/28] rust: str: add `BStr` type Date: Fri, 2 Dec 2022 17:14:45 +0100 Message-Id: <20221202161502.385525-15-ojeda@kernel.org> In-Reply-To: <20221202161502.385525-1-ojeda@kernel.org> References: <20221202161502.385525-1-ojeda@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk
Series	[v2,01/28] rust: prelude: split re-exports into groups \| [v2,01/28] rust: prelude: split re-exports into groups [v2,02/28] rust: print: add more `pr_!` levels [v2,03/28] rust: print: add `pr_cont!` macro [v2,04/28] rust: samples: add `rust_print` example [v2,05/28] rust: macros: add `concat_idents!` proc macro [v2,06/28] rust: macros: add `#[vtable]` proc macro [v2,07/28] rust: macros: take string literals in `module!` [v2,08/28] rust: error: declare errors using macro [v2,09/28] rust: error: add codes from `errno-base.h` [v2,10/28] rust: error: add `From` implementations for `Error` [v2,11/28] rust: prelude: add `error::code::` constant items [v2,12/28] rust: alloc: add `RawVec::try_with_capacity_in()` constructor [v2,13/28] rust: alloc: add `Vec::try_with_capacity{,_in}()` constructors [v2,14/28] rust: str: add `BStr` type [v2,15/28] rust: str: add `b_str!` macro [v2,16/28] rust: str: add `CStr` type [v2,17/28] rust: str: implement several traits for `CStr` [v2,18/28] rust: str: add `CStr` unit tests [v2,19/28] rust: str: add `c_str!` macro [v2,20/28] rust: str: add `Formatter` type [v2,21/28] rust: str: add `CString` type [v2,22/28] rust: str: add `fmt!` macro [v2,23/28] rust: std_vendor: add `dbg!` macro based on `std`'s one [v2,24/28] rust: static_assert: add `static_assert!` macro [v2,25/28] rust: add `build_error` crate [v2,26/28] rust: build_assert: add `build_{error,assert}!` macros [v2,27/28] rust: types: add `Either` type [v2,28/28] rust: types: add `Opaque` type

Commit Message

Miguel Ojeda Dec. 2, 2022, 4:14 p.m. UTC

  From: Gary Guo <gary@garyguo.net>

Add the `BStr` type, which is a byte string without UTF-8
validity guarantee.

It is simply an alias to `[u8]`, but has a more evident
semantical meaning.

Signed-off-by: Gary Guo <gary@garyguo.net>
[Reworded, adapted for upstream and applied latest changes]
Signed-off-by: Miguel Ojeda <ojeda@kernel.org>
---
 rust/kernel/str.rs | 5 +++++
 1 file changed, 5 insertions(+)

diff mbox series

Patch

diff --git a/rust/kernel/str.rs b/rust/kernel/str.rs
index e45ff220ae50..3aa1a0cb9bf8 100644
--- a/rust/kernel/str.rs
+++ b/rust/kernel/str.rs
@@ -4,6 +4,11 @@ 
 
 use core::fmt;
 
+/// Byte string without UTF-8 validity guarantee.
+///
+/// `BStr` is simply an alias to `[u8]`, but has a more evident semantical meaning.
+pub type BStr = [u8];
+
 /// Allows formatting of [`fmt::Arguments`] into a raw buffer.
 ///
 /// It does not fail if callers write past the end of the buffer so that they can calculate the