> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/stdlib/free_sized.3.md).

# free\_sized(3)

`free_sized` — C23 带尺寸释放函数

## 名称

`free_sized`, `free_aligned_sized`

## 概要

`Lb libc`

`#include <stdlib.h>`

```c
void
free_sized(void *ptr, size_t size);

void
free_aligned_sized(void *ptr, size_t alignment, size_t size);
```

## 描述

`free_sized` 函数释放由 `ptr` 所指向的、此前由 malloc(3)、realloc(3) 或 calloc(3) 分配的内存。`size` 参数应等于传递给分配函数的尺寸。aligned\_alloc(3) 的结果不能传递给 `free_sized`。

`free_aligned_sized` 函数释放由 `ptr` 所指向的、此前由 aligned\_alloc(3) 分配的内存。`alignment` 和 `size` 参数应等于提供给分配函数的值。malloc(3)、calloc(3) 或 realloc(3) 的结果不能传递给 `free_aligned_sized`。

如果 `ptr` 既不是空指针，也不是由上述对应释放函数所描述的分配函数返回的指针，则行为未定义；同样，提供的 `size` 或 `alignment` 与原始分配不匹配时，行为也是未定义的。

## 实现说明

C 标准允许实现忽略 `size` 和 `alignment` 提示。当前实现直接转发给 free(3)，不验证这些参数，因此对于正确使用的情况，行为保持正确。

一旦系统分配器支持带尺寸释放，这些函数将连接到系统分配器的带尺寸释放功能，与内存分配 API 的其余部分一致，从而使 `size` 和 `alignment` 提示用于提升性能和安全性。该行为遵循 C 标准中为每个函数推荐的做法。

## 参见

free(3), malloc(3), calloc(3), realloc(3), aligned\_alloc(3), jemalloc(3)

## 标准

`free_sized` 和 `free_aligned_sized` 函数遵循 -isoC-2023。

## 作者

Faraz Vahedi <kfv@kfv.io>