Class GrepDelegator

    • Constructor Detail

      • GrepDelegator

        public GrepDelegator​(IOptionsServer server)
        Instantiates a new grep delegator.
        Parameters:
        server - the server
    • Method Detail

      • getMatchingLines

        public java.util.List<IFileLineMatch> getMatchingLines​(java.util.List<IFileSpec> fileSpecs,
                                                               java.lang.String pattern,
                                                               MatchingLinesOptions options)
                                                        throws P4JavaException
        Get list of matching lines in the specified file specs. This method implements the p4 grep command; for full semantics, see the separate p4 documentation and / or the GrepOptions Javadoc.
        Specified by:
        getMatchingLines in interface IGrepDelegator
        Parameters:
        fileSpecs - file specs to search for matching lines
        pattern - non-null string pattern to be passed to the grep command
        options - - Options to grep command
        Returns:
        - non-null but possibly empty list of file line matches
        Throws:
        P4JavaException - if any error occurs in the processing of this method.
      • getMatchingLines

        public java.util.List<IFileLineMatch> getMatchingLines​(@Nonnull
                                                               java.util.List<IFileSpec> fileSpecs,
                                                               @Nonnull
                                                               java.lang.String pattern,
                                                               @Nullable
                                                               java.util.List<java.lang.String> infoLines,
                                                               MatchingLinesOptions options)
                                                        throws P4JavaException
        Get list of matching lines in the specified file specs. This method implements the p4 grep command; for full semantics, see the separate p4 documentation and / or the GrepOptions Javadoc.

        This method allows the user to retrieve useful info and warning message lines the Perforce server may generate in response to things like encountering a too-long line, etc., by passing in a non-null infoLines parameter.

        Specified by:
        getMatchingLines in interface IGrepDelegator
        Parameters:
        fileSpecs - file specs to search for matching lines
        pattern - non-null string pattern to be passed to the grep command
        infoLines - if not null, any "info" lines returned from the server (i.e. warnings about exceeded line lengths, etc.) will be put into the passed-in list in the order they are received.
        options - - Options to grep command
        Returns:
        - non-null but possibly empty list of file line matches
        Throws:
        P4JavaException - if any error occurs in the processing of this method.
        Since:
        2011.1