tech.tablesaw.sorting

Class Sort

java.lang.Object

tech.tablesaw.sorting.Sort

All Implemented Interfaces:

Iterable<Map.Entry<String,Sort.Order>>

public class Sort
extends Object
implements Iterable<Map.Entry<String,Sort.Order>>

Provides fine-grained control over sorting.

Use:

table.sortOn(first("Year", DESCEND).next("State", ASCEND));

This sorts table on the column named year in descending order, such that the most recent years appear first, then on State, in ascending order so "AL" will appear before "CA". You can add additional instructions for multi-column sorts by chaining additional calls to next() with the appropriate column names and Order.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Sort.Order

Constructor Summary

Constructors

Constructor and Description
Sort(String columnName, Sort.Order order)

Method Summary

Modifier and Type	Method and Description
static Sort	create(Table table, String... columnNames) Create a Sort object from the given table and sort column names.
boolean	isEmpty()
Iterator<Map.Entry<String,Sort.Order>>	iterator() Returns an iterator over elements of type T.
Sort	next(String columnName, Sort.Order order)
static Sort	on(String columnName, Sort.Order order)
int	size()
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

Sort

public Sort(String columnName,
            Sort.Order order)

Method Detail

on

public static Sort on(String columnName,
                      Sort.Order order)

next

public Sort next(String columnName,
                 Sort.Order order)

isEmpty

public boolean isEmpty()

size

public int size()

create

public static Sort create(Table table,
                          String... columnNames)

Create a Sort object from the given table and sort column names. Does not sort the table.

Parameters:

table - to sort. Used only to pull the table's schema. Does not modify the table.

columnNames - The columns to sort on. Can prefix column name with + for ascending, - for descending. Default to ascending if no prefix is added.

Returns:

a Sort(java.lang.String, tech.tablesaw.sorting.Sort.Order) Object.

iterator

public Iterator<Map.Entry<String,Sort.Order>> iterator()

Returns an iterator over elements of type T.

Specified by:

iterator in interface Iterable<Map.Entry<String,Sort.Order>>

Returns:

an Iterator.

toString

public String toString()

Overrides:

toString in class Object