jline

Class SimpleCompletor

java.lang.Object

jline.SimpleCompletor

All Implemented Interfaces:

Cloneable, Completor

Direct Known Subclasses:

ClassNameCompletor

public class SimpleCompletor
extends Object
implements Completor, Cloneable

A simple Completor implementation that handles a pre-defined list of completion words.

Example usage:

  myConsoleReader.addCompletor (new SimpleCompletor (new String [] { "now", "yesterday", "tomorrow" }));
  

Author:

Marc Prud'hommeaux

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SimpleCompletor.NoOpFilter
static interface	SimpleCompletor.SimpleCompletorFilter Filter for elements in the completor.

Constructor Summary

Constructors

Constructor and Description
SimpleCompletor(InputStream in) Complete candidates using the whitespearated values in read from the specified Reader.
SimpleCompletor(Reader reader) Complete candidates using the contents of the specified Reader.
SimpleCompletor(String candidateString) Create a new SimpleCompletor with a single possible completion values.
SimpleCompletor(String[] candidateStrings) Create a new SimpleCompletor with a list of possible completion values.
SimpleCompletor(String[] strings, SimpleCompletor.SimpleCompletorFilter filter)

Method Summary

Modifier and Type	Method and Description
void	addCandidateString(String candidateString)
Object	clone()
int	complete(String buffer, int cursor, List<String> clist) Populates candidates with a list of possible completions for the buffer.
SortedSet<String>	getCandidates()
String	getDelimiter()
void	setCandidates(SortedSet<String> candidates)
void	setCandidateStrings(String[] strings)
void	setDelimiter(String delimiter)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SimpleCompletor

public SimpleCompletor(String candidateString)

Create a new SimpleCompletor with a single possible completion values.

SimpleCompletor

public SimpleCompletor(String[] candidateStrings)

Create a new SimpleCompletor with a list of possible completion values.

SimpleCompletor

public SimpleCompletor(String[] strings,
                       SimpleCompletor.SimpleCompletorFilter filter)

SimpleCompletor

public SimpleCompletor(Reader reader)
                throws IOException

Complete candidates using the contents of the specified Reader.

Throws:

IOException

SimpleCompletor

public SimpleCompletor(InputStream in)
                throws IOException

Complete candidates using the whitespearated values in read from the specified Reader.

Throws:

IOException

Method Detail

complete

public int complete(String buffer,
                    int cursor,
                    List<String> clist)

Description copied from interface: Completor

Populates candidates with a list of possible completions for the buffer. The candidates list will not be sorted before being displayed to the user: thus, the complete method should sort the List before returning.

Specified by:

complete in interface Completor

Parameters:

buffer - the buffer

clist - the List of candidates to populate

Returns:

the index of the buffer for which the completion will be relative

setDelimiter

public void setDelimiter(String delimiter)

getDelimiter

public String getDelimiter()

setCandidates

public void setCandidates(SortedSet<String> candidates)

getCandidates

public SortedSet<String> getCandidates()

setCandidateStrings

public void setCandidateStrings(String[] strings)

addCandidateString

public void addCandidateString(String candidateString)

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException