org.unix4j.unix.grep

Interface GrepOptions

All Superinterfaces:

Iterable<GrepOption>, OptionSet<GrepOption>

All Known Implementing Classes:

GrepOption, GrepOptions.Default, GrepOptionSet_Fcilnvx

public interface GrepOptions
extends OptionSet<GrepOption>

Interface implemented by all option sets for the grep command. It is recommended to use Grep.Options to specify a valid combination of options.

The options for the grep command are:

	-i		--ignoreCase		Match lines ignoring the case when comparing the strings, also known from Unix with its acronym 'i'.
	-v		--invertMatch		Invert the match result, that is, a non-matching line is written to the output and a matching line is not. This option is also known from Unix with its acronym 'v'.
	-F		--fixedStrings		Use fixed-strings matching instead of regular expressions. This is usually faster than the standard regexp version. (This option is ignored if a pattern operand is specified instead of the regexp string).
	-n		--lineNumber		Prefix each line of output with the line number within its input file.
	-c		--count		Suppress normal output; instead print a count of matching lines for each input file. With the -v, --invertMatch option, count non-matching lines.
	-l		--matchingFiles		Suppress normal output; instead print the name of each input file from which output would normally have been printed. The scanning will stop on the first match.
	-x		--wholeLine		Select only those matches that exactly match the whole line excluding the terminating line ending. (This option is ignored if a pattern operand is specified instead of the regexp string).

This interface serves as an alias for the extended interface to simplify the command signature methods by avoiding generic parameters.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	GrepOptions.Default Default implementation for a modifiable option set.

Field Summary

Fields

Modifier and Type	Field and Description
static ValueConverter<GrepOptions>	CONVERTER Value converter for GrepOptions based on an OptionSetConverters.OptionSetConverter.
static GrepOptions	EMPTY Constant for an empty option set.

Method Summary

Methods inherited from interface org.unix4j.option.OptionSet

asSet, isSet, iterator, optionType, size, useAcronymFor

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

EMPTY

static final GrepOptions EMPTY

Constant for an empty option set.

CONVERTER

static final ValueConverter<GrepOptions> CONVERTER

Value converter for GrepOptions based on an OptionSetConverters.OptionSetConverter.