diff mbox series

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

Message ID	20221110164152.26136-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: Miguel Ojeda <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 v1 14/28] rust: str: add `BStr` type Date: Thu, 10 Nov 2022 17:41:26 +0100 Message-Id: <20221110164152.26136-15-ojeda@kernel.org> In-Reply-To: <20221110164152.26136-1-ojeda@kernel.org> References: <20221110164152.26136-1-ojeda@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk
Series	Rust core additions \| [v1,00/28] Rust core additions [v1,01/28] rust: prelude: split re-exports into groups [v1,02/28] rust: print: add more `pr_!` levels [v1,03/28] rust: print: add `pr_cont!` macro [v1,04/28] rust: samples: add `rust_print` example [v1,05/28] rust: macros: add `concat_idents!` proc macro [v1,06/28] rust: macros: add `#[vtable]` proc macro [v1,07/28] rust: macros: take string literals in `module!` [v1,08/28] rust: error: declare errors using macro [v1,09/28] rust: error: add codes from `errno-base.h` [v1,10/28] rust: error: add `From` implementations for `Error` [v1,11/28] rust: prelude: add `error::code::` constant items [v1,12/28] rust: alloc: add `RawVec::try_with_capacity_in()` constructor [v1,13/28] rust: alloc: add `Vec::try_with_capacity{,_in}()` constructors [v1,14/28] rust: str: add `BStr` type [v1,15/28] rust: str: add `b_str!` macro [v1,16/28] rust: str: add `CStr` type [v1,17/28] rust: str: implement several traits for `CStr` [v1,18/28] rust: str: add `CStr` unit tests [v1,19/28] rust: str: add `c_str!` macro [v1,20/28] rust: str: add `Formatter` type [v1,21/28] rust: str: add `CString` type [v1,22/28] rust: str: add `fmt!` macro [v1,23/28] rust: std_vendor: add `dbg!` macro based on `std`'s one [v1,24/28] rust: static_assert: add `static_assert!` macro [v1,25/28] rust: add `build_error` crate [v1,26/28] rust: build_assert: add `build_{error,assert}!` macros [v1,27/28] rust: types: add `Either` type [v1,28/28] rust: types: add `Opaque` type

Commit Message

Miguel Ojeda Nov. 10, 2022, 4:41 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