Struct std::alloc::System

pub struct System;

操作系统提供的默认内存分配器。

它基于 Unix 平台上的 malloc 和 Windows 上的 HeapAlloc，以及相关的函数。

此类型默认情况下实现 GlobalAlloc trait 和 Rust 程序，就像它们具有以下定义一样:

use std::alloc::System;

#[global_allocator]
static A: System = System;

fn main() {
    let a = Box::new(4); // 从系统分配器分配。
    println!("{}", a);
}

如果愿意，还可以围绕 System 定义自己的包装器，例如跟踪分配的所有字节数:

use std::alloc::{System, GlobalAlloc, Layout};
use std::sync::atomic::{AtomicUsize, Ordering::SeqCst};

struct Counter;

static ALLOCATED: AtomicUsize = AtomicUsize::new(0);

unsafe impl GlobalAlloc for Counter {
    unsafe fn alloc(&self, layout: Layout) -> *mut u8 {
        let ret = System.alloc(layout);
        if !ret.is_null() {
            ALLOCATED.fetch_add(layout.size(), SeqCst);
        }
        return ret
    }

    unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout) {
        System.dealloc(ptr, layout);
        ALLOCATED.fetch_sub(layout.size(), SeqCst);
    }
}

#[global_allocator]
static A: Counter = Counter;

fn main() {
    println!("allocated bytes before main: {}", ALLOCATED.load(SeqCst));
}

它也可以直接用于独立于 Rust 程序选择的分配器来分配内存。 例如，如果 Rust 程序选择使用 jemalloc 作为分配器，则 System 仍将使用 malloc 和 HeapAlloc 分配内存。

Trait Implementations

impl Allocator for System

fn allocate(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

尝试分配一块内存。

fn allocate_zeroed(&self, layout: Layout) -> Result<NonNull<[u8]>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

行为类似于 allocate，但也确保返回的内存被零初始化。

unsafe fn deallocate(&self, ptr: NonNull<u8>, layout: Layout)

🔬 This is a nightly-only experimental API. (allocator_api #32838)

释放 ptr 引用的内存。

unsafe fn grow(
    &self,
    ptr: NonNull<u8>,
    old_layout: Layout,
    new_layout: Layout
) -> Result<NonNull<[u8]>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

尝试扩展内存块。

unsafe fn grow_zeroed(
    &self,
    ptr: NonNull<u8>,
    old_layout: Layout,
    new_layout: Layout
) -> Result<NonNull<[u8]>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

行为类似于 grow，但也确保在返回新内容之前将其设置为零。

unsafe fn shrink(
    &self,
    ptr: NonNull<u8>,
    old_layout: Layout,
    new_layout: Layout
) -> Result<NonNull<[u8]>, AllocError>

🔬 This is a nightly-only experimental API. (allocator_api #32838)

尝试缩小内存块。

fn by_ref(&self) -> &Self

🔬 This is a nightly-only experimental API. (allocator_api #32838)

为此 Allocator 实例创建 “by reference” 适配器。

impl Clone for System

fn clone(&self) -> System

返回值的副本。

fn clone_from(&mut self, source: &Self)

从 source 执行复制分配。

impl Debug for System

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。

impl Default for System

fn default() -> System

返回类型的 “default value”。

impl GlobalAlloc for System

unsafe fn alloc(&self, layout: Layout) -> *mut u8

按照给定的 layout 分配内存。

unsafe fn alloc_zeroed(&self, layout: Layout) -> *mut u8

行为类似于 alloc，但也确保在返回之前将内容设置为零。

unsafe fn dealloc(&self, ptr: *mut u8, layout: Layout)

使用给定的 layout 在给定的 ptr 指针处释放内存块。

unsafe fn realloc(
    &self,
    ptr: *mut u8,
    layout: Layout,
    new_size: usize
) -> *mut u8

将内存块缩小或增加到给定的 new_size。 该块由给定的 ptr 指针和 layout 描述。

impl Copy for System