QMetaSequence Class

メンバ関数ドキュメント

void QMetaSequence::addValue(void *container, const void *value) const

可能であれば、container にvalue を追加する。canAddValue() がfalse を返す場合、value は追加されない。canAddValueAtEnd() がtrue を返す場合、value はcontainer の最後に追加される。canAddValueAtBegin() がtrue を返す場合、value はコンテナの最初に追加される。それ以外の場合、値は指定されていない場所に追加されるか、まったく追加されない。後者は、例えばQSet のように、順序のないコンテナに値を追加する場合である。

canAddValue()、canAddValueAtBegin()、canAddValueAtEnd()、isSortable()、removeValue()も参照のこと 。

void QMetaSequence::addValueAtBegin(void *container, const void *value) const

container の先頭にvalue を追加する。canAddValueAtBegin() がfalse を返す場合、value は追加されない。

canAddValueAtBegin()、isSortable()、removeValueAtBegin()も参照 。

void QMetaSequence::addValueAtEnd(void *container, const void *value) const

可能であれば、container の最後にvalue を追加する。canAddValueAtEnd() がfalse を返す場合、value は追加されない。

canAddValueAtEnd()、isSortable()、removeValueAtEnd()も参照 。

bool QMetaSequence::canAddValue() const

コンテナに値を追加できる場合はtrue を、そうでない場合はfalse を返す。

addValue() およびisSortable()も参照 。

bool QMetaSequence::canAddValueAtBegin() const

addValue() を使って追加された値がコンテナの先頭に配置できる場合はtrue を返し、そうでない場合はfalse を返す。

addValueAtBegin() およびcanAddValueAtEnd()も参照 。

bool QMetaSequence::canAddValueAtEnd() const

addValue() を使って追加された値がコンテナの最後に配置できる場合はtrue を返し、そうでない場合はfalse を返す。

addValueAtEnd() およびcanAddValueAtBegin()も参照 。

bool QMetaSequence::canEraseRangeAtIterator() const

2つのイテレータ間の範囲をコンテナから消去できる場合はtrue を返し、そうでない場合はfalse を返す。

bool QMetaSequence::canEraseValueAtIterator() const

constでないイテレータが指す値が消去可能であればtrue を返し、そうでなければfalse を返す。

hasIterator() およびeraseValueAtIterator()も参照のこと 。

bool QMetaSequence::canGetValueAtConstIterator() const

基礎となるコンテナが const イテレータが指す値を取得できる場合はtrue を返し、そうでない場合はfalse を返す。

hasConstIterator() およびvalueAtConstIterator()も参照 。

bool QMetaSequence::canGetValueAtIndex() const

インデックスによってコンテナから値を取得できる場合はtrue を返し、そうでない場合はfalse を返す。

valueAtIndex()も参照のこと 。

bool QMetaSequence::canGetValueAtIterator() const

基礎となるコンテナが、const 以外のイテレータが指す値を取得できる場合はtrue を返し、そうでない場合はfalse を返す。

hasIterator() およびvalueAtIterator()も参照 。

bool QMetaSequence::canInsertValueAtIterator() const

基礎となるコンテナが、const 以外のイテレータが指す位置を考慮して新しい値を挿入できる場合、true を返す。

hasIterator() およびinsertValueAtIterator()も参照 。

bool QMetaSequence::canRemoveValue() const

コンテナから値を削除できる場合はtrue を返し、そうでない場合はfalse を返す。

removeValue() およびisSortable()も参照 。

bool QMetaSequence::canRemoveValueAtBegin() const

removeValue() を使ってコンテナの先頭から値を削除できる場合はtrue を返し、そうでない場合はfalse を返す。

removeValueAtBegin() およびcanRemoveValueAtEnd()も参照 。

bool QMetaSequence::canRemoveValueAtEnd() const

removeValue() を使ってコンテナの末尾から値を削除できる場合はtrue を返し、そうでない場合はfalse を返す。

removeValueAtEnd() およびcanRemoveValueAtBegin()も参照 。

bool QMetaSequence::canSetValueAtIndex() const

インデックスによってコンテナに値を書き込める場合はtrue を返し、そうでない場合はfalse を返す。

setValueAtIndex()も参照のこと 。

bool QMetaSequence::canSetValueAtIterator() const

基礎となるコンテナが、const 以外のイテレータが指す値に書き込める場合はtrue を返し、そうでない場合はfalse を返す。

hasIterator() およびsetValueAtIterator()も参照 。

void QMetaSequence::eraseRangeAtIterator(void *container, const void *iterator1, const void *iterator2) const

イテレータiterator1 とiterator2 の間の値の範囲を、可能であればcontainer から消去する。

canEraseValueAtIterator()、begin()、end()も参照 。

void QMetaSequence::eraseValueAtIterator(void *container, const void *iterator) const

nononstiterator が指す値を、可能であればcontainer から消去する。

canEraseValueAtIterator()、begin()、end()も参照のこと 。

[static constexpr, since 6.0] template <typename T> QMetaSequence QMetaSequence::fromContainer()

テンプレート・パラメータとして与えられた型に対応するQMetaSequence を返します。

この関数は Qt 6.0 で導入されました。

void QMetaSequence::insertValueAtIterator(void *container, const void *iterator, const void *value) const

container にvalue を挿入する。可能であれば、非構成のiterator を考慮する。canInsertValueAtIterator() がfalse を返す場合、value は挿入されない。isSortable() がtrue を返す場合、その値はiterator が指す値の前に挿入される。そうでない場合、value は指定されていない場所に挿入されるか、まったく挿入されない。後者の場合、iterator がヒントとなる。それがvalue の正しい場所を指している場合、イテレータのないaddValue() よりも高速に処理される可能性がある。

canInsertValueAtIterator()、isSortable()、begin()、end()も参照のこと 。

bool QMetaSequence::isSortable() const

基礎となるコンテナがソート可能であればtrue を返し、そうでなければfalse を返す。コンテナに追加された値が定義された場所に配置される場合、そのコンテナはソート可能であるとみなされる。ソート可能なコンテナへの挿入や追加は常に成功する。ソート不可能なコンテナへの挿入や追加は成功しないかもしれない。 例えば、コンテナがQSet 、挿入される値が既に含まれている場合などである。

addValue()、insertValueAtIterator()、canAddValueAtBegin()、canAddValueAtEnd()、canRemoveValueAtBegin()、canRemoveValueAtEnd()も参照のこと 。

void QMetaSequence::removeValue(void *container) const

可能であれば、container から値を削除する。canRemoveValue() がfalse を返す場合、値は削除されない。canRemoveValueAtEnd() がtrue を返す場合、container の最後の値が削除される。canRemoveValueAtBegin() がtrue を返す場合、container の最初の値が削除される。それ以外の場合は、指定されていない値または何も削除されない。

canRemoveValue()、canRemoveValueAtBegin()、canRemoveValueAtEnd()、isSortable()、addValue()も参照のこと 。

void QMetaSequence::removeValueAtBegin(void *container) const

可能であれば、container の先頭から値を削除する。canRemoveValueAtBegin() がfalse を返す場合、値は削除されない。

canRemoveValueAtBegin()、isSortable()、addValueAtBegin()も参照 。

void QMetaSequence::removeValueAtEnd(void *container) const

可能であれば、container の末尾から値を削除する。canRemoveValueAtEnd() がfalse を返す場合、値は削除されない。

canRemoveValueAtEnd()、isSortable()、addValueAtEnd()も参照 。

void QMetaSequence::setValueAtIndex(void *container, qsizetype index, const void *value) const

パラメータとして渡されたvalue を使って、container のindex の値を上書きする。

valueAtIndex() およびcanSetValueAtIndex()も参照のこと 。

void QMetaSequence::setValueAtIterator(const void *iterator, const void *value) const

可能であれば、iterator が指す値に、value を書き込む。

valueAtIterator()、canSetValueAtIterator()、begin()、end()も参照のこと 。

void QMetaSequence::valueAtConstIterator(const void *iterator, void *result) const

constiterator が指す値を取得し、可能であればresult が指すメモリ位置に格納する。

canGetValueAtConstIterator()、constBegin()、constEnd()も参照 。

void QMetaSequence::valueAtIndex(const void *container, qsizetype index, void *result) const

container のindex にある値を取得し、result が指すメモリ位置に配置する。

setValueAtIndex() およびcanGetValueAtIndex()も参照のこと 。

void QMetaSequence::valueAtIterator(const void *iterator, void *result) const

nononstiterator が指す値を取得し、可能であればresult が指すメモリ位置に格納する。

setValueAtIterator()、canGetValueAtIterator()、begin()、end()も参照のこと 。

QMetaType QMetaSequence::valueMetaType() const

コンテナに格納されている値のメタ型を返します。