Function CheckBraces

tools/cpplint.py:4820–4997

Looks for misplaced braces (e.g. at the end of line). Args: filename: The name of the current file. clean_lines: A CleansedLines instance containing the file. linenum: The number of the line to check. error: The function to call with any errors found.

(filename, clean_lines, linenum, error)

def CheckBraces(filename, clean_lines, linenum, error):
    """Looks for misplaced braces (e.g. at the end of line).

    Args:
      filename: The name of the current file.
      clean_lines: A CleansedLines instance containing the file.
      linenum: The number of the line to check.
      error: The function to call with any errors found.
    """

    line = clean_lines.elided[linenum]  # get rid of comments and strings

    if re.match(r"\s*{\s*$", line):
        # We allow an open brace to start a line in the case where someone is using
        # braces in a block to explicitly create a new scope, which is commonly used
        # to control the lifetime of stack-allocated variables.  Braces are also
        # used for brace initializers inside function calls.  We don't detect this
        # perfectly: we just don't complain if the last non-whitespace character on
        # the previous non-blank line is ',', ';', ':', '(', '{', or '}', or if the
        # previous line starts a preprocessor block. We also allow a brace on the
        # following line if it is part of an array initialization and would not fit
        # within the 80 character limit of the preceding line.
        prevline = GetPreviousNonBlankLine(clean_lines, linenum)[0]
        if (
            not re.search(r"[,;:}{(]\s*$", prevline)
            and not re.match(r"\s*#", prevline)
            and not (GetLineWidth(prevline) > _line_length - 2 and "[]" in prevline)
        ):
            error(
                filename,
                linenum,
                "whitespace/braces",
                4,
                "{ should almost always be at the end of the previous line",
            )

    # An else clause should be on the same line as the preceding closing brace.
    if last_wrong := re.match(r"\s*else\b\s*(?:if\b|\{|$)", line):
        prevline = GetPreviousNonBlankLine(clean_lines, linenum)[0]
        if re.match(r"\s*}\s*$", prevline):
            error(
                filename,
                linenum,
                "whitespace/newline",
                4,
                "An else should appear on the same line as the preceding }",
            )
        else:
            last_wrong = False

    # If braces come on one side of an else, they should be on both.
    # However, we have to worry about "else if" that spans multiple lines!
    if re.search(r"else if\s*\(", line):  # could be multi-line if
        brace_on_left = bool(re.search(r"}\s*else if\s*\(", line))
        # find the ( after the if
        pos = line.find("else if")
        pos = line.find("(", pos)
        if pos > 0: