opennlp.tools.util
Class Span

java.lang.Object
  opennlp.tools.util.Span

All Implemented Interfaces:

java.lang.Comparable

public class Span
extends java.lang.Object
implements java.lang.Comparable

Class for storing start and end integer offsets.

Constructor Summary

Span(int s, int e)
Initializes a new Span Object.

Method Summary

int	compareTo(java.lang.Object o) Compares the specified span to the current span.
boolean	contains(int index)
boolean	contains(Span s) Returns true if the specified span is contained by this span.
boolean	crosses(Span s) Returns true is the specified span crosses this span.
boolean	equals(java.lang.Object o) Checks if the specified span is equal to the current span.
java.lang.String	getCoveredText(java.lang.String text) Retrieves the string covered by the current span of the specified text.
int	getEnd() Return the end of a span.
int	getStart() Return the start of a span.
int	hashCode() Generates a hash code of the current span.
boolean	intersects(Span s) Returns true if the specified span intersects with this span.
int	length() Returns the length of this span.
static java.lang.String[]	spansToStrings(Span[] spans, java.lang.String s) Converts an array of Spans to an array of Strings.
static java.lang.String[]	spansToStrings(Span[] spans, java.lang.String[] tokens)
boolean	startsWith(Span s) Returns true if the specified span is the begin of this span and the specified span is contained in this span.
java.lang.String	toString() Generates a human readable string.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Span

public Span(int s,
            int e)

Initializes a new Span Object.

Parameters:

s - start of span.

e - end of span.

Method Detail

getStart

public int getStart()

Return the start of a span.

Returns:

the start of a span.

getEnd

public int getEnd()

Return the end of a span.

Returns:

the end of a span.

length

public int length()

Returns the length of this span.

Returns:

the length of the span.

contains

public boolean contains(Span s)

Returns true if the specified span is contained by this span. Identical spans are considered to contain each other.

Parameters:

s - The span to compare with this span.

Returns:

true is the specified span is contained by this span; false otherwise.

contains

public boolean contains(int index)

startsWith

public boolean startsWith(Span s)

Returns true if the specified span is the begin of this span and the specified span is contained in this span.

Parameters:

s - The span to compare with this span.

Returns:

true if the specified span starts with this span and is contained in this span; false otherwise

intersects

public boolean intersects(Span s)

Returns true if the specified span intersects with this span.

Parameters:

s - The span to compare with this span.

Returns:

true is the spans overlap; false otherwise.

crosses

public boolean crosses(Span s)

Returns true is the specified span crosses this span.

Parameters:

s - The span to compare with this span.

Returns:

true is the specified span overlaps this span and contains a non-overlapping section; false otherwise.

getCoveredText

public java.lang.String getCoveredText(java.lang.String text)

Retrieves the string covered by the current span of the specified text.

Parameters:

text -

Returns:

the substring covered by the current span

compareTo

public int compareTo(java.lang.Object o)

Compares the specified span to the current span.

Specified by:

compareTo in interface java.lang.Comparable

hashCode

public int hashCode()

Generates a hash code of the current span.

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Checks if the specified span is equal to the current span.

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Generates a human readable string.

Overrides:

toString in class java.lang.Object

spansToStrings

public static java.lang.String[] spansToStrings(Span[] spans,
                                                java.lang.String s)

Converts an array of Spans to an array of Strings.

Parameters:

spans -

s -

Returns:

the strings

spansToStrings

public static java.lang.String[] spansToStrings(Span[] spans,
                                                java.lang.String[] tokens)