32 #ifndef _QORE_QOREVALUELIST_H
34 #define _QORE_QOREVALUELIST_H
36 #include <qore/AbstractQoreNode.h>
46 friend struct qore_value_list_private;
53 DLLLOCAL QoreValueList& operator=(
const QoreValueList&);
59 struct qore_value_list_private *
priv;
103 DLLEXPORT QoreValueList();
200 DLLEXPORT
void push(QoreValue val);
201 DLLEXPORT
void insert(QoreValue val);
206 DLLEXPORT QoreValue
pop();
212 DLLEXPORT QoreValue
shift();
215 DLLEXPORT
void merge(
const QoreValueList* list);
245 DLLEXPORT QoreValueList*
copy()
const;
251 DLLEXPORT QoreValueList*
copyListFrom(
size_t index)
const;
361 DLLEXPORT QoreValueList*
splice(ptrdiff_t offset, ptrdiff_t length,
const QoreValue l,
ExceptionSink* xsink);
390 DLLEXPORT QoreValueList*
extract(ptrdiff_t offset, ptrdiff_t length,
const QoreValue l,
ExceptionSink* xsink);
395 DLLEXPORT
size_t size()
const;
400 DLLEXPORT
bool empty()
const;
403 DLLEXPORT QoreValueList*
reverse()
const;
409 DLLEXPORT QoreValue
swap(ptrdiff_t offset, QoreValue val);
412 DLLEXPORT QoreValue
takeExists(ptrdiff_t offset);
415 #include <qore/ReferenceHolder.h>
449 DLLLOCAL
void *
operator new(size_t);
470 DLLEXPORT
bool next();
479 DLLEXPORT
bool prev();
487 DLLEXPORT
int set(
size_t n_pos);
490 DLLEXPORT QoreValue
getValue()
const;
499 DLLEXPORT
bool first()
const;
502 DLLEXPORT
bool last()
const;
507 DLLLOCAL
size_t index()
const {
return pos; }
510 DLLLOCAL
size_t max()
const {
return l->
size(); }
522 return pos == -1 ?
false :
true;
570 DLLEXPORT
bool next();
579 DLLEXPORT
bool prev();
587 DLLEXPORT
int set(
size_t n_pos);
590 DLLEXPORT
const QoreValue
getValue()
const;
596 DLLEXPORT
bool first()
const;
599 DLLEXPORT
bool last()
const;
602 DLLLOCAL
size_t index()
const {
return pos; }
605 DLLLOCAL
size_t max()
const {
return l->
size(); }
617 return pos == -1 ?
false :
true;
621 DLLEXPORT
void reset();
631 DLLLOCAL
void discard_intern() {
632 if (needs_deref && val)
638 val = exp->
evalList(needs_deref, xsink);
648 DLLLOCAL QoreValueListEvalOptionalRefHolder& operator=(
const QoreValueListEvalOptionalRefHolder&);
650 DLLLOCAL
void *
operator new(size_t);
685 needs_deref = n_needs_deref;
713 else if (!needs_deref || !val->
is_unique()) {
730 DLLLOCAL
operator bool()
const {
return val != 0; }
DLLEXPORT bool first() const
returns true when the iterator is pointing to the first element in the list
DLLEXPORT bool prev()
moves the iterator to the previous element, returns true if the iterator is pointing to an element of...
DLLEXPORT QoreValue swap(ptrdiff_t offset, QoreValue val)
swaps the value at the given position with the value given, caller owns any reference returned ...
DLLLOCAL void edit()
will create a unique list so the list can be edited
Definition: QoreValueList.h:708
DLLEXPORT ValueListIterator(QoreValueList *lst, size_t n_pos=-1)
initializes the iterator to the position given or, if omitted, just before the first element ...
For use on the stack only: iterates through a the elements of a QoreValueList.
Definition: QoreValueList.h:443
DLLEXPORT bool first() const
returns true when the iterator is pointing to the first element in the list
DLLEXPORT QoreValueList * evalList(ExceptionSink *xsink) const
evaluates the list and returns a value (or 0)
DLLLOCAL QoreValueList * getList()
returns the list
Definition: QoreValueList.h:513
DLLEXPORT const QoreValue getValue() const
returns a pointer to the value of the list element
DLLEXPORT int set(size_t n_pos)
sets the iterator to a specific position in the list
DLLEXPORT int set(size_t n_pos)
sets the iterator to a specific position in the list
DLLLOCAL bool empty() const
returns true if the list is empty
Definition: QoreValueList.h:611
DLLEXPORT QoreValue takeExists(ptrdiff_t offset)
takes the value at the given position and replaces with NULL, only if the list position exists ...
This is the list container type in Qore, dynamically allocated only, reference counted.
Definition: QoreValueList.h:45
DLLLOCAL size_t index() const
returns the current iterator position in the list or -1 if not pointing at a valid element ...
Definition: QoreValueList.h:507
The base class for all value and parse types in Qore expression trees.
Definition: AbstractQoreNode.h:55
DLLLOCAL bool valid() const
returns true if the iterator is pointing to a valid element
Definition: QoreValueList.h:521
DLLEXPORT QoreValue getValue() const
returns a pointer to the value of the list element
virtual DLLEXPORT bool is_equal_soft(const AbstractQoreNode *v, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) with possible type conversion (sof...
For use on the stack only: manages result of the optional evaluation of a QoreValueList.
Definition: QoreValueList.h:625
DLLEXPORT QoreValueList * splice(ptrdiff_t offset, ExceptionSink *xsink)
truncates the list at position "offset" (first element is offset 0)
DLLLOCAL ~QoreValueListEvalOptionalRefHolder()
clears the object (dereferences the old object if necessary)
Definition: QoreValueList.h:665
virtual DLLEXPORT AbstractQoreNode * realCopy() const
returns true if the list contains parse expressions and therefore needs evaluation to return a value...
DLLEXPORT ConstValueListIterator(const QoreValueList *lst, size_t n_pos=-1)
initializes the iterator to the position given or, if omitted, just before the first element ...
DLLEXPORT bool last() const
returns true when the iterator is pointing to the last element in the list
DLLLOCAL const QoreValueList * getList() const
returns the list
Definition: QoreValueList.h:608
DLLLOCAL QoreValueListEvalOptionalRefHolder(const QoreValueList *exp, ExceptionSink *n_xsink)
performs an optional evaluation of the list (sets the dereference flag)
Definition: QoreValueList.h:660
virtual DLLLOCAL bool boolEvalImpl(ExceptionSink *xsink) const
always returns false
virtual DLLLOCAL int64 bigIntEvalImpl(ExceptionSink *xsink) const
always returns 0
DLLEXPORT QoreValue * getExistingEntryPtr(size_t index)
Qore's string type supported by the QoreEncoding class.
Definition: QoreString.h:50
DLLEXPORT QoreValue shift()
returns the first element of the list, all other entries are moved down to fill up the first position...
virtual DLLEXPORT bool getAsBoolImpl() const
returns false unless perl-boolean-evaluation is enabled, in which case it returns false only when emp...
DLLLOCAL bool needsDeref() const
returns true if the object contains a temporary (evaluated) value that needs a dereference ...
Definition: QoreValueList.h:690
struct qore_value_list_private * priv
this structure holds the private implementation for the type
Definition: QoreValueList.h:59
DLLEXPORT void setEntry(size_t index, QoreValue val, ExceptionSink *xsink)
sets the value of a list element
DLLEXPORT bool prev()
moves the iterator to the previous element, returns true if the iterator is pointing to an element of...
DLLEXPORT QoreValueList * sortDescending(ExceptionSink *xsink) const
returns a new list based on quicksorting the source list ("this") in descending order ...
DLLEXPORT QoreValueList * copyListFrom(size_t index) const
performs a deep copy of the list starting from element "offset" and returns the new list ...
DLLEXPORT QoreValue getReferencedEntry(size_t index) const
returns the element at "index" (first element is index 0), the caller owns the reference ...
virtual DLLEXPORT bool is_equal_hard(const AbstractQoreNode *v, ExceptionSink *xsink) const
tests for equality ("deep compare" including all contained values) without type conversions (hard com...
DLLEXPORT QoreValueList * sort(ExceptionSink *xsink) const
returns a new list based on quicksorting the source list ("this")
DLLLOCAL bool empty() const
returns true if the list is empty
Definition: QoreValueList.h:516
DLLEXPORT int getAsString(QoreString &str, int foff, ExceptionSink *xsink) const
concatenate the verbose string representation of the list (including all contained values) to an exis...
DLLEXPORT bool empty() const
returns true if the list is empty
static DLLLOCAL const char * getStaticTypeName()
returns true if the list does not contain any parse expressions, otherwise returns false ...
Definition: QoreValueList.h:155
DLLLOCAL size_t index() const
returns the current iterator position in the list or -1 if not pointing at a valid element ...
Definition: QoreValueList.h:602
DLLEXPORT QoreValue minValue(ExceptionSink *xsink) const
returns the element having the lowest value (determined by calling OP_LOG_LT - the less-than "<" oper...
DLLEXPORT QoreValue maxValue(ExceptionSink *xsink) const
returns the element having the highest value (determined by calling OP_LOG_GT - the greater-than ">" ...
DLLEXPORT QoreValueList * listRefSelf() const
returns "this" with an incremented reference count
DLLLOCAL const QoreValueList * operator*() const
returns a pointer to the QoreValueList object being managed
Definition: QoreValueList.h:727
virtual DLLLOCAL double floatEvalImpl(ExceptionSink *xsink) const
always returns 0.0
DLLEXPORT void ref() const
increments the reference count
For use on the stack only: iterates through elements of a const QoreValueList.
Definition: QoreValueList.h:546
DLLLOCAL QoreValueList * getReferencedValue()
returns a referenced value - the caller will own the reference
Definition: QoreValueList.h:699
DLLEXPORT QoreValueList * reverse() const
returns a list with the order of the elements reversed
container for holding Qore-language exception information and also for registering a "thread_exit" ca...
Definition: ExceptionSink.h:43
DLLEXPORT QoreValueList * copy() const
performs a deep copy of the list and returns the new list
DLLLOCAL bool valid() const
returns true if the iterator is pointing to a valid element
Definition: QoreValueList.h:616
virtual DLLEXPORT const char * getTypeName() const
returns the type name as a c string
DLLEXPORT void merge(const QoreValueList *list)
appends the elements of "list" to this list
DLLEXPORT void deref(ExceptionSink *xsink)
decrements the reference count and calls derefImpl() if there_can_be_only_one is false, otherwise does nothing
virtual DLLEXPORT ~QoreValueList()
the destructor is protected so it cannot be called directly
long long int64
64bit integer type, cannot use int64_t here since it breaks the API on some 64-bit systems due to equ...
Definition: common.h:225
DLLLOCAL void assign(bool n_needs_deref, QoreValueList *n_val)
assigns a new value and dereference flag to this object, dereferences the old object if necessary ...
Definition: QoreValueList.h:683
DLLEXPORT QoreValueList * extract(ptrdiff_t offset, ExceptionSink *xsink)
truncates the list at position "offset" (first element is offset 0) and returns any elements removed ...
DLLEXPORT QoreValue getReferencedValue() const
returns the current value with an incremented reference count
DLLEXPORT size_t size() const
returns the number of elements in the list
DLLLOCAL bool is_unique() const
returns true if the reference count is 1
Definition: QoreReferenceCounter.h:69
virtual DLLEXPORT AbstractQoreNode * evalImpl(ExceptionSink *xsink) const
evaluates the list and returns a value (or 0)
base class for resolved call references
Definition: CallReferenceNode.h:130
DLLEXPORT QoreValue * getValueReference() const
returns a pointer to a pointer of the value of the list element, so it can be changed externally ...
DLLEXPORT QoreValue retrieveEntry(size_t index)
returns the element at "index" (first element is index 0)
DLLLOCAL QoreValueListEvalOptionalRefHolder(ExceptionSink *n_xsink)
initializes an empty object and saves the ExceptionSink object
Definition: QoreValueList.h:654
DLLLOCAL void discard()
clears the object (dereferences the old object if necessary)
Definition: QoreValueList.h:670
DLLEXPORT void reset()
resets the iterator to its initial state
virtual DLLEXPORT bool derefImpl(ExceptionSink *xsink)
dereferences all elements of the list
DLLEXPORT bool last() const
returns true when the iterator is pointing to the last element in the list
DLLEXPORT QoreValueList * sortDescendingStable(ExceptionSink *xsink) const
returns a new list based on executing mergesort on the source list ("this") in descending order ...
DLLEXPORT QoreValue & getEntryReference(size_t index)
DLLLOCAL size_t max() const
returns the number of elements in the list
Definition: QoreValueList.h:510
DLLLOCAL const QoreValueList * operator->() const
returns a pointer to the QoreValueList object being managed
Definition: QoreValueList.h:724
DLLEXPORT QoreValue getReferencedValue() const
returns the current value with an incremented reference count
DLLEXPORT bool next()
moves the iterator to the next element, returns true if the iterator is pointing to an element of the...
DLLLOCAL size_t max() const
returns the number of elements in the list
Definition: QoreValueList.h:605
DLLEXPORT bool next()
moves the iterator to the next element, returns true if the iterator is pointing to an element of the...
virtual DLLLOCAL int integerEvalImpl(ExceptionSink *xsink) const
always returns 0
DLLLOCAL void assignEval(const QoreValueList *exp)
assigns a new value by executing the given list and dereference flag to this object, dereferences the old object if necessary
Definition: QoreValueList.h:677
a templated class to manage a reference count of an object that can throw a Qore-language exception w...
Definition: ReferenceHolder.h:51
DLLEXPORT QoreValue pop()
returns the last element of the list, the length is decremented by one, caller owns the reference ...
DLLEXPORT QoreValueList * sortStable(ExceptionSink *xsink) const
returns a new list based on executing mergesort on the source list ("this")