Function CheckLanguage

tools/cpplint.py:6041–6257

Checks rules from the 'C++ language rules' section of cppguide.html. Some of these rules are hard to test (function overloading, using uint32_t inappropriately), but we do the best we can. Args: filename: The name of the current file. clean_lines: A CleansedLines instance c

(
    filename, clean_lines, linenum, file_extension, include_state, nesting_state, error
)

def CheckLanguage(
    filename, clean_lines, linenum, file_extension, include_state, nesting_state, error
):
    """Checks rules from the 'C++ language rules' section of cppguide.html.

    Some of these rules are hard to test (function overloading, using
    uint32_t inappropriately), but we do the best we can.

    Args:
      filename: The name of the current file.
      clean_lines: A CleansedLines instance containing the file.
      linenum: The number of the line to check.
      file_extension: The extension (without the dot) of the filename.
      include_state: An _IncludeState instance in which the headers are inserted.
      nesting_state: A NestingState instance which maintains information about
                     the current stack of nested blocks being parsed.
      error: The function to call with any errors found.
    """
    # If the line is empty or consists of entirely a comment, no need to
    # check it.
    line = clean_lines.elided[linenum]
    if not line:
        return

    match = _RE_PATTERN_INCLUDE.search(line)
    if match:
        CheckIncludeLine(filename, clean_lines, linenum, include_state, error)
        return

    # Reset include state across preprocessor directives.  This is meant
    # to silence warnings for conditional includes.
    match = re.match(r"^\s*#\s*(if|ifdef|ifndef|elif|else|endif)\b", line)
    if match:
        include_state.ResetSection(match.group(1))

    # Perform other checks now that we are sure that this is not an include line
    CheckCasts(filename, clean_lines, linenum, error)
    CheckGlobalStatic(filename, clean_lines, linenum, error)
    CheckPrintf(filename, clean_lines, linenum, error)

    if IsHeaderExtension(file_extension):
        # TODO(google): check that 1-arg constructors are explicit.
        #                How to tell it's a constructor?
        #                (handled in CheckForNonStandardConstructs for now)
        # TODO(google): check that classes declare or disable copy/assign
        #                (level 1 error)
        pass

    # Check if people are using the verboten C basic types.  The only exception
    # we regularly allow is "unsigned short port" for port.
    if re.search(r"\bshort port\b", line):
        if not re.search(r"\bunsigned short port\b", line):
            error(
                filename, linenum, "runtime/int", 4, 'Use "unsigned short" for ports, not "short"'
            )
    else:
        match = re.search(r"\b(short|long(?! +double)|long long)\b", line)
        if match: