net.sf.paperclips.internal
Class PaperClipsUtil

java.lang.Object
  net.sf.paperclips.internal.PaperClipsUtil

public class PaperClipsUtil
extends java.lang.Object

Convenience methods specific to PaperClips

Method Summary

static int[]	copy(int[] array) Returns a copy of the array.
static int[][]	copy(int[][] array) Returns a deep copy of the array.
static void	dispose(java.util.List pages) Disposes the print pieces in the list.
static void	dispose(PrintPiece piece) Disposes the print piece if not null.
static void	dispose(PrintPiece[] pieces) Disposes the print pieces that are not null.
static void	dispose(PrintPiece[] pages, int start, int end) Disposes the print pieces in the array from start (inclusive) to end (exclusive).
static void	dispose(PrintPiece p1, PrintPiece p2) Disposes the arguments that are not null.
static void	dispose(PrintPiece piece, PrintPiece[] pieces) Disposes the print pieces that are not null.
static int	firstMatch(int value, int[] masks, int defaultMask) Returns the first element in masks where (value & mask[index]) == mask[index].
static int	sum(int[] array) Returns the sum of all elements in the array.
static int	sum(int[] array, int start, int count) Returns the sum of all elements in the array in the range [start, start+count).
static int	sumByIndex(int[] array, int[] indices) Returns the sum of all elements in the array at the given indices.
static int[]	toIntArray(java.util.List list) Converts the argument to an int[] array.
static int[][]	toIntIntArray(java.util.List list) Converts the argument to an int[][] array.

Methods inherited from class java.lang.Object

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

Method Detail

dispose

public static void dispose(PrintPiece piece)

Disposes the print piece if not null.

Parameters:

piece - the print piece to dispose.

dispose

public static void dispose(PrintPiece p1,
                           PrintPiece p2)

Disposes the arguments that are not null.

Parameters:

p1 - print piece to dispose

p2 - print piece to dispose

dispose

public static void dispose(PrintPiece[] pieces)

Disposes the print pieces that are not null.

Parameters:

pieces - array of print pieces to dispose.

dispose

public static void dispose(PrintPiece[] pages,
                           int start,
                           int end)

Disposes the print pieces in the array from start (inclusive) to end (exclusive).

Parameters:

pages - array of print pieces to dispose.

start - the start index.

end - the end index.

dispose

public static void dispose(java.util.List pages)

Disposes the print pieces in the list.

Parameters:

pages - list of print pieces to dispose.

dispose

public static void dispose(PrintPiece piece,
                           PrintPiece[] pieces)

Disposes the print pieces that are not null.

Parameters:

piece - a print piece to dispose

pieces - array of print pieces to dispose

copy

public static int[] copy(int[] array)

Returns a copy of the array.

Parameters:

array - the array to copy

Returns:

a copy of the array.

copy

public static int[][] copy(int[][] array)

Returns a deep copy of the array.

Parameters:

array - the array to copy

Returns:

a copy of the array.

sum

public static int sum(int[] array)

Returns the sum of all elements in the array.

Parameters:

array - the array

Returns:

the sum of all elements in the array.

sum

public static int sum(int[] array,
                      int start,
                      int count)

Returns the sum of all elements in the array in the range [start, start+count).

Parameters:

array - the array containing the elements to add up.

start - the index of the first element to add.

count - the number of elements to add.

Returns:

the sum of all elements in the array in the specified range.

sumByIndex

public static int sumByIndex(int[] array,
                             int[] indices)

Returns the sum of all elements in the array at the given indices.

Parameters:

array - the array of elements to add up.

indices - the indices of the elements in the array to add up.

Returns:

the sum of all elements in the array at the given indices.

toIntArray

public static int[] toIntArray(java.util.List list)

Converts the argument to an int[] array.

Parameters:

list - a List of Integers.

Returns:

a primitive int[] array.

toIntIntArray

public static int[][] toIntIntArray(java.util.List list)

Converts the argument to an int[][] array.

Parameters:

list - a List of int[] arrays.

Returns:

a primitive int[][] array.

firstMatch

public static int firstMatch(int value,
                             int[] masks,
                             int defaultMask)

Returns the first element in masks where (value & mask[index]) == mask[index].

Parameters:

value - the value to match

masks - the possible values.

defaultMask - the value to return if no match is found.

Returns:

the first value in possibleValues which is a bitwise match to value, or 0 if none is found.