From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pl1-f175.google.com (mail-pl1-f175.google.com [209.85.214.175]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 814CBC8EB for ; Sun, 26 Apr 2026 03:47:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.175 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777175223; cv=none; b=s+a9oPAZayO5juFgAMddbkV9oPAt3EEhamejCqSVQEqc49M/qgeJy1ZoI0LoQNrSZXqbgjW8ro7SHiq40iec1bHNUPvZMFYxj4qUWuKzW0eol0PMcaQ0Wx7gA5ea02CchhUeJAhUNpD5o2YOip9cB91apxGTpq2MHcsGUl+EbW0= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1777175223; c=relaxed/simple; bh=AiUKYr2jJ0XvXVOYzQgFeNe8jCAZGHQ2c7MqLBW25o4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=MdurPwiF+jY04s16IfMb0qahmtQEPwwFkqA0wUEMgUn0jBXZJmd8tZiZhppw9VxsxxxDYiZebhcrrOK6O2tQURSdWJNmmSvCFe3uYj07mE/BVLkYJu87TG3MVJyWPhM6/OVfVPkGL9XINd9v7Lbfaoyk9F25dzDGZQNckktFILE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=GQ7Ldm3Z; arc=none smtp.client-ip=209.85.214.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="GQ7Ldm3Z" Received: by mail-pl1-f175.google.com with SMTP id d9443c01a7336-2b788a98557so40784385ad.2 for ; Sat, 25 Apr 2026 20:47:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1777175222; x=1777780022; darn=vger.kernel.org; h=cc:to:message-id:content-transfer-encoding:mime-version:subject :date:from:from:to:cc:subject:date:message-id:reply-to; bh=QDfUEqqpcjDUqlV3d8D+uwaZM6roODFD9XWd5LBkiBY=; b=GQ7Ldm3ZssY/4p/T/FQZo9bkIVdPbahRpxG3YWKzwLNLwqP25JzzXJKDzHTrMPVfOu AH/PDHkdJzEcId1nJI0lCg4f+mtenz7ztKhlyAjmf29ntzt5ROrn8K0XfVviPThMneO8 V8rJFOLmMGAQAmFD1kE6u49wlu5EsuZtIFyqwCxMMKJcGFUsdkDBYVqZVmxOCMJ/Hcqs bFkogL/G/w5RahKbGNcbhgaIlnOUdQhX2GXoaf2x5hf47Gd1mWKG8um3VUvt4zSNRsqM rMK5AmP9kZqZcPy8hr4E5/z4WlbKJEQBnwAEtFlA2bxE3XLO4nBBDT09m3B2ffFd7gZq C/5w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1777175222; x=1777780022; h=cc:to:message-id:content-transfer-encoding:mime-version:subject :date:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=QDfUEqqpcjDUqlV3d8D+uwaZM6roODFD9XWd5LBkiBY=; b=VJFeLKRFQr6YgX5+LB/fs4I0JxBUr7OGrqpg/z0lVKHt4OONcnLMK2Ht6hg3QB9ThT mKTIsuyG4iqlUINXrHqAAuP6hSTo/AyRDlvN+dSm8PzET5S6KwvefNfcVmN4Z4njCu2d YNGXssGOkgHAJJFeIxGsVk6wLwWE1aG84nbE4HMflHZBFCZHalj51FC35NPBmBux36rN CuDbb3llAG7FyW40uFammvyJ0MTPhWW4DcvcQ8OQXuK9h19ZYRc0F+Hy87I7gmcTQS8l hKtTq3QZ0rOiSek+/rSOcEI9IM61DBTfXQ6Ue929A1Tt0Sq8m6LgzlthLjvYsIYaKT/2 hLyw== X-Forwarded-Encrypted: i=1; AFNElJ/Yjc4qZgvCQNsRaWEGkmMhQWc9GIgfnaqz9/9JMSpxo8SciYKigEUHDy3c5bMN04emgpOIkhwdMovGdIs=@vger.kernel.org X-Gm-Message-State: AOJu0YxKvyBU0awLcbdGjFPe4kTuRV0ejo4oylh/+/oH+Du037QWJuXk B+DsuoYacatajMDK0qZ5xkiMtH0AWZI1cFu/mCWIJY3Z4ArTl1vwzqhS X-Gm-Gg: AeBDiesg5k4dpNNYdvkYARxtSUVZDfgPBbw4ACMuqI1aG0VeYmcfdH446CUC/kwO22f m9Q5bkNN+hsyO5a1Dkkl1lQyc4TPuwOcN8vXPu54UwufgwYNRrbErLvXDHHtBKGW47e9fEqTw6g 4dpRNp9xoBzH6h1bnnV0PYZ7kI1jwMTeHL0HXXIYyK0Wo3OVsSpNdxNZUGOkmpUmi+k7Imp4iEi 5zBHBLbYTk50LA+YIDcf5dUWXw90NqincUhAgj46Z3fttMB8UYhxjzl6qet1lmHDXlK8bZrFGD9 f6pD15r7ZTG1g8IkA/yWjl8pQL/HUgh73gCdMKoC3cmhMlyN5l3F3iRMORqxVs1Rua5LK89wvb5 9fl5UNWaokzMU8qeA67r/2hyNQa1U3R9gDohSmndQ7jzeR7h1IsTH5d6IOYIQXnwa9C9WGBhlCe 97ac4K/K2JO9xtLB2vRP7zkV2NFG7I5jrXa1Hfrxm0d3clzuc= X-Received: by 2002:a17:902:8649:b0:2b4:65ab:57cd with SMTP id d9443c01a7336-2b5f9fbdd39mr289806875ad.36.1777175221801; Sat, 25 Apr 2026 20:47:01 -0700 (PDT) Received: from yuwhisper-pc. ([49.213.140.88]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2b5faa494e1sm265589525ad.35.2026.04.25.20.46.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 25 Apr 2026 20:47:01 -0700 (PDT) From: Hsiu Che Yu Date: Sun, 26 Apr 2026 11:46:27 +0800 Subject: [PATCH] rust: alloc: add doc test for `Vec::from_elem` Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260426-doctest-alloc-kvec-from_elem-v1-1-e364341a759b@gmail.com> X-B4-Tracking: v=1; b=H4sIAJKK7WkC/yXMQQ6CMBAF0KuQWTsJVgPVqxhj6PDR0UJNW4kJ4 e5WXb7NWyghKhIdq4UiZk0apoLtpiK5ddMVrH0xmdo09d403AfJSJk774PwY4bwEMN4gcfIzlm 4XWvNobVUimfEoO9ffzr/nV7uDsnfk9b1A3nsWgOAAAAA X-Change-ID: 20260426-doctest-alloc-kvec-from_elem-bb8eb3782978 To: Danilo Krummrich , Lorenzo Stoakes , Vlastimil Babka , "Liam R. Howlett" , Uladzislau Rezki , Miguel Ojeda , Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , Trevor Gross Cc: rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, Hsiu Che Yu X-Mailer: b4 0.15.2 Add a doc test for `Vec::from_elem` demonstrating basic usage and the zero-length case. Signed-off-by: Hsiu Che Yu --- rust/kernel/alloc/kvec.rs | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/rust/kernel/alloc/kvec.rs b/rust/kernel/alloc/kvec.rs index ac8d6f763ae8..f5d213b4f715 100644 --- a/rust/kernel/alloc/kvec.rs +++ b/rust/kernel/alloc/kvec.rs @@ -792,6 +792,18 @@ pub fn extend_from_slice(&mut self, other: &[T], flags: Flags) -> Result<(), All } /// Create a new `Vec` and extend it by `n` clones of `value`. + /// + /// # Examples + /// + /// ``` + /// let v = KVec::from_elem(1, 5, GFP_KERNEL)?; + /// assert_eq!(&v, &[1, 1, 1, 1, 1]); + /// + /// let v = KVec::from_elem(1, 0, GFP_KERNEL)?; + /// assert!(v.is_empty()); + /// + /// # Ok::<(), Error>(()) + /// ``` pub fn from_elem(value: T, n: usize, flags: Flags) -> Result { let mut v = Self::with_capacity(n, flags)?; --- base-commit: b4e07588e743c989499ca24d49e752c074924a9a change-id: 20260426-doctest-alloc-kvec-from_elem-bb8eb3782978 Best regards, -- Hsiu Che Yu