Package coneforest.psylla.core

Interface PsyFormalArray<T extends PsyObject>

Type Parameters:

T - a type of contained objects.

All Superinterfaces:

Iterable<T>, PsyAppendable<T>, PsyClearable, PsyContainer<T>, PsyConvertableToName, PsyConvertableToString, PsyIndexed<PsyInteger,T>, PsyIterable<T>, PsyLengthy, PsyObject, PsySequential<T>, PsyStreamable<T>

All Known Implementing Classes:

PsyArray, PsyBitArray, PsyProc, PsyString

public interface PsyFormalArray<T extends PsyObject>
extends PsyAppendable<T>, PsyContainer<T>, PsyIndexed<PsyInteger,T>, PsySequential<T>

A representation of Ψ-formalarray, an abstraction of an array composed of Ψ-objects.

Field Summary

Fields

Modifier and Type	Field	Description
static PsyOperator[]	OPERATORS

Method Summary

Modifier and Type	Method	Description
void	delete(int index)
T	extract(int index)
T	get(int index)
void	insert(int index, T o)	Inserts the specified Ψ-object into this array at the position specified by a given index.
PsyFormalArray<T>	psyClone()	Returns a clone of this object.
default void	psyDelete(PsyInteger oIndex)	Deletes a key or index and a value associated with it from this object.
default PsyFormalStream<PsyObject>	psyEntries()	Returns a Ψ-iterable enumeration of all the keys and values of this object.
default T	psyExtract(PsyInteger oIndex)
PsyFormalArray<T>	psyExtractInterval(PsyInteger oIndex, PsyInteger oCount)
default T	psyGet(PsyInteger oIndex)	Returns the element with given key or index.
default PsyFormalArray<T>	psyGetAll(PsyIterable<PsyInteger> oIndices)
PsyFormalArray<T>	psyGetInterval(PsyInteger oIndex, PsyInteger oLength)
default void	psyInsert(PsyInteger oIndex, T o)	Inserts the specified Ψ-object into this array at the position specified by a given Ψ-integer index.
default void	psyInsertAll(PsyInteger oIndex, PsyIterable<? extends T> oEnumeration)
default PsyStream	psyKeys()	Returns a Ψ-iterable enumeration of all the keys of this object.
default PsyBoolean	psyKnown(PsyInteger oIndex)	Returns a Ψ-boolean indicating whether given key or index exists in this object.
default T	psyPostChop()
default T	psyPreChop()
default void	psyPrepend(T o)	Inserts the specified Ψ-object into this array at the beginning.
default void	psyPrependAll(PsyIterable<? extends T> oEnumeration)
default void	psyPut(PsyInteger oIndex, T o)	Stores an element with given key or index.
default void	psyPutInterval(PsyInteger oIndex, PsyIterable<? extends T> oEnumeration)
default PsyFormalArray<T>	psyReplicate(PsyInteger oCount)
default PsyFormalArray<T>	psyReverse()
void	psySetLength(PsyInteger oLength)
PsyFormalArray<T>	psySlice(PsyIterable<PsyInteger> oIndices)	Returns a container of the same type as this object consisting of keys or indices from given Ψ-iterable and of associated values.
default PsyFormalStream<T>	psyValues()	Returns a Ψ-iterable enumeration of all the values of this object.
void	put(int index, T o)
default String	toSyntaxString()
default String	toSyntaxStringHelper(Set<PsyContainer<T>> processed)

Methods inherited from interface java.lang.Iterable

forEach, iterator, spliterator

Methods inherited from interface coneforest.psylla.core.PsyAppendable

psyAppend, psyAppendAll

Methods inherited from interface coneforest.psylla.core.PsyClearable

psyClear

Methods inherited from interface coneforest.psylla.core.PsyContainer

psyNewEmpty

Methods inherited from interface coneforest.psylla.core.PsyIterable

psyStream, psyToArray, psyUnite

Methods inherited from interface coneforest.psylla.core.PsyLengthy

isEmpty, length, psyIsEmpty, psyLength

Methods inherited from interface coneforest.psylla.core.PsyObject

convert, execute, invoke, psyEq, psyHashCode, psyInstanceOf, psyNe, psySyntax, psyToName, psyToString, psyType, typeName

Methods inherited from interface coneforest.psylla.core.PsyStreamable

psyForAll

Field Detail

OPERATORS

static final PsyOperator[] OPERATORS

Method Detail

psyClone

PsyFormalArray<T> psyClone()

Description copied from interface: PsyObject

Returns a clone of this object.

Specified by:

psyClone in interface PsyObject

Returns:

a clone of this object.

psyReverse

default PsyFormalArray<T> psyReverse()
                              throws PsyException

Throws:

PsyException

psyKnown

default PsyBoolean psyKnown(PsyInteger oIndex)

Description copied from interface: PsyIndexed

Returns a Ψ-boolean indicating whether given key or index exists in this object.

Specified by:

psyKnown in interface PsyIndexed<PsyInteger,T extends PsyObject>

Parameters:

oIndex - a key or an index.

Returns:

a result.

get

T get(int index)
throws PsyException

Throws:

PsyException

psyGet

default T psyGet(PsyInteger oIndex)
          throws PsyException

Description copied from interface: PsyIndexed

Returns the element with given key or index.

Specified by:

psyGet in interface PsyIndexed<PsyInteger,T extends PsyObject>

Parameters:

oIndex - a key or an index.

Returns:

an element.

Throws:

PsyException - when index is out of range.

psyGetInterval

PsyFormalArray<T> psyGetInterval(PsyInteger oIndex,
                                 PsyInteger oLength)
                          throws PsyException

Throws:

PsyException

put

void put(int index,
         T o)
  throws PsyException

Throws:

PsyException

psyPut

default void psyPut(PsyInteger oIndex,
                    T o)
             throws PsyException

Description copied from interface: PsyIndexed

Stores an element with given key or index. In PsyFormalArray containers replaces existing element. In PsyFormalDict containers replaces an old or creates a new element associated with specified key.

Specified by:

psyPut in interface PsyIndexed<PsyInteger,T extends PsyObject>

Parameters:

oIndex - a key or an index.

o - an element to be stored.

Throws:

PsyException - when key is absent or index is out of range.

insert

void insert(int index,
            T o)
     throws PsyException

Inserts the specified Ψ-object into this array at the position specified by a given index.

Parameters:

index - a Ψ-integer index.

o - a Ψ-object.

Throws:

PsyException - when an error occurs.

psyInsert

default void psyInsert(PsyInteger oIndex,
                       T o)
                throws PsyException

Inserts the specified Ψ-object into this array at the position specified by a given Ψ-integer index.

Parameters:

oIndex - a Ψ-integer index.

o - a Ψ-object.

Throws:

PsyException - when an error occurs.

psyInsertAll

default void psyInsertAll(PsyInteger oIndex,
                          PsyIterable<? extends T> oEnumeration)
                   throws PsyException

Throws:

PsyException

psyPrepend

default void psyPrepend(T o)
                 throws PsyException

Inserts the specified Ψ-object into this array at the beginning.

Parameters:

o - a Ψ-object.

Throws:

PsyException - when an error occurs.

psyPreChop

default T psyPreChop()
              throws PsyException

Throws:

PsyException

psyPostChop

default T psyPostChop()
               throws PsyException

Throws:

PsyException

psyPrependAll

default void psyPrependAll(PsyIterable<? extends T> oEnumeration)
                    throws PsyException

Throws:

PsyException

psyReplicate

default PsyFormalArray<T> psyReplicate(PsyInteger oCount)
                                throws PsyException

Specified by:

psyReplicate in interface PsyAppendable<T extends PsyObject>

Throws:

PsyException

psyPutInterval

default void psyPutInterval(PsyInteger oIndex,
                            PsyIterable<? extends T> oEnumeration)
                     throws PsyException

Throws:

PsyException

psyDelete

default void psyDelete(PsyInteger oIndex)
                throws PsyException

Description copied from interface: PsyIndexed

Deletes a key or index and a value associated with it from this object.

Specified by:

psyDelete in interface PsyIndexed<PsyInteger,T extends PsyObject>

Parameters:

oIndex - a key or an index.

Throws:

PsyException - when key is absent or index is out of range.

delete

void delete(int index)
     throws PsyException

Throws:

PsyException

psyExtract

default T psyExtract(PsyInteger oIndex)
              throws PsyException

Specified by:

psyExtract in interface PsyIndexed<PsyInteger,T extends PsyObject>

Throws:

PsyException

psyGetAll

default PsyFormalArray<T> psyGetAll(PsyIterable<PsyInteger> oIndices)
                             throws PsyException

Specified by:

psyGetAll in interface PsyIndexed<PsyInteger,T extends PsyObject>

Throws:

PsyException

psySetLength

void psySetLength(PsyInteger oLength)
           throws PsyException

Throws:

PsyException

extract

T extract(int index)
   throws PsyException

Throws:

PsyException

psyExtractInterval

PsyFormalArray<T> psyExtractInterval(PsyInteger oIndex,
                                     PsyInteger oCount)
                              throws PsyException

Throws:

PsyException

psySlice

PsyFormalArray<T> psySlice(PsyIterable<PsyInteger> oIndices)
                    throws PsyException

Description copied from interface: PsyIndexed

Returns a container of the same type as this object consisting of keys or indices from given Ψ-iterable and of associated values.

Specified by:

psySlice in interface PsyIndexed<PsyInteger,T extends PsyObject>

Parameters:

oIndices - an enumeration of keys.

Returns:

a container.

Throws:

PsyException - when key is absent or index is out of range.

psyKeys

default PsyStream psyKeys()

Description copied from interface: PsyIndexed

Returns a Ψ-iterable enumeration of all the keys of this object.

Specified by:

psyKeys in interface PsyIndexed<PsyInteger,T extends PsyObject>

Returns:

an enumeration of keys.

psyValues

default PsyFormalStream<T> psyValues()

Description copied from interface: PsyIndexed

Returns a Ψ-iterable enumeration of all the values of this object.

Specified by:

psyValues in interface PsyIndexed<PsyInteger,T extends PsyObject>

Returns:

an enumeration of values.

psyEntries

default PsyFormalStream<PsyObject> psyEntries()

Description copied from interface: PsyIndexed

Returns a Ψ-iterable enumeration of all the keys and values of this object.

Specified by:

psyEntries in interface PsyIndexed<PsyInteger,T extends PsyObject>

Returns:

an enumeration of entries.

toSyntaxString

default String toSyntaxString()

Specified by:

toSyntaxString in interface PsyObject

toSyntaxStringHelper

default String toSyntaxStringHelper(Set<PsyContainer<T>> processed)

Specified by:

toSyntaxStringHelper in interface PsyContainer<T extends PsyObject>