1. NOM

malloc_usable_size - Obtenir la taille d'un bloc de mémoire alloué dans le tas

2. SYNOPSIS

#include <malloc.h> size_t malloc_usable_size (void *ptr);

3. DESCRIPTION

La fonction malloc_usable_size() renvoie le nombre d'octets utilisables dans le bloc indiqué par ptr, un pointeur vers un bloc de mémoire alloué par malloc(3) ou autre fonction associée.

4. VALEUR RENVOYÉE

malloc_usable_size() renvoie le nombre d'octets utilisables dans le bloc de mémoire allouée vers lequel pointe ptr. Si ptr est NULL, 0 est renvoyé.

5. CONFORMITÉ

Cette fonction est une extension GNU.

6. NOTES

La valeur renvoyée par malloc_usable_size() peut être supérieure à la taille demandée lors de l'allocation, à cause des contraintes d'alignement et de taille minimum. Même si les octets en trop peuvent être écrits par l'application sans effets indésirables, ce n'est pas une bonne pratique de programmation : l'excédent d'octets dépend du code mise en œuvre. Cette fonction est principalement utilisée à des fins de débogage et introspection.

7. VOIR AUSSI

malloc(3)

8. COLOPHON

Cette page fait partie de la publication 3.52 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

9. TRADUCTION

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Veuillez signaler toute erreur de traduction en écrivant à < >.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».