BADFUNC.WCHAR_H : Use of <wchar.h> Input/Output

Summary

A use of one of the following, declared in <wchar.h>, when defined as a function: btowc(), fwprintf(), fwscanf(), iswalnum(), iswalpha(), iswcntrl(), iswdigit(), iswgraph(), iswlower(), iswprint(), iswpunct(), iswspace(), iswupper(), iswxdigit(), iswctype(), fgetwc(), fgetws(), fputwc(), fputws(), fwide(), getwc(), getwchar(), mbsinit(), mbrlen(), mbrtowc(), mbsrtowcs(), putwc(), putwchar(), swprintf(), swscanf(), towlower(), towupper(), ungetwc(), vfwprintf(), vwprintf(), vswprintf(), wcrtomb(), wcscat(), wcschr(), wcscmp(), wcscoll(), wcscpy(), wcscspn(), wcsftime(), wcslen(), wcsncat(), wcsncmp(), wcsncpy(), wcspbrk(), wcsrchr(), wcsrtombs(), wcsspn(), wcsstr(), wcstod(), wcstok(), wcstol(), wcstoul(), wcswcs(), wcswidth(), wcsxfrm(), wctob(), wctype(), wcwidth(), wmemchr(), wmemcmp(), wmemcpy(), wmemmove(), wmemset(), wprintf(), wscanf().

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

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

Properties

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

Example

#include <wchar.h>

get_answer_w(void){
    wint_t ans;
    ans = fgetwc(stdin); /* Warning issued here:
                          * - 'Use of <wchar.h> Input/Output' if fgetwc() implemented as a function
                          * - Use of <wchar.h> Input/Output Macro if fgetwc() implemented as a macro
                          */
    if ((ans == (wint_t)('Y')) || ans == (wint_t)('y')){
        return 1;
    }
    return 0;
}

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