com.diffplug.common.base

Class StringPrinter

java.lang.Object

com.diffplug.common.base.StringPrinter

public class StringPrinter
extends java.lang.Object

A simple class for receiving a stream of Strings in a way that resembles a PrintStream or PrintWriter.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
static java.lang.String	buildString(java.util.function.Consumer<StringPrinter> printer) Easy way to create a String using a StringPrinter.
static java.lang.String	buildStringFromLines(java.lang.String... lines) Easy way to create a String from a bunch of lines.
void	print(java.lang.String content) Prints the string.
void	println(java.lang.String line) Prints the string and a newline (always '\n').
static java.util.function.Consumer<java.lang.String>	stringsToLines(java.util.function.Consumer<java.lang.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.
java.io.OutputStream	toOutputStream(java.nio.charset.Charset charset) Creates an OutputStream which will print its content to the given StringPrinter, encoding bytes according to the given Charset.
java.io.PrintStream	toPrintStream() Creates a UTF-8 PrintStream which passes its content to this StringPrinter.
java.io.PrintStream	toPrintStream(java.nio.charset.Charset charset) Creates a PrintStream of the given charset, which passes its content to this StringPrinter.
java.io.PrintWriter	toPrintWriter() Creates a PrintWriter which passes its content to this StringPrinter.
java.io.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(java.util.function.Consumer<java.lang.String> consumer)

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

Method Detail

println

public void println(java.lang.String line)

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

print

public void print(java.lang.String content)

Prints the string.

buildString

public static java.lang.String buildString(java.util.function.Consumer<StringPrinter> printer)

Easy way to create a String using a StringPrinter.

buildStringFromLines

public static java.lang.String buildStringFromLines(java.lang.String... lines)

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

toOutputStream

public java.io.OutputStream toOutputStream(java.nio.charset.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 consituent bytes are written to this OutputStream. The implementation is lifted from Apache commons-io. Many thanks to them!

toPrintStream

public java.io.PrintStream toPrintStream()

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

toPrintStream

public java.io.PrintStream toPrintStream(java.nio.charset.Charset charset)

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

toWriter

public java.io.Writer toWriter()

Creates a Writer which passes its content to this StringPrinter.

toPrintWriter

public java.io.PrintWriter toPrintWriter()

Creates a PrintWriter which passes its content to this StringPrinter.

stringsToLines

public static java.util.function.Consumer<java.lang.String> stringsToLines(java.util.function.Consumer<java.lang.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: e.g. "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.