Package org.basex.query.value.seq

Class ItemSeq

java.lang.Object

org.basex.query.expr.ExprInfo

org.basex.query.expr.Expr

org.basex.query.value.Value

org.basex.query.value.seq.Seq

org.basex.query.value.seq.ItemSeq

All Implemented Interfaces:

Iterable<Item>

public final class ItemSeq
extends Seq

Flat item sequence.

Author:

BaseX Team 2005-21, BSD License, Christian Gruen

Field Summary

Fields inherited from class org.basex.query.value.seq.Seq

size

Fields inherited from class org.basex.query.value.Value

type

Method Summary

Modifier and Type	Method	Description
long	atomSize()	Computes the number of atomized items.
Value	atomValue(QueryContext qc, InputInfo ii)	Evaluates the expression and returns the atomized items.
void	cache(boolean lazy, InputInfo ii)	Caches lazy values.
Item	ebv(QueryContext qc, InputInfo ii)	Checks if the effective boolean value can be computed for this expression:
boolean	equals(Object obj)	This function is e.g.
static Value	get(Item[] values, int size, Expr expr)	Creates a typed sequence with the items of the specified values.
static Value	get(Item[] values, int size, Type type)	Creates a typed sequence with the items of the specified values.
Value	insert(long pos, Item item, QueryContext qc)	Inserts an item at the given position into this sequence and returns the resulting sequence.
Item	itemAt(long pos)	Returns the item at the given position in the value.
Value	remove(long pos, QueryContext qc)	Removes the item at the given position in this sequence and returns the resulting sequence.
Value	reverse(QueryContext qc)	Returns all items of this value in reverse order.

Methods inherited from class org.basex.query.value.seq.Seq

copyInsert, ddo, description, get, hash, initialCapacity, insertBefore, item, iter, plan, plan, refineType, seqType, size, subSeq, subsequence, test, toErrorString, toJava

Methods inherited from class org.basex.query.value.Value

accept, checkUp, compile, copy, count, exprSize, has, inline, inlineable, isEmpty, isItem, iter, iterator, materialize, serialize, serialize, serialize, value

Methods inherited from class org.basex.query.expr.Expr

arg, args, atomItem, atomIter, data, data, funcType, hasFreeVars, indexAccessible, isSimple, markTailCalls, mergeEbv, optimize, simplifyFor, typeCheck, uses, vacuous, visitAll

Methods inherited from class org.basex.query.expr.ExprInfo

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Details

ebv

public Item ebv(QueryContext qc,
 InputInfo ii)
         throws QueryException

Description copied from class: Expr

Checks if the effective boolean value can be computed for this expression:

• If it yields an empty sequence, Bln.FALSE will be returned.
• If it yields a single item, this item will be returned.
• If it yields nodes, the first node will be returned.
• Otherwise, an error will be raised.

A single numeric item may later be evaluated as positional predicate.

Specified by:

ebv in class Expr

Parameters:

qc - query context

ii - input info (required for Seq instances, which have no input info)

Returns:

item

Throws:

QueryException - query exception

itemAt

public Item itemAt(long pos)

Description copied from class: Value

Returns the item at the given position in the value. The specified value must be lie within the valid bounds.

Specified by:

itemAt in class Value

Parameters:

pos - position

Returns:

item

atomValue

public Value atomValue(QueryContext qc,
 InputInfo ii)
                throws QueryException

Description copied from class: Expr

Evaluates the expression and returns the atomized items.

Specified by:

atomValue in class Expr

Parameters:

qc - query context

ii - input info (only required by Seq instances, which have no input info)

Returns:

atomized item

Throws:

QueryException - query exception

reverse

public Value reverse(QueryContext qc)

Description copied from class: Value

Returns all items of this value in reverse order.

Specified by:

reverse in class Value

Parameters:

qc - query context

Returns:

items in reverse order

equals

public boolean equals(Object obj)

Description copied from class: Expr

This function is e.g. called by:

• If.optimize(CompileContext), Switch.optimize(CompileContext), Typeswitch.optimize(CompileContext), in order to discard identical expressions.
• CmpR.mergeEbv(Expr, boolean, CompileContext) or CmpSR.mergeEbv(Expr, boolean, CompileContext), in order to merge expressions with identical input.
• CmpG.optimize(CompileContext) or CmpV.optimize(CompileContext), in order to pre-evaluate equality tests.
• CmpG.optimize(CompileContext) or Pos.get(Expr, CmpV.OpV, InputInfo, CompileContext), in order to compare the start and end value.
• PathCache, in order to find identical root values at runtime.

Overrides:

equals in class Seq

insert

public Value insert(long pos,
 Item item,
 QueryContext qc)

Description copied from class: Seq

Inserts an item at the given position into this sequence and returns the resulting sequence.

Specified by:

insert in class Seq

Parameters:

pos - position at which the item should be inserted, must be between 0 and Seq.size

item - item to insert

qc - query context

Returns:

resulting value

remove

public Value remove(long pos,
 QueryContext qc)

Description copied from class: Seq

Removes the item at the given position in this sequence and returns the resulting sequence.

Specified by:

remove in class Seq

Parameters:

pos - position of the item to remove, must be between 0 and Seq.size - 1

qc - query context

Returns:

resulting sequence

cache

public void cache(boolean lazy,
 InputInfo ii)
           throws QueryException

Description copied from class: Value

Caches lazy values.

Specified by:

cache in class Value

Parameters:

lazy - lazy caching

ii - input info

Throws:

QueryException - query exception

atomSize

public long atomSize()

Description copied from class: Value

Computes the number of atomized items.

Specified by:

atomSize in class Value

Returns:

atomized item

get

public static Value get(Item[] values,
 int size,
 Type type)

Creates a typed sequence with the items of the specified values.

Parameters:

size - size of resulting sequence

values - values

type - type (can be null, only considered if new sequence is created)

Returns:

value

get

public static Value get(Item[] values,
 int size,
 Expr expr)

Creates a typed sequence with the items of the specified values.

Parameters:

size - size of resulting sequence

values - values

expr - expression (can be null, only considered if new sequence is created)

Returns:

value