Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QScriptValueIterator Class Reference
^{[ QtScript module]}

The QScriptValueIterator class provides a Java-style iterator for QScriptValue. Далее...

 #include <QScriptValueIterator>

Класс был добавлен в Qt 4.3.

• Список всех членов, включая унаследованные

[править] Открытые функции

• QScriptValueIterator ( const QScriptValue & object )
• ~QScriptValueIterator ()
• QScriptValue::PropertyFlags flags () const
• bool hasNext () const
• bool hasPrevious () const
• QString name () const
• void next ()
• void previous ()
• void remove ()
• void setValue ( const QScriptValue & value )
• void toBack ()
• void toFront ()
• QScriptValue value () const
• QScriptValueIterator & operator= ( QScriptValue & object )

[править] Подробное описание

The QScriptValueIterator class provides a Java-style iterator for QScriptValue.

The QScriptValueIterator constructor takes a QScriptValue as argument. After construction, the iterator is located at the very beginning of the sequence of properties. Here's how to iterate over all the properties of a QScriptValue:

 QScriptValue object;
 ...
 QScriptValueIterator it(object);
 while (it.hasNext()) {
   it.next();
   qDebug() << it.name() << ": " << it.value().toString();
 }

The next() advances the iterator. The name(), value() and flags() functions return the name, value and flags of the last item that was jumped over.

If you want to remove properties as you iterate over the QScriptValue, use remove(). If you want to modify the value of a property, use setValue().

Note that QScriptValueIterator only iterates over the QScriptValue's own properties; i.e. it does not follow the prototype chain.

Note that QScriptValueIterator will not automatically skip over properties that have the QScriptValue::SkipInEnumeration flag set; that flag only affects iteration in script code. If you want, you can skip over such properties with code like the following:

 while (it.hasNext()) {
   it.next();
   if (it.flags() & QScriptValue::SkipInEnumeration)
       continue;
   qDebug() << "found enumerated property:" << it.name();
 }

See also QScriptValue::property().

[править] Описание функций-членов

[править]

QScriptValueIterator::QScriptValueIterator ( const QScriptValue & object )

Constructs an iterator for traversing object. The iterator is set to be at the front of the sequence of properties (before the first property).

[править]

QScriptValueIterator::~QScriptValueIterator ()

Destroys the iterator.

[править]

QScriptValue::PropertyFlags QScriptValueIterator::flags () const

Returns the flags of the last property that was jumped over using next() or previous().

Смотрите также value().

[править]

bool QScriptValueIterator::hasNext () const

Returns true if there is at least one item ahead of the iterator (i.e. the iterator is not at the back of the property sequence); otherwise returns false.

See also next() and hasPrevious().

[править]

bool QScriptValueIterator::hasPrevious () const

Returns true if there is at least one item behind the iterator (i.e. the iterator is not at the front of the property sequence); otherwise returns false.

See also previous() and hasNext().

[править]

QString QScriptValueIterator::name () const

Returns the name of the last property that was jumped over using next() or previous().

See also value() and flags().

[править]

void QScriptValueIterator::next ()

Advances the iterator by one position.

See also hasNext(), previous(), and name().

[править]

void QScriptValueIterator::previous ()

Moves the iterator back by one position.

See also hasPrevious(), next(), and name().

[править]

void QScriptValueIterator::remove ()

Removes the last property that was jumped over using next() or previous().

Смотрите также setValue().

[править]

void QScriptValueIterator::setValue ( const QScriptValue & value )

Sets the value of the last property that was jumped over using next() or previous().

See also value() and name().

[править]

void QScriptValueIterator::toBack ()

Moves the iterator to the back of the QScriptValue (after the last property).

See also toFront() and previous().

[править]

void QScriptValueIterator::toFront ()

Moves the iterator to the front of the QScriptValue (before the first property).

See also toBack() and next().

[править]

QScriptValue QScriptValueIterator::value () const

Returns the value of the last property that was jumped over using next() or previous().

See also setValue() and name().

[править]

QScriptValueIterator & QScriptValueIterator::operator= ( QScriptValue & object )

Makes the iterator operate on object. The iterator is set to be at the front of the sequence of properties (before the first property).