BADMACRO.STDIO_H : Use of <stdio.h> Input/Output Macro

Summary

A use of one of the following, declared in <stdio.h>, when defined as a macro: clearerr(), ctermid(), cuserid(), fclose(), fdopen(), feof(), ferror(), fflush(), fgetc(), fgetpos(), fgets(), fileno(), flockfile(), fopen(), fprintf(), fputc(), fputs(), fread(), freopen(), fscanf(), fseek(), fseeko(), fsetpos(), ftell(), ftello(), ftrylockfile(), funlockfile(), fwrite(), getc(), getchar(), getc_unlocked(), getchar_unlocked(), getopt(), gets(), getw(), pclose(), perror(), popen(), printf(), putc(), putchar(), putc_unlocked(), putchar_unlocked(), puts(), putw(), remove(), rename(), rewind(), scanf(), setbuf(), setvbuf(), snprintf(), sprintf(), sscanf(), tempnam(), tmpfile(), tmpnam(), ungetc(), vfprintf(), vprintf(), vsnprintf(), vsprintf().

These macros are associated with unspecified, undefined, and implementation-defined behaviors.

If your libc implementation defines these as functions, uses will instead be reported as Use of <stdio.h> Input/Output warnings.

Properties

WARNING_FILTER += allow class="Use of <stdio.h> Input/Output Macro"

Example

#include <stdio.h>

int badmacro_stdio_h(FILE *f){
    return fputc('a', f); /* Warning issued here:
                           * - 'Use of <stdio.h> Input/Output Macro' if fputc() implemented as a macro
                           * - Use of <stdio.h> Input/Output if fputc() implemented as a function
                           */
}

Relevant Configuration File Parameters

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

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

• BAD_MACRO_BASE_RANK
• BAD_MACRO_CATEGORIES
• BAD_MACRO_CLASS
• BAD_MACRO_FILENAME
• BAD_MACRO_INFO
• BAD_MACRO_LINK
• BAD_MACRO_NAME
• BAD_MACRO_SIGNIFICANCE
• REPORT_SIMILAR_WARNINGS
• WARNING_FILTER