/**************************************************************************** ** ** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies). ** Contact: http://www.qt-project.org/ ** ** This file is part of the QtQml module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this ** file. Please review the following information to ensure the GNU Lesser ** General Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** Other Usage ** Alternatively, this file may be used in accordance with the terms and ** conditions contained in a signed written agreement between you and Nokia. ** ** ** ** ** ** ** $QT_END_LICENSE$ ** ****************************************************************************/ #include "qquickchangeset_p.h" QT_BEGIN_NAMESPACE /*! \class QQuickChangeSet \brief The QQuickChangeSet class stores an ordered list of notifications about changes to a linear data set. \internal QQuickChangeSet can be used to record a series of notications about items in an indexed list being inserted, removed, moved, and changed. Notifications in the set are re-ordered so that all notifications of a single type are grouped together and sorted in order of ascending index, with remove notifications preceding all others, followed by insert notification, and then change notifications. Moves in a change set are represented by a remove notification paired with an insert notification by way of a shared unique moveId. Re-ordering may result in one or both of the paired notifications being divided, when this happens the offset member of the notification will indicate the relative offset of the divided notification from the beginning of the original. */ /*! Constructs an empty change set. */ QQuickChangeSet::QQuickChangeSet() : m_difference(0) { } /*! Constructs a copy of a \a changeSet. */ QQuickChangeSet::QQuickChangeSet(const QQuickChangeSet &changeSet) : m_removes(changeSet.m_removes) , m_inserts(changeSet.m_inserts) , m_changes(changeSet.m_changes) , m_difference(changeSet.m_difference) { } /*! Destroys a change set. */ QQuickChangeSet::~QQuickChangeSet() { } /*! Assigns the value of a \a changeSet to another. */ QQuickChangeSet &QQuickChangeSet::operator =(const QQuickChangeSet &changeSet) { m_removes = changeSet.m_removes; m_inserts = changeSet.m_inserts; m_changes = changeSet.m_changes; m_difference = changeSet.m_difference; return *this; } /*! Appends a notification that \a count items were inserted at \a index. */ void QQuickChangeSet::insert(int index, int count) { insert(QVector() << Insert(index, count)); } /*! Appends a notification that \a count items were removed at \a index. */ void QQuickChangeSet::remove(int index, int count) { QVector removes; removes.append(Remove(index, count)); remove(&removes, 0); } /*! Appends a notification that \a count items were moved \a from one index \a to another. The \a moveId must be unique across the lifetime of the change set and any related change sets. */ void QQuickChangeSet::move(int from, int to, int count, int moveId) { QVector removes; removes.append(Remove(from, count, moveId)); QVector inserts; inserts.append(Insert(to, count, moveId)); remove(&removes, &inserts); insert(inserts); } /*! Appends a notification that \a count items were changed at \a index. */ void QQuickChangeSet::change(int index, int count) { QVector changes; changes.append(Change(index, count)); change(changes); } /*! Applies the changes in a \a changeSet to another. */ void QQuickChangeSet::apply(const QQuickChangeSet &changeSet) { QVector r = changeSet.m_removes; QVector i = changeSet.m_inserts; QVector c = changeSet.m_changes; remove(&r, &i); insert(i); change(c); } /*! Applies a list of \a removes to a change set. If a remove contains a moveId then any intersecting insert in the set will replace the corresponding intersection in the optional \a inserts list. */ void QQuickChangeSet::remove(const QVector &removes, QVector *inserts) { QVector r = removes; remove(&r, inserts); } void QQuickChangeSet::remove(QVector *removes, QVector *inserts) { int removeCount = 0; int insertCount = 0; QVector::iterator insert = m_inserts.begin(); QVector::iterator change = m_changes.begin(); QVector::iterator rit = removes->begin(); for (; rit != removes->end(); ++rit) { int index = rit->index + removeCount; int count = rit->count; // Decrement the accumulated remove count from the indexes of any changes prior to the // current remove. for (; change != m_changes.end() && change->end() < rit->index; ++change) change->index -= removeCount; // Remove any portion of a change notification that intersects the current remove. for (; change != m_changes.end() && change->index > rit->end(); ++change) { change->count -= qMin(change->end(), rit->end()) - qMax(change->index, rit->index); if (change->count == 0) { change = m_changes.erase(change); } else if (rit->index < change->index) { change->index = rit->index; } } // Decrement the accumulated remove count from the indexes of any inserts prior to the // current remove. for (; insert != m_inserts.end() && insert->end() <= index; ++insert) { insertCount += insert->count; insert->index -= removeCount; } rit->index -= insertCount; // Remove any portion of a insert notification that intersects the current remove. while (insert != m_inserts.end() && insert->index < index + count) { int offset = index - insert->index; const int difference = qMin(insert->end(), index + count) - qMax(insert->index, index); // If part of the remove or insert that precedes the intersection has a moveId create // a new delta for that portion and subtract the size of that delta from the current // one. if (offset < 0 && rit->moveId != -1) { rit = removes->insert(rit, Remove( rit->index, -offset, rit->moveId, rit->offset)); ++rit; rit->count -= -offset; rit->offset += -offset; index += -offset; count -= -offset; removeCount += -offset; offset = 0; } else if (offset > 0 && insert->moveId != -1) { insert = m_inserts.insert(insert, Insert( insert->index - removeCount, offset, insert->moveId, insert->offset)); ++insert; insert->index += offset; insert->count -= offset; insert->offset += offset; rit->index -= offset; insertCount += offset; } // If the current remove has a move id, find any inserts with the same move id and // replace the corresponding sections with the insert removed from the change set. if (rit->moveId != -1 && difference > 0 && inserts) { for (QVector::iterator iit = inserts->begin(); iit != inserts->end(); ++iit) { if (iit->moveId != rit->moveId || rit->offset > iit->offset + iit->count || iit->offset > rit->offset + difference) { continue; } // If the intersecting insert starts before the replacement one create // a new insert for the portion prior to the replacement insert. const int overlapOffset = rit->offset - iit->offset; if (overlapOffset > 0) { iit = inserts->insert(iit, Insert( iit->index, overlapOffset, iit->moveId, iit->offset)); ++iit; iit->index += overlapOffset; iit->count -= overlapOffset; iit->offset += overlapOffset; } if (iit->offset >= rit->offset && iit->offset + iit->count <= rit->offset + difference) { // If the replacement insert completely encapsulates the existing // one just change the moveId. iit->moveId = insert->moveId; iit->offset = insert->offset + qMax(0, -overlapOffset); } else { // Create a new insertion before the intersecting one with the number of intersecting // items and remove that number from that insert. const int count = qMin(iit->offset + iit->count, rit->offset + difference) - qMax(iit->offset, rit->offset); iit = inserts->insert(iit, Insert( iit->index, count, insert->moveId, insert->offset + qMax(0, -overlapOffset))); ++iit; iit->index += count; iit->count -= count; iit->offset += count; } } } // Subtract the number of intersecting items from the current remove and insert. insert->count -= difference; insert->offset += difference; rit->count -= difference; rit->offset += difference; index += difference; count -= difference; removeCount += difference; if (insert->count == 0) { insert = m_inserts.erase(insert); } else if (rit->count == -offset || rit->count == 0) { insert->index += difference; break; } else if (offset <= 0) { insert->index = index - removeCount; insertCount += insert->count; ++insert; } else { insert->index -= removeCount - difference; rit->index -= insert->count; insertCount += insert->count; ++insert; } } removeCount += rit->count; } for (; insert != m_inserts.end(); ++insert) insert->index -= removeCount; removeCount = 0; QVector::iterator remove = m_removes.begin(); for (rit = removes->begin(); rit != removes->end(); ++rit) { if (rit->count == 0) continue; // Accumulate consecutive removes into a single delta before attempting to apply. for (QVector::iterator next = rit + 1; next != removes->end() && next->index == rit->index && next->moveId == -1 && rit->moveId == -1; ++next) { next->count += rit->count; rit = next; } int index = rit->index + removeCount; // Decrement the accumulated remove count from the indexes of any inserts prior to the // current remove. for (; remove != m_removes.end() && index > remove->index; ++remove) remove->index -= removeCount; while (remove != m_removes.end() && index + rit->count >= remove->index) { int count = 0; const int offset = remove->index - index; QVector::iterator rend = remove; for (; rend != m_removes.end() && rit->moveId == -1 && rend->moveId == -1 && index + rit->count >= rend->index; ++rend) { count += rend->count; } if (remove != rend) { // Accumulate all existing non-move removes that are encapsulated by or immediately // follow the current remove into it. int difference = 0; if (rend == m_removes.end()) difference = rit->count; else if (rit->index + rit->count < rend->index - removeCount) difference = rit->count; else if (rend->moveId != -1) { difference = rend->index - removeCount - rit->index; index += difference; } else if (offset > 0) difference = offset; count += difference; rit->count -= difference; removeCount += difference; remove->index = rit->index; remove->count = count; remove = m_removes.erase(++remove, rend); } else { // Insert a remove for the portion of the unmergable current remove prior to the // point of intersection. if (offset > 0) { remove = m_removes.insert(remove, Remove( rit->index, offset, rit->moveId, rit->offset)); ++remove; rit->count -= offset; rit->offset += offset; removeCount += offset; index += offset; } remove->index = rit->index; ++remove; } } if (rit->count > 0) { remove = m_removes.insert(remove, *rit); ++remove; } removeCount += rit->count; } for (; remove != m_removes.end(); ++remove) remove->index -= removeCount; m_difference -= removeCount; } /*! Applies a list of \a inserts to a change set. */ void QQuickChangeSet::insert(const QVector &inserts) { int insertCount = 0; QVector::iterator insert = m_inserts.begin(); QVector::iterator change = m_changes.begin(); for (QVector::const_iterator iit = inserts.begin(); iit != inserts.end(); ++iit) { if (iit->count == 0) continue; int index = iit->index - insertCount; Insert current = *iit; // Accumulate consecutive inserts into a single delta before attempting to insert. for (QVector::const_iterator next = iit + 1; next != inserts.end() && next->index == iit->index + iit->count && next->moveId == -1 && iit->moveId == -1; ++next) { current.count += next->count; iit = next; } // Increment the index of any changes before the current insert by the accumlated insert // count. for (; change != m_changes.end() && change->index >= index; ++change) change->index += insertCount; // If the current insert index is in the middle of a change split it in two at that // point and increment the index of the latter half. if (change != m_changes.end() && change->index < index + iit->count) { int offset = index - change->index; change = m_changes.insert(change, Change(change->index + insertCount, offset)); ++change; change->index += iit->count + offset; change->count -= offset; } // Increment the index of any inserts before the current insert by the accumlated insert // count. for (; insert != m_inserts.end() && index > insert->index + insert->count; ++insert) insert->index += insertCount; if (insert == m_inserts.end()) { insert = m_inserts.insert(insert, current); ++insert; } else { const int offset = index - insert->index; if (offset < 0) { // If the current insert is before an existing insert and not adjacent just insert // it into the list. insert = m_inserts.insert(insert, current); ++insert; } else if (iit->moveId == -1 && insert->moveId == -1) { // If neither the current nor existing insert has a moveId add the current insert // to the existing one. if (offset < insert->count) { insert->index -= current.count; insert->count += current.count; } else { insert->index += insertCount; insert->count += current.count; ++insert; } } else if (offset < insert->count) { // If either insert has a moveId then split the existing insert and insert the // current one in the middle. if (offset > 0) { insert = m_inserts.insert(insert, Insert( insert->index + insertCount, offset, insert->moveId, insert->offset)); ++insert; insert->index += offset; insert->count -= offset; insert->offset += offset; } insert = m_inserts.insert(insert, current); ++insert; } else { insert->index += insertCount; ++insert; insert = m_inserts.insert(insert, current); ++insert; } } insertCount += current.count; } for (; insert != m_inserts.end(); ++insert) insert->index += insertCount; m_difference += insertCount; } /*! Applies a combined list of \a removes and \a inserts to a change set. This is equivalent calling \l remove() followed by \l insert() with the same lists. */ void QQuickChangeSet::move(const QVector &removes, const QVector &inserts) { QVector r = removes; QVector i = inserts; remove(&r, &i); insert(i); } /*! Applies a list of \a changes to a change set. */ void QQuickChangeSet::change(const QVector &changes) { QVector c = changes; change(&c); } void QQuickChangeSet::change(QVector *changes) { QVector::iterator insert = m_inserts.begin(); QVector::iterator change = m_changes.begin(); for (QVector::iterator cit = changes->begin(); cit != changes->end(); ++cit) { for (; insert != m_inserts.end() && insert->end() < cit->index; ++insert) {} for (; insert != m_inserts.end() && insert->index < cit->end(); ++insert) { const int offset = insert->index - cit->index; const int count = cit->count + cit->index - insert->index - insert->count; if (offset == 0) { cit->index = insert->index + insert->count; cit->count = count; } else { cit = changes->insert(++cit, Change(insert->index + insert->count, count)); --cit; cit->count = offset; } } for (; change != m_changes.end() && change->index + change->count < cit->index; ++change) {} if (change == m_changes.end() || change->index > cit->index + cit->count) { if (cit->count > 0) { change = m_changes.insert(change, *cit); ++change; } } else { if (cit->index < change->index) { change->count += change->index - cit->index; change->index = cit->index; } if (cit->index + cit->count > change->index + change->count) { change->count = cit->index + cit->count - change->index; QVector::iterator cbegin = change; QVector::iterator cend = ++cbegin; for (; cend != m_changes.end() && cend->index <= change->index + change->count; ++cend) { if (cend->index + cend->count > change->index + change->count) change->count = cend->index + cend->count - change->index; } if (cbegin != cend) { change = m_changes.erase(cbegin, cend); --change; } } } } } /*! Prints the contents of a change \a set to the \a debug stream. */ QDebug operator <<(QDebug debug, const QQuickChangeSet &set) { debug.nospace() << "QQuickChangeSet("; foreach (const QQuickChangeSet::Remove &remove, set.removes()) debug << remove; foreach (const QQuickChangeSet::Insert &insert, set.inserts()) debug << insert; foreach (const QQuickChangeSet::Change &change, set.changes()) debug << change; return debug.nospace() << ')'; } /*! Prints a \a remove to the \a debug stream. */ QDebug operator <<(QDebug debug, const QQuickChangeSet::Remove &remove) { if (remove.moveId == -1) { return (debug.nospace() << "Remove(" << remove.index << ',' << remove.count << ')').space(); } else { return (debug.nospace() << "Remove(" << remove.index << ',' << remove.count << ',' << remove.moveId << ',' << remove.offset << ')').space(); } } /*! Prints an \a insert to the \a debug stream. */ QDebug operator <<(QDebug debug, const QQuickChangeSet::Insert &insert) { if (insert.moveId == -1) { return (debug.nospace() << "Insert(" << insert.index << ',' << insert.count << ')').space(); } else { return (debug.nospace() << "Insert(" << insert.index << ',' << insert.count << ',' << insert.moveId << ',' << insert.offset << ')').space(); } } /*! Prints a \a change to the \a debug stream. */ QDebug operator <<(QDebug debug, const QQuickChangeSet::Change &change) { return (debug.nospace() << "Change(" << change.index << ',' << change.count << ')').space(); } QT_END_NAMESPACE