MALLOC_USABLE_SIZE(3)

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

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

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.

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é.

ATTRIBUTS

  Multithreading (voir pthreads(7))
La fonction malloc_usable_size() est sûre dans un contexte multithread.

CONFORMITÉ
Cette fonction est une extension GNU.

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.

VOIR AUSSI
malloc(3)

COLOPHON
Cette page fait partie de la publication 3.70 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/.

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 à <perkamon-fr@traduc.org>.

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