BADFUNC.STDLIB_H_MEM : Use of <stdlib.h> Allocator/Deallocator

Summary

A use of one of the following, declared in <stdlib.h> (C) / <cstdlib> (C++), when defined as a function: malloc(), calloc(), realloc(), free().

These functions are disallowed by some coding standards.

If your libc implementation defines these as macros, uses will instead be reported as Use of <stdlib.h> Allocator/Deallocator Macro warnings.

Properties

WARNING_FILTER += allow class="Use of <stdlib.h> Allocator/Deallocator"

Example

#include <cstdlib>
#include <iostream>

class Intpair {
  public:
    int a;
    int b;
    Intpair(int aval, int bval): a(aval),b(bval){}
    int sum(){return a+b;}
};

int baduse(){
    int s;
    Intpair *i = (Intpair*)malloc(sizeof(Intpair));   // Warning issued here:
                      // - 'Use of <stdlib.h> Allocator/Deallocator' if malloc() implemented as a function
                      // - Use of <stdlib.h> Allocator/Deallocator Macro if malloc() implemented as a macro 
    if (i==NULL) {return 0;}
    i->a = 5;
    i->b = 7;
    s = i->sum();
    free(i);          // Warning issued here:
                      // - 'Use of <stdlib.h> Allocator/Deallocator' if free() implemented as a function
                      // - Use of <stdlib.h> Allocator/Deallocator Macro if free() implemented as a macro 
    return s;
}

int gooduse(){                              // OK: uses constructor and destructor instead of malloc/free. 
    Intpair *i = new Intpair(5,7);                   
    int s =  i->sum();
    delete i;
    return s;
}

Relevant Configuration File Parameters

This class is implemented using a BAD_FUNCTION_* rule set in the general template configuration file.

• To include an additional function or set of functions in the checks for this class, create a new set of BAD_FUNCTION_* rules in which the BAD_FUNCTION_REGEX setting matches the function or set of functions you want to check and the remaining rules match those in the other sets for this class.
• To remove a function or set of functions from the checks for this class, edit the configuration file to comment out the corresponding set of BAD_FUNCTION_* rules.

The following configuration file parameters affect checks for this warning class.

• BAD_FUNCTION_BASE_RANK
• BAD_FUNCTION_CATEGORIES
• BAD_FUNCTION_INFO
• BAD_FUNCTION_LINK
• BAD_FUNCTION_MESSAGE
• BAD_FUNCTION_RANK
• BAD_FUNCTION_REGEX
• BAD_FUNCTION_SIGNIFICANCE
• REPORT_SIMILAR_WARNINGS
• WARNING_FILTER