com.neeve.lang

Class XPooledString

java.lang.Object

com.neeve.lang.XString

com.neeve.lang.XAbstractPooledString<XPooledString>

com.neeve.lang.XPooledString

All Implemented Interfaces:

UtlPool.Item<XPooledString>, Appendable, CharSequence

public final class XPooledString
extends XAbstractPooledString<XPooledString>

Implements a poolable XString.

Note: This class is currently intended for internal use only.

Nested Class Summary

Nested classes/interfaces inherited from class com.neeve.lang.XString

XString.ImmutableExtension

Field Summary

Fields

Modifier and Type	Field and Description
static IXStringFactory<XPooledString>	FACTORY The default factory used to create pooled string instances.

Method Summary

Modifier and Type	Method and Description
static XPooledString	create() Create a new, mutable, uninitialized XPooledString using this type's default IXStringFactory.
static XPooledString	create(boolean mutable) Create a new, uninitialized XPooledString using this type's default IXStringFactory.
static XPooledString	create(String initialValue, boolean mutable) Create a new XPooledString initialized to the given value using this type's default IXStringFactory.
static XPooledString	create(XString initialValue, boolean mutable) Create a new XPooledString initialized to the given value using this type's default IXStringFactory.
static IXStringFactory<XPooledString>	newFactory(String name, Map<String,Object> props) Construct a new Factory for XPooledStrings.
static IXStringFactory<XPooledString>	newFactory(String name, short initialCapacity, boolean pooled, int preallocationCount, boolean threaded) Construct a new Factory for XPooledStrings.

Methods inherited from class com.neeve.lang.XAbstractPooledString

acquire, dispose, getOwnershipCount, getPool, init, setPool

Methods inherited from class com.neeve.lang.XString

append, append, append, append, append, append, append, append, append, append, append, append, canMutate, capacity, charAt, clear, clear, close, compareTo, copyFrom, copyFrom, copyFromMemory, copyFromNative, copyInto, copyInto, copyInto, copyInto, create, create, create, create, create, create, ensureCapacity, equals, getAsLong, getAsLong, getAsLongDecimal, getAsString, getSerializedLength, getTo, getTo, getTo, getTo, getTo, getTo, getValue, getValueAsLong, hashCode, hasValue, indexOf, indexOf, indexOf, indexOf, initialize, initializeFrom, isEmpty, isImmutable, isInitialized, isMutable, isNull, length, nativeAddress, reset, serializedLength, setCharAt, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setFrom, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValue, setValueFromMemory, startsWith, startsWith, stringSize, subSequence, toDiagnosticString, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Field Detail

FACTORY

public static final IXStringFactory<XPooledString> FACTORY

The default factory used to create pooled string instances.

Method Detail

newFactory

public static IXStringFactory<XPooledString> newFactory(String name,
                                                        short initialCapacity,
                                                        boolean pooled,
                                                        int preallocationCount,
                                                        boolean threaded)

Construct a new Factory for XPooledStrings.

Parameters:

name - A name unique to this factory type which is used to uniquely identify the underlying pool.

initialCapacity - The initial capacity of the created string's backing storage

pooled - Whether or not to back the factory with a pool.

preallocationCount - The number of XPooledString to preallocate.

threaded - Whether or not the backing pool should be thread safe.

Returns:

A new Factory.

newFactory

public static IXStringFactory<XPooledString> newFactory(String name,
                                                        Map<String,Object> props)

Construct a new Factory for XPooledStrings.

See IXStringFactory for a listing of property names.

Parameters:

name - A name unique to this factory type which is used to uniquely identify the underlying pool.

props - Properties used to configure the Factory.

Returns:

A new Factory.

create

public static final XPooledString create()

Create a new, mutable, uninitialized XPooledString using this type's default IXStringFactory.

Returns:

a new, uninitialized XPooledString.

create

public static final XPooledString create(boolean mutable)

Create a new, uninitialized XPooledString using this type's default IXStringFactory.

Parameters:

mutable - Whether the returned XPooledString is mutable

Returns:

a new, uninitialized XPooledString.

create

public static final XPooledString create(String initialValue,
                                         boolean mutable)

Create a new XPooledString initialized to the given value using this type's default IXStringFactory.

This method does not preallocate the backing buffer. The caller may call #getBackingBuffer() on the returned string to create the backing buffer based on the lenght of the initial value.

Parameters:

mutable - Whether the returned XPooledString is mutable

initialValue - the initial String value for the new XPooledString.

Returns:

a new SocialSecurityNumber initialized to the given value

create

public static final XPooledString create(XString initialValue,
                                         boolean mutable)

Create a new XPooledString initialized to the given value using this type's default IXStringFactory.

Parameters:

mutable - Whether the returned XPooledString is mutable

initialValue - the initial String value for the new XPooledString.

Returns:

a new SocialSecurityNumber initialized to the given value