edu.princeton.cs.algorithms

Class SuffixArrayX

java.lang.Object

edu.princeton.cs.algorithms.SuffixArrayX

public class SuffixArrayX
extends Object

The SuffixArrayX class represents a suffix array of a string of length N. It supports the selecting the ith smallest suffix, getting the index of the ith smallest suffix, computing the length of the longest common prefix between the ith smallest suffix and the i-1st smallest suffix, and determining the rank of a query string (which is the number of suffixes strictly less than the query string).

This implementation uses 3-way radix quicksort to sort the array of suffixes. For a simpler (but less efficient) implementations of the same API, see SuffixArray. The index and length operations takes constant time in the worst case. The lcp operation takes time proportional to the length of the longest common prefix. The select operation takes time proportional to the length of the suffix and should be used primarily for debugging.

For additional documentation, see Section 6.3 of Algorithms, 4th Edition by Robert Sedgewick and Kevin Wayne.

Constructor Summary

Constructors

Constructor and Description
SuffixArrayX(String text) Initializes a suffix array for the given text string.

Method Summary

Methods

Modifier and Type	Method and Description
int	index(int i) Returns the index into the original string of the ith smallest suffix.
int	lcp(int i) Returns the length of the longest common prefix of the ith smallest suffix and the i-1st smallest suffix.
int	length() Returns the length of the input string.
static void	main(String[] args) Unit tests the SuffixArrayx data type.
int	rank(String query) Returns the number of suffixes strictly less than the query string.
String	select(int i) Returns the ith smallest suffix as a string.

Methods inherited from class java.lang.Object

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

Constructor Detail

SuffixArrayX

public SuffixArrayX(String text)

Initializes a suffix array for the given text string.

Parameters:

text - the input string

Method Detail

length

public int length()

Returns the length of the input string.

Returns:

the length of the input string

index

public int index(int i)

Returns the index into the original string of the ith smallest suffix. That is, text.substring(sa.index(i)) is the i smallest suffix.

Parameters:

i - an integer between 0 and N-1

Returns:

the index into the original string of the ith smallest suffix

Throws:

IndexOutOfBoundsException - unless 0 ≤ i < N

lcp

public int lcp(int i)

Returns the length of the longest common prefix of the ith smallest suffix and the i-1st smallest suffix.

Parameters:

i - an integer between 1 and N-1

Returns:

the length of the longest common prefix of the ith smallest suffix and the i-1st smallest suffix.

Throws:

IndexOutOfBoundsException - unless 1 ≤ i < N

select

public String select(int i)

Returns the ith smallest suffix as a string.

Parameters:

i - the index

Returns:

the i smallest suffix as a string

Throws:

IndexOutOfBoundsException - unless 0 ≤ i < N

rank

public int rank(String query)

Returns the number of suffixes strictly less than the query string. We note that rank(select(i)) equals i for each i between 0 and N-1.

Parameters:

query - the query string

Returns:

the number of suffixes strictly less than query

main

public static void main(String[] args)

Unit tests the SuffixArrayx data type.