[#CRYPTO_clear_realloc]
= CRYPTO_clear_realloc
:mrdocs:

Reallocate a buffer, securely clearing any released trailing bytes.

== Synopsis

Declared in `<openssl/crypto.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
void*
CRYPTO_clear_realloc(
    void* addr,
    size_t old_num,
    size_t num,
    char const* file,
    int line);
----

== Return Value

Reallocated pointer, or NULL on failure (original block left allocated on failure).

== Parameters

[cols="1,4"]
|===
| Name| Description
| *addr*
| Existing allocation, or NULL to allocate anew.
| *old_num*
| Previous size in bytes (used when clearing shrunk regions).
| *num*
| New size in bytes.
| *file*
| Source file name recorded with the allocation (usually *FILE*).
| *line*
| Source line recorded with the allocation (usually *LINE*).
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#