@ParametersAreNonnullByDefault

Package com.diffplug.common.base

Basic utility libraries and interfaces.

See: Description

Interface Summary

Interface	Description
Box<T>	Provides get/set access to a mutable non-null value.
Box.Dbl	A Box for primitive doubles.
Box.Int	A Box for primitive ints.
Box.Lng	A Box for primitive longs.
Box.Nullable<T>	A Box which allows nulls.
ConverterNullable<A,B>	A Converter which may receive null and may return null.
Errors.Plugins	Namespace for the plugins which Errors supports.
Errors.Plugins.Dialog	Plugin interface for Errors.dialog().
Errors.Plugins.Log	Plugin interface for Errors.log().
FinalizableReference	Implemented by references that have code to run after garbage collection of their referents.
Throwing.BiConsumer<T,U>
Throwing.BiFunction<T,U,R>
Throwing.BiPredicate<T,U>
Throwing.Consumer<T>
Throwing.Function<T,R>
Throwing.Predicate<T>
Throwing.Runnable
Throwing.Specific	Variations on the standard functional interfaces which throw a specific subclass of Throwable.
Throwing.Specific.BiConsumer<T,U,E extends Throwable>
Throwing.Specific.BiFunction<T,U,R,E extends Throwable>
Throwing.Specific.BiPredicate<T,U,E extends Throwable>
Throwing.Specific.Consumer<T,E extends Throwable>
Throwing.Specific.Function<T,R,E extends Throwable>
Throwing.Specific.Predicate<T,E extends Throwable>
Throwing.Specific.Runnable<E extends Throwable>
Throwing.Specific.Supplier<T,E extends Throwable>
Throwing.Supplier<T>

Class Summary

Class	Description
Ascii	Static methods pertaining to ASCII characters (those in the range of values 0x00 through 0x7F), and to strings containing such characters.
CharMatcher	Determines a true or false value for any Java char value, just as Predicate does for any Object.
Consumers	Static utility methods pertaining to Consumer instances.
Converter<A,B>	A function from A to B with an associated reverse function from B to A; used for converting back and forth between different representations of the same information.
Defaults	This class provides default values for all Java types, as defined by the JLS.
DurianPlugins	A programmatic and pluggable implementation of public static final.
Either<L,R>	A minimal implementation of Either.
Enums	Utility methods for working with Enum instances.
Equivalence<T>	A strategy for determining whether two instances are considered equivalent.
Equivalence.Wrapper<T>	Wraps an object so that Equivalence.Wrapper.equals(Object) and Equivalence.Wrapper.hashCode() delegate to an Equivalence.
Errors	Converts functions which throw exceptions into functions that don’t by passing exceptions to an error policy.
Errors.ConstrainedTo<E extends Throwable>	Generated by calling Errors.constrainTo(Class).
Errors.Handling	An Errors which is free to rethrow the exception, but it might not.
Errors.Plugins.OnErrorThrowAssertion	An implementation of all of the Errors plugins which throws an AssertionError on any exception.
Errors.Rethrowing	An Errors which is guaranteed to always throw a RuntimeException.
FinalizablePhantomReference<T>	Phantom reference with a finalizeReferent() method which a background thread invokes after the garbage collector reclaims the referent.
FinalizableReferenceQueue	A reference queue with an associated background thread that dequeues references and invokes FinalizableReference.finalizeReferent() on them.
FinalizableSoftReference<T>	Soft reference with a finalizeReferent() method which a background thread invokes after the garbage collector reclaims the referent.
FinalizableWeakReference<T>	Weak reference with a finalizeReferent() method which a background thread invokes after the garbage collector reclaims the referent.
Functions	Static utility methods pertaining to Function instances.
Joiner	An object which joins pieces of text (specified as an array, Iterable, varargs or even a Map) with a separator.
Joiner.MapJoiner	An object that joins map entries in the same manner as Joiner joins iterables and arrays.
MoreObjects	Helper functions that operate on any Object, and are not already provided in Objects.
MoreObjects.ToStringHelper	Support class for MoreObjects.toStringHelper(java.lang.Object).
Preconditions	Static convenience methods that help a method or constructor check whether it was invoked correctly (whether its preconditions have been met).
Predicates	Static utility methods pertaining to Predicate instances.
Splitter	Extracts non-overlapping substrings from an input string, typically by recognizing appearances of a separator sequence.
Splitter.MapSplitter	An object that splits strings into maps as Splitter splits iterables and lists.
Stopwatch	An object that measures elapsed time in nanoseconds.
StringPrinter	Pipes strings to a Consumer<String> through an API which unifies OutputStream, PrintStream, Writer, and PrintWriter.
Strings	Static utility methods pertaining to String or CharSequence instances.
Suppliers	Useful suppliers.
Throwables	Static utility methods pertaining to instances of Throwable.
Throwing	Variations on the standard functional interfaces which throw Throwable.
Ticker	A time source; returns a time value representing the number of nanoseconds elapsed since some fixed but arbitrary point in time.
Utf8	Low-level, high-performance utility methods related to the UTF-8 character encoding.
Verify	Static convenience methods that serve the same purpose as Java language assertions, except that they are always enabled.

Enum Summary

Enum	Description
CaseFormat	Utility class for converting between various ASCII case formats.
Comparison	Safe representation of the result of a comparison (better than int).
StandardSystemProperty	Represents a standard system property.

Exception Summary

Exception	Description
Errors.WrappedAsRuntimeException	A RuntimeException specifically for the purpose of wrapping non-runtime Throwables as RuntimeExceptions.
Unhandled	Exceptions appropriate for unhandled-case errors, such as unexpected default or else clauses.
VerifyException	Exception thrown upon the failure of a verification check, including those performed by the convenience methods of the Verify class.

Package com.diffplug.common.base Description

Basic utility libraries and interfaces.

This package is a part of the open-source Guava libraries.

Contents

String-related utilities

• Ascii
• CaseFormat
• CharMatcher
• StandardCharsets
• Joiner
• Splitter
• Strings

Function types

• Function, Functions
• Predicate, Predicates
• Equivalence
• Converter
• Supplier, Suppliers

Other

• Defaults
• Enums
• Objects
• Optional
• Preconditions
• Stopwatch
• Throwables