cetus.hir

Class PrintTools

java.lang.Object

cetus.hir.PrintTools

public final class PrintTools
extends java.lang.Object

PrintTools provides tools that perform printing of collections of IR or debug messages.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	file_sep
static java.lang.String	line_sep
static java.lang.String	path_sep

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	collectionToString(java.util.Collection coll, java.lang.String separator) Converts a collection of objects to a string with the given separator.
static int	getVerbosity() Returns the global verbosity level
static java.lang.String	listToString(java.util.List list, java.lang.String separator) Converts a list of objects to a string with the given separator.
static java.lang.String	listToStringWithSkip(java.util.List list, java.lang.String separator) Converts a list of objects to a string.
static java.lang.String	mapToString(java.util.Map map, java.lang.String separator) Converts a map to a string.
static void	print(java.lang.String message, int min_verbosity) Prints a string to System.out if the verbosity level is greater than min_verbosity.
static void	printList(java.util.List list, java.io.PrintWriter w) Prints a list of printable object to the specified print writer without any separating string.
static void	printListWithComma(java.util.List list, java.io.PrintWriter w) Prints a list of printable object to the specified print writer with a separating comma.
static void	printListWithSeparator(java.util.List list, java.io.PrintWriter w, java.lang.String sep) Prints a list of printable object to the specified print writer with a separating stirng.
static void	printListWithSpace(java.util.List list, java.io.PrintWriter w) Prints a list of printable object to the specified print writer with a separating white space.
static void	println(java.lang.String message, int min_verbosity) Prints a string to System.out if the verbosity level is greater than min_verbosity.
static void	printlnList(java.util.List list, java.io.PrintWriter w) Prints a list of printable object to the specified print writer with a separating new line character.
static void	printlnStatus(int min_verbosity, java.lang.Object... items) Prints the specified items to System.err with separating white spaces if verbosity is greater than min_verbosity.
static void	printlnStatus(Printable p, int min_verbosity) Prints a Printable object to System.err if the verbosity level is greater than min_verbosity.
static void	printlnStatus(java.lang.String message, int min_verbosity) Prints a string to System.err if the verbosity level is greater than min_verbosity.
static void	printStatus(Printable p, int min_verbosity) Prints a Printable object to System.err if the verbosity level is greater than min_verbosity.
static void	printStatus(java.lang.String message, int min_verbosity) Prints a string to System.err if the verbosity level is greater than min_verbosity.
static void	removeVerboseParens(Traversable t) Removes unnecessary parentheses from the given traversable object.

Methods inherited from class java.lang.Object

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

Field Detail

line_sep

public static final java.lang.String line_sep

file_sep

public static final java.lang.String file_sep

path_sep

public static final java.lang.String path_sep

Method Detail

printlnStatus

public static void printlnStatus(Printable p,
                 int min_verbosity)

Prints a Printable object to System.err if the verbosity level is greater than min_verbosity.

Parameters:

p - A Printable object.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

printlnStatus

public static void printlnStatus(java.lang.String message,
                 int min_verbosity)

Prints a string to System.err if the verbosity level is greater than min_verbosity.

Parameters:

message - The message to be printed.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

printlnStatus

public static void printlnStatus(int min_verbosity,
                 java.lang.Object... items)

Prints the specified items to System.err with separating white spaces if verbosity is greater than min_verbosity. This method minimizes overheads from string composition since it is done only if the verbosity level is met.

Parameters:

min_verbosity - the minium verbosity.

items - the list of items to be printed.

print

public static void print(java.lang.String message,
         int min_verbosity)

Prints a string to System.out if the verbosity level is greater than min_verbosity.

Parameters:

message - The message to be printed.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

println

public static void println(java.lang.String message,
           int min_verbosity)

Prints a string to System.out if the verbosity level is greater than min_verbosity.

Parameters:

message - The message to be printed.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

printStatus

public static void printStatus(Printable p,
               int min_verbosity)

Prints a Printable object to System.err if the verbosity level is greater than min_verbosity.

Parameters:

p - A Printable object.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

printStatus

public static void printStatus(java.lang.String message,
               int min_verbosity)

Prints a string to System.err if the verbosity level is greater than min_verbosity.

Parameters:

message - The message to be printed.

min_verbosity - An integer to compare with the value set by the -verbosity command-line flag.

printListWithSeparator

public static void printListWithSeparator(java.util.List list,
                          java.io.PrintWriter w,
                          java.lang.String sep)

Prints a list of printable object to the specified print writer with a separating stirng. If the list contains an object not printable, this method throws a cast exception.

Parameters:

list - the list of printable object.

w - the target print writer.

sep - the separating string.

printListWithComma

public static void printListWithComma(java.util.List list,
                      java.io.PrintWriter w)

Prints a list of printable object to the specified print writer with a separating comma.

Parameters:

list - the list of printable object.

w - the target print writer.

printListWithSpace

public static void printListWithSpace(java.util.List list,
                      java.io.PrintWriter w)

Prints a list of printable object to the specified print writer with a separating white space.

Parameters:

list - the list of printable object.

w - the target print writer.

printList

public static void printList(java.util.List list,
             java.io.PrintWriter w)

Prints a list of printable object to the specified print writer without any separating string.

Parameters:

list - the list of printable object.

w - the target print writer.

printlnList

public static void printlnList(java.util.List list,
               java.io.PrintWriter w)

Prints a list of printable object to the specified print writer with a separating new line character.

Parameters:

list - the list of printable object.

w - the target print writer.

getVerbosity

public static int getVerbosity()

Returns the global verbosity level

collectionToString

public static java.lang.String collectionToString(java.util.Collection coll,
                                  java.lang.String separator)

Converts a collection of objects to a string with the given separator. By default, the element of the collections are sorted alphabetically, and any Symbol object is printed with its name.

Parameters:

coll - the collection to be converted.

separator - the separating string.

Returns:

the converted string.

listToString

public static java.lang.String listToString(java.util.List list,
                            java.lang.String separator)

Converts a list of objects to a string with the given separator.

Parameters:

list - the list to be converted.

separator - the separating string.

Returns:

the converted string.

listToStringWithSkip

public static java.lang.String listToStringWithSkip(java.util.List list,
                                    java.lang.String separator)

Converts a list of objects to a string. The difference from listToString is that this method inserts the separating string only if the heading string length is non-zero.

Parameters:

list - the list to be converted.

separator - the separating string.

mapToString

public static java.lang.String mapToString(java.util.Map map,
                           java.lang.String separator)

Converts a map to a string.

removeVerboseParens

public static void removeVerboseParens(Traversable t)

Removes unnecessary parentheses from the given traversable object.

Parameters:

t - the traversable object to be processed.