/**
 *
 */
package CLInterface;

import java.io.IOException;
import java.io.OutputStream;

/**
 * Quick and dirty Printer class that accepts messages to log and either logs them if possible, or else discards them. It uses varargs to support an arbitrary amount of messages sent to whatever output.
 * 
 * Here's some example usage:
 * <pre>
 * {@code
 * Printer.output("A message on a single line");
 * Printer.log("A message on a single line that gets sent to stderr");
 * Printer.output("A message on", "two lines");
 * Printer.output({"Also a message on", "two lines"});
 * Printer.output(new FileOutputStream(new File("./some_file")), "A message on", "two lines");
 * }
 * </pre>
 * @author Chris Tandiono
 */
public class Printer {

	/**
	 * Prints messages to destination.
	 * @param destination OutputStream to write to. If null, doesn't actually write anything to anywhere.
	 * @param messages Strings to write. Doesn't write null strings at all (as opposed to outputting a blank line, for example).
	 */
	private static void actuallyPrint(OutputStream destination, String[] messages) {
		if (destination == null) { /* no point actually doing anything */
			return;
		}
		try {
			String message;
			for (int i = 0; i < messages.length; i++) {
				message = messages[i];
				if (message != null) { /* null: ignore */
					destination.write(message.getBytes());
					destination.write("\n".getBytes());
				}
			}
			destination.flush();
		} catch (IOException e) {
			e.printStackTrace();
		}
	}


	/**
	 * Print to System.err, if so defined on the command-line.
	 *
	 * @param messages Message(s) to write.
	 */
	public static void log(String... messages) {
		actuallyPrint(ConverterConfig.DEBUG, messages);
	}

	/**
	 * Print to output as configured on the command-line.
	 *
	 * @param messages Message(s) to write.
	 */
	public static void output(String... messages) {
		actuallyPrint(ConverterConfig.OUTPUT, messages);
	}

	/**
	 * Print with custom OutputStream destination.
	 *
	 * @param destination OutputStream to write to.
	 * @param messages Message(s) to write.
	 */
	public static void output(OutputStream destination, String... messages) {
		actuallyPrint(destination, messages);
	}

}

@@ -1605,32 +1605,51 @@
 the command-line
+ with the -v option
 .%0D%0A%09 *%0D%0A%09 * @par

update documentation for Printer.java