edu.stanford.nlp.ling
Class Sentence

java.lang.Object
  edu.stanford.nlp.ling.Sentence

public class Sentence
extends java.lang.Object

Sentence holds a couple utility methods for lists. Those include a method that nicely prints a list and methods that construct lists of words from lists of strings.

Author:

Dan Klein, Christopher Manning (generified), John Bauer

Method Summary

static <T> java.lang.String	extractNgram(java.util.List<T> list, int start, int end) Returns the substring of the sentence from start (inclusive) to end (exclusive).
static <T> java.lang.String	listToString(java.util.List<T> list) Returns the sentence as a string with a space between words.
static <T> java.lang.String	listToString(java.util.List<T> list, boolean justValue) Returns the sentence as a string with a space between words.
static <T> java.lang.String	listToString(java.util.List<T> list, boolean justValue, java.lang.String separator) As already described, but if separator is not null, then objects such as TaggedWord
static java.util.List<CoreLabel>	toCoreLabelList(java.lang.String... words)
static java.util.ArrayList<TaggedWord>	toTaggedList(java.util.List<java.lang.String> lex, java.util.List<java.lang.String> tags) Create an ArrayList as a list of TaggedWord from two lists of String, one for the words, and the second for the tags.
static java.util.ArrayList<Word>	toUntaggedList(java.util.List<java.lang.String> lex) Create an ArrayList as a list of Word from a list of String.
static java.util.ArrayList<Word>	toUntaggedList(java.lang.String... words) Create a Sentence as a list of Word objects from an array of String objects.
static java.util.List<HasWord>	toWordList(java.util.List<java.lang.String> lex)
static java.util.List<HasWord>	toWordList(java.lang.String... words)
static <T> java.lang.String	wordToString(T o, boolean justValue)
static <T> java.lang.String	wordToString(T o, boolean justValue, java.lang.String separator)

Methods inherited from class java.lang.Object

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

Method Detail

toTaggedList

public static java.util.ArrayList<TaggedWord> toTaggedList(java.util.List<java.lang.String> lex,
                                                           java.util.List<java.lang.String> tags)

Create an ArrayList as a list of TaggedWord from two lists of String, one for the words, and the second for the tags.

Parameters:

lex - a list whose items are of type String and are the words

tags - a list whose items are of type String and are the tags

Returns:

The Sentence

toUntaggedList

public static java.util.ArrayList<Word> toUntaggedList(java.util.List<java.lang.String> lex)

Create an ArrayList as a list of Word from a list of String.

Parameters:

lex - a list whose items are of type String and are the words

Returns:

The Sentence

toWordList

public static java.util.List<HasWord> toWordList(java.util.List<java.lang.String> lex)

toUntaggedList

public static java.util.ArrayList<Word> toUntaggedList(java.lang.String... words)

Create a Sentence as a list of Word objects from an array of String objects.

Parameters:

words - The words to make it from

Returns:

The Sentence

toWordList

public static java.util.List<HasWord> toWordList(java.lang.String... words)

toCoreLabelList

public static java.util.List<CoreLabel> toCoreLabelList(java.lang.String... words)

listToString

public static <T> java.lang.String listToString(java.util.List<T> list)

Returns the sentence as a string with a space between words. It strictly prints out the value() of each item - this will give the expected answer for a shortform representation of the "sentence" over a range of cases. It is equivalent to calling toString(true) TODO: Sentence used to be a subclass of ArrayList, with this method as the toString. Therefore, there may be instances of ArrayList being printed that expect this method to be used.

Returns:

The sentence

listToString

public static <T> java.lang.String listToString(java.util.List<T> list,
                                                boolean justValue)

Returns the sentence as a string with a space between words. Designed to work robustly, even if the elements stored in the 'Sentence' are not of type Label. This one uses the default separators for any word type that uses separators, such as TaggedWord.

Parameters:

justValue - If true and the elements are of type Label, return just the value() of the Label of each word; otherwise, call the toString() method on each item.

Returns:

The sentence in String form

listToString

public static <T> java.lang.String listToString(java.util.List<T> list,
                                                boolean justValue,
                                                java.lang.String separator)

As already described, but if separator is not null, then objects such as TaggedWord

Parameters:

separator - The string used to separate Word and Tag in TaggedWord, etc

wordToString

public static <T> java.lang.String wordToString(T o,
                                                boolean justValue)

wordToString

public static <T> java.lang.String wordToString(T o,
                                                boolean justValue,
                                                java.lang.String separator)

extractNgram

public static <T> java.lang.String extractNgram(java.util.List<T> list,
                                                int start,
                                                int end)

Returns the substring of the sentence from start (inclusive) to end (exclusive).

Parameters:

start - Leftmost index of the substring

end - Rightmost index of the ngram

Returns:

The ngram as a String