Class CleansedLines

tools/cpplint.py:2143–2237

Holds 4 copies of all lines with different preprocessing applied to them. 1) elided member contains lines without strings and comments. 2) lines member contains lines without comments. 3) raw_lines member contains all the lines without processing. 4) lines_without_raw_strings member

class CleansedLines:
    """Holds 4 copies of all lines with different preprocessing applied to them.

    1) elided member contains lines without strings and comments.
    2) lines member contains lines without comments.
    3) raw_lines member contains all the lines without processing.
    4) lines_without_raw_strings member is same as raw_lines, but with C++11 raw
       strings removed.
    All these members are of <type 'list'>, and of the same length.
    """

    def __init__(self, lines):
        if "-readability/alt_tokens" in _cpplint_state.filters:
            for i, line in enumerate(lines):
                lines[i] = ReplaceAlternateTokens(line)
        self.elided = []
        self.lines = []
        self.raw_lines = lines
        self.num_lines = len(lines)
        self.lines_without_raw_strings = CleanseRawStrings(lines)
        for line in self.lines_without_raw_strings:
            self.lines.append(CleanseComments(line))
            elided = self._CollapseStrings(line)
            self.elided.append(CleanseComments(elided))

    def NumLines(self):
        """Returns the number of lines represented."""
        return self.num_lines

    @staticmethod
    def _CollapseStrings(elided):
        """Collapses strings and chars on a line to simple "" or '' blocks.

        We nix strings first so we're not fooled by text like '"http://"&#x27;

        Args:
          elided: The line being processed.

        Returns:
          The line with collapsed strings.
        """
        if _RE_PATTERN_INCLUDE.match(elided):
            return elided

        # Remove escaped characters first to make quote/single quote collapsing
        # basic.  Things that look like escaped characters shouldn't occur
        # outside of strings and chars.
        elided = _RE_PATTERN_CLEANSE_LINE_ESCAPES.sub("", elided)

        # Replace quoted strings and digit separators.  Both single quotes
        # and double quotes are processed in the same loop, otherwise
        # nested quotes wouldn't work.
        collapsed = ""
        while True:
            # Find the first quote character
            match = re.match(r'^([^\'"]*)([\'"])(.*)$&#x27;, elided)
            if not match:
                collapsed += elided