com.diffplug.common.base

Class StringPrinter

java.lang.Object

com.diffplug.common.base.StringPrinter

public class StringPrinter
extends Object

Pipes strings to a Consumer<String> through an API similar to PrintWriter and PrintStream. Can present itself as an OutputStream, PrintStream, Writer, or PrintWriter.

Constructor Summary

Constructors

Constructor and Description
StringPrinter(Consumer<String> consumer) StringPrinter will pass all the strings it receives to the given consumer.

Method Summary

Modifier and Type	Method and Description
static String	buildString(Consumer<StringPrinter> printer) Easy way to create a String using a StringPrinter.
static String	buildStringFromLines(String... lines) Easy way to create a String from a bunch of lines.
void	print(String content) Prints the string.
void	println(String line) Prints the string and a newline (always '\n').
static Consumer<String>	stringsToLines(Consumer<String> perLine) Given a consumer of lines, creates a stateful consumer of strings which will combine its input until it finds a newline, and split its input when it contains multiple newlines.
static StringPrinter	systemErr() Returns a StringPrinter for System.err.
static StringPrinter	systemOut() Returns a StringPrinter for System.out.
OutputStream	toOutputStream(Charset charset) Creates an OutputStream which will print its content to the given StringPrinter, encoding bytes according to the given Charset.
PrintStream	toPrintStream() Creates a UTF-8 PrintStream which passes its content to this StringPrinter.
PrintStream	toPrintStream(Charset charset) Creates a PrintStream of the given charset, which passes its content to this StringPrinter.
PrintWriter	toPrintWriter() Creates a PrintWriter which passes its content to this StringPrinter.
Writer	toWriter() Creates a Writer which passes its content to this StringPrinter.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringPrinter

public StringPrinter(Consumer<String> consumer)

StringPrinter will pass all the strings it receives to the given consumer.

Method Detail

println

public void println(String line)

Prints the string and a newline (always '\n').

print

public void print(String content)

Prints the string.

buildString

public static String buildString(Consumer<StringPrinter> printer)

Easy way to create a String using a StringPrinter.

buildStringFromLines

public static String buildStringFromLines(String... lines)

Easy way to create a String from a bunch of lines.

toOutputStream

public OutputStream toOutputStream(Charset charset)

Creates an OutputStream which will print its content to the given StringPrinter, encoding bytes according to the given Charset. Doesn't matter if you close the stream or not, because StringPrinter doesn't have a close().

Strings are sent to the consumer as soon as their constituent bytes are written to this OutputStream.

The implementation is lifted from Apache commons-io. Many thanks to them!

toPrintStream

public PrintStream toPrintStream()

Creates a UTF-8 PrintStream which passes its content to this StringPrinter.

toPrintStream

public PrintStream toPrintStream(Charset charset)

Creates a PrintStream of the given charset, which passes its content to this StringPrinter.

toWriter

public Writer toWriter()

Creates a Writer which passes its content to this StringPrinter.

toPrintWriter

public PrintWriter toPrintWriter()

Creates a PrintWriter which passes its content to this StringPrinter.

stringsToLines

public static Consumer<String> stringsToLines(Consumer<String> perLine)

Given a consumer of lines, creates a stateful consumer of strings which will combine its input until it finds a newline, and split its input when it contains multiple newlines. Examples make this more clear:

 "some", "\n", "simple ", "lines", "\n" -> "some", "simple lines"
 "some\nsimple lines\n"                 -> "some", "simple lines"
 "no newline\nno output"                -> "no newline"
 

Parameters:

perLine - a Consumer which will receive strings which were terminated by newlines (but aren't anymore).

Returns:

a Consumer which accepts any strings, and will feed them to perLine.

systemOut

public static StringPrinter systemOut()

Returns a StringPrinter for System.out.

systemErr

public static StringPrinter systemErr()

Returns a StringPrinter for System.err.