Класс CAtlList
Этот класс предоставляет методы для создания объекта списка и управления ими.
Синтаксис
template<typename E, class ETraits = CElementTraits<E>>
class CAtlList
Параметры
E
Тип элемента.
ETraits
Код, используемый для копирования или перемещения элементов. Дополнительные сведения см. в классе CElementTraits.
Участники
Общедоступные определения типов
| Имя | Описание |
|---|---|
| CAtlList::INARGTYPE |
Открытые конструкторы
| Имя | Описание |
|---|---|
| CAtlList::CAtlList | Конструктор. |
| CAtlList::~CAtlList | Деструктор |
Открытые методы
| Имя | Описание |
|---|---|
| CAtlList::AddHead | Вызовите этот метод, чтобы добавить элемент в голову списка. |
| CAtlList::AddHeadList | Вызовите этот метод, чтобы добавить существующий список в голову списка. |
| CAtlList::AddTail | Вызовите этот метод, чтобы добавить элемент в хвост этого списка. |
| CAtlList::AddTailList | Вызовите этот метод, чтобы добавить существующий список в хвост этого списка. |
| CAtlList::AssertValid | Вызовите этот метод, чтобы убедиться, что список действителен. |
| CAtlList::Find | Вызовите этот метод для поиска списка для указанного элемента. |
| CAtlList::FindIndex | Вызовите этот метод, чтобы получить положение элемента, заданное значением индекса. |
| CAtlList::GetAt | Вызовите этот метод, чтобы вернуть элемент по заданной позиции в списке. |
| CAtlList::GetCount | Вызовите этот метод, чтобы вернуть количество объектов в списке. |
| CAtlList::GetHead | Вызовите этот метод, чтобы вернуть элемент в начале списка. |
| CAtlList::GetHeadPosition | Вызовите этот метод, чтобы получить позицию головы списка. |
| CAtlList::GetNext | Вызовите этот метод, чтобы вернуть следующий элемент из списка. |
| CAtlList::GetPrev | Вызовите этот метод, чтобы вернуть предыдущий элемент из списка. |
| CAtlList::GetTail | Вызовите этот метод, чтобы вернуть элемент в хвосте списка. |
| CAtlList::GetTailPosition | Вызовите этот метод, чтобы получить положение хвоста списка. |
| CAtlList::InsertAfter | Вызовите этот метод, чтобы вставить новый элемент в список после указанной позиции. |
| CAtlList::InsertBefore | Вызовите этот метод, чтобы вставить новый элемент в список до указанной позиции. |
| CAtlList::IsEmpty | Вызовите этот метод, чтобы определить, является ли список пустым. |
| CAtlList::MoveToHead | Вызовите этот метод, чтобы переместить указанный элемент в голову списка. |
| CAtlList::MoveToTail | Вызовите этот метод, чтобы переместить указанный элемент в хвост списка. |
| CAtlList::RemoveAll | Вызовите этот метод, чтобы удалить все элементы из списка. |
| CAtlList::RemoveAt | Вызовите этот метод, чтобы удалить один элемент из списка. |
| CAtlList::RemoveHead | Вызовите этот метод, чтобы удалить элемент в начале списка. |
| CAtlList::RemoveHeadNoReturn | Вызовите этот метод, чтобы удалить элемент в голове списка без возврата значения. |
| CAtlList::RemoveTail | Вызовите этот метод, чтобы удалить элемент в хвосте списка. |
| CAtlList::RemoveTailNoReturn | Вызовите этот метод, чтобы удалить элемент в хвосте списка без возврата значения. |
| CAtlList::SetAt | Вызовите этот метод, чтобы задать значение элемента в заданной позиции в списке. |
| CAtlList::SwapElements | Вызовите этот метод для замены элементов в списке. |
Замечания
Класс CAtlList поддерживает упорядоченные списки неуниканных объектов, доступные последовательно или по значению. CAtlList списки ведут себя как вдвойне связанные списки. Каждый список имеет голову и хвост, а новые элементы (или списки в некоторых случаях) можно добавить в конец списка или вставить до или после определенных элементов.
CAtlList Большинство методов используют значение позиции. Это значение используется методами для ссылки на фактическое расположение памяти, в котором хранятся элементы, и не следует вычислять или прогнозировать напрямую. Если необходимо получить доступ к элементу nth в списке, метод CAtlList::FindIndex вернет соответствующее значение позиции для заданного индекса. Методы CAtlList::GetNext и CAtlList::GetPrev можно использовать для итерации объектов в списке.
Дополнительные сведения о классах коллекций, доступных в ATL, см. в разделе "Классы коллекций ATL".
Требования
Заголовок: atlcoll.h
CAtlList::AddHead
Вызовите этот метод, чтобы добавить элемент в голову списка.
POSITION AddHead();
POSITION AddHead(INARGTYPE element);
Параметры
Элемент
Новый элемент.
Возвращаемое значение
Возвращает позицию только что добавленного элемента.
Замечания
Если используется первая версия, пустой элемент создается с помощью конструктора по умолчанию, а не конструктора копирования.
Пример
// Declare a list of integers
CAtlList<int> myList;
// Add some elements, each to the head of the list.
// As each new element is added, the previous head is
// pushed down the list.
myList.AddHead(42);
myList.AddHead(49);
// Confirm the value currently at the head of the list
ATLASSERT(myList.GetHead() == 49);
// Confirm the value currently at the tail of the list
ATLASSERT(myList.GetTail() == 42);
CAtlList::AddHeadList
Вызовите этот метод, чтобы добавить существующий список в голову списка.
void AddHeadList(const CAtlList<E, ETraits>* plNew);
Параметры
plNew
Добавляемый список.
Замечания
Список, на который указывает plNew , вставляется в начале существующего списка. В сборках отладки произойдет сбой утверждения, если plNew равно NULL.
Пример
// Define two lists of integers
CAtlList<int> myList1;
CAtlList<int> myList2;
// Fill up the first list
myList1.AddTail(1);
myList1.AddTail(2);
myList1.AddTail(3);
// Add an element to the second list
myList2.AddTail(4);
// Insert the first list into the second
myList2.AddHeadList(&myList1);
// The second list now contains:
// 1, 2, 3, 4
CAtlList::AddTail
Вызовите этот метод, чтобы добавить элемент в хвост этого списка.
POSITION AddTail();
POSITION AddTail(INARGTYPE element);
Параметры
Элемент
Добавляемый элемент.
Возвращаемое значение
Возвращает позицию только что добавленного элемента.
Замечания
Если используется первая версия, пустой элемент создается с помощью конструктора по умолчанию, а не конструктора копирования. Элемент добавляется в конец списка, поэтому он становится хвостом. Этот метод можно использовать с пустым списком.
Пример
// Define the list
CAtlList<int> myList;
// Add elements to the tail
myList.AddTail(1);
myList.AddTail(2);
myList.AddTail(3);
// Confirm the current head of the list
ATLASSERT(myList.GetHead() == 1);
// Confirm the current tail of the list
ATLASSERT(myList.GetTail() == 3);
CAtlList::AddTailList
Вызовите этот метод, чтобы добавить существующий список в хвост этого списка.
void AddTailList(const CAtlList<E, ETraits>* plNew);
Параметры
plNew
Добавляемый список.
Замечания
Список, на который указывает plNew , вставляется после последнего элемента (если такового) в объекте списка. Таким образом, последний элемент в списке plNew становится хвостом. В сборках отладки произойдет сбой утверждения, если plNew равно NULL.
Пример
// Define two integer lists
CAtlList<int> myList1;
CAtlList<int> myList2;
// Fill up the first list
myList1.AddTail(1);
myList1.AddTail(2);
myList1.AddTail(3);
// Add an element to the second list
myList2.AddTail(4);
// Insert the first list into the second
myList2.AddTailList(&myList1);
// The second list now contains:
// 4, 1, 2, 3
CAtlList::AssertValid
Вызовите этот метод, чтобы убедиться, что список действителен.
void AssertValid() const;
Замечания
В отладочных сборках произойдет сбой утверждения, если объект списка недопустим. Чтобы быть допустимым, пустой список должен иметь как голову, так и хвост, указывающий на NULL, и список, который не является пустым, должен иметь как голову, так и хвост, указывающий на допустимые адреса.
Пример
// Define the list
CAtlList<int> myList;
// AssertValid only exists in debug builds
#ifdef _DEBUG
myList.AssertValid();
#endif
CAtlList::CAtlList
Конструктор.
CAtlList(UINT nBlockSize = 10) throw();
Параметры
nBlockSize
Размер блока.
Замечания
Конструктор объекта CAtlList . Размер блока — это мера объема памяти, выделенного при необходимости нового элемента. Более крупные размеры блоков сокращают вызовы подпрограмм выделения памяти, но используют больше ресурсов.
Пример
// Define two lists
CAtlList<int> myList1;
CAtlList<double> myList2;
CAtlList::~CAtlList
Деструктор
~CAtlList() throw();
Замечания
Освобождает все выделенные ресурсы, включая вызов CAtlList::RemoveAll , чтобы удалить все элементы из списка.
В отладочных сборках произойдет сбой утверждения, если список по-прежнему содержит некоторые элементы после вызова RemoveAll.
CAtlList::Find
Вызовите этот метод для поиска списка для указанного элемента.
POSITION Find(INARGTYPE element, POSITION posStartAfter = NULL) const throw();
Параметры
Элемент
Элемент, который нужно найти в списке.
posStartAfter
Начальная позиция для поиска. Если значение не указано, поиск начинается с головного элемента.
Возвращаемое значение
Возвращает значение POSITION элемента, если найдено, в противном случае возвращает значение NULL.
Замечания
В отладочных сборках произойдет сбой утверждения, если объект списка недействителен или если значение posStartAfter выходит за пределы диапазона.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);
myList.AddTail(400);
// Find the '300' element in the list,
// starting from the list head.
POSITION myPos = myList.Find(300);
// Confirm that the element was found
ATLASSERT(myList.GetAt(myPos) == 300);
CAtlList::FindIndex
Вызовите этот метод, чтобы получить положение элемента, заданное значением индекса.
POSITION FindIndex(size_t iElement) const throw();
Параметры
iElement
Отсчитываемый от нуля индекс требуемого элемента списка.
Возвращаемое значение
Возвращает соответствующее значение POSITION или NULL, если iElement выходит за пределы диапазона.
Замечания
Этот метод возвращает позицию, соответствующую заданному значению индекса, позволяя получить доступ к элементу nth в списке.
В отладочных сборках произойдет сбой утверждения, если объект списка недопустим.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
for (int i = 0; i < 100; i++)
{
myList.AddTail(i);
}
// Iterate through the entire list
for (size_t j = 0; j < myList.GetCount(); j++)
{
size_t i = myList.GetAt(myList.FindIndex(j));
ATLASSERT(i == j);
}
CAtlList::GetAt
Вызовите этот метод, чтобы вернуть элемент по заданной позиции в списке.
E& GetAt(POSITION pos) throw();
const E& GetAt(POSITION pos) const throw();
Параметры
pos
Значение POSITION, указывающее определенный элемент.
Возвращаемое значение
Ссылка на элемент или копию.
Замечания
Если список указан const, GetAt возвращает копию элемента. Это позволяет использовать метод только справа от инструкции назначения и защищает список от изменения.
Если список не constуказан, GetAt возвращает ссылку на элемент. Это позволяет использовать метод на любой стороне инструкции назначения и таким образом позволяет изменять записи списка.
В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
См. пример CAtlList ::FindIndex.
CAtlList::GetCount
Вызовите этот метод, чтобы вернуть количество объектов в списке.
size_t GetCount() const throw();
Возвращаемое значение
Возвращает количество элементов в списке.
Пример
См. пример CAtlList ::Find.
CAtlList::GetHead
Вызовите этот метод, чтобы вернуть элемент в начале списка.
E& GetHead() throw();
const E& GetHead() const throw();
Возвращаемое значение
Возвращает ссылку на элемент или копию элемента в начале списка.
Замечания
Если список указан const, GetHead возвращает копию элемента в начале списка. Это позволяет использовать метод только справа от инструкции назначения и защищает список от изменения.
Если список не constуказан, GetHead возвращает ссылку на элемент в начале списка. Это позволяет использовать метод на любой стороне инструкции назначения и таким образом позволяет изменять записи списка.
При отладке сборки произойдет сбой утверждения, если головка списка указывает на NULL.
Пример
См. пример CAtlList ::AddHead.
CAtlList::GetHeadPosition
Вызовите этот метод, чтобы получить позицию головы списка.
POSITION GetHeadPosition() const throw();
Возвращаемое значение
Возвращает значение POSITION, соответствующее элементу в начале списка.
Замечания
Если список пуст, возвращаемое значение равно NULL.
Пример
// Define the integer list
CAtlList<int> myList;
int i;
// Populate the list
for (i = 0; i < 100; i++)
{
myList.AddTail(i);
}
// Get the starting position value
POSITION myPos = myList.GetHeadPosition();
// Iterate through the entire list
i = 0;
int j;
do {
j = myList.GetNext(myPos);
ATLASSERT(i == j);
i++;
} while (myPos != NULL);
CAtlList::GetNext
Вызовите этот метод, чтобы вернуть следующий элемент из списка.
E& GetNext(POSITION& pos) throw();
const E& GetNext(POSITION& pos) const throw();
Параметры
pos
Значение POSITION, возвращаемое предыдущим вызовом GetNext, CAtlList::GetHeadPosition или другим CAtlList методом.
Возвращаемое значение
Если список указан const, GetNext возвращает копию следующего элемента списка. Это позволяет использовать метод только справа от инструкции назначения и защищает список от изменения.
Если список не constуказан, GetNext возвращает ссылку на следующий элемент списка. Это позволяет использовать метод на любой стороне инструкции назначения и таким образом позволяет изменять записи списка.
Замечания
Счетчик POSITION, pos, обновляется, чтобы указать следующий элемент в списке или NULL, если нет дополнительных элементов. В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
См. пример CAtlList ::GetHeadPosition.
CAtlList::GetPrev
Вызовите этот метод, чтобы вернуть предыдущий элемент из списка.
E& GetPrev(POSITION& pos) throw();
const E& GetPrev(POSITION& pos) const throw();
Параметры
pos
Значение POSITION, возвращаемое предыдущим вызовом GetPrev, CAtlList::GetTailPosition или другим CAtlList методом.
Возвращаемое значение
Если список указан const, GetPrev возвращает копию элемента списка. Это позволяет использовать метод только справа от инструкции назначения и защищает список от изменения.
Если список не constуказан, GetPrev возвращает ссылку на элемент списка. Это позволяет использовать метод на любой стороне инструкции назначения и таким образом позволяет изменять записи списка.
Замечания
Счетчик POSITION, pos, обновляется, чтобы указать предыдущий элемент в списке или NULL, если нет дополнительных элементов. В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
См. пример CAtlList ::GetTailPosition.
CAtlList::GetTail
Вызовите этот метод, чтобы вернуть элемент в хвосте списка.
E& GetTail() throw();
const E& GetTail() const throw();
Возвращаемое значение
Возвращает ссылку на элемент или копию элемента в хвосте списка.
Замечания
Если список указан const, GetTail возвращает копию элемента в начале списка. Это позволяет использовать метод только справа от инструкции назначения и защищает список от изменения.
Если список не constуказан, GetTail возвращает ссылку на элемент в начале списка. Это позволяет использовать метод на любой стороне инструкции назначения и таким образом позволяет изменять записи списка.
В сборках отладки происходит сбой утверждения, если хвост списка указывает на NULL.
Пример
См. пример CAtlList ::AddTail.
CAtlList::GetTailPosition
Вызовите этот метод, чтобы получить положение хвоста списка.
POSITION GetTailPosition() const throw();
Возвращаемое значение
Возвращает значение POSITION, соответствующее элементу в хвосте списка.
Замечания
Если список пуст, возвращаемое значение равно NULL.
Пример
// Define the integer list
CAtlList<int> myList;
int i;
// Populate the list
for (i = 0; i < 100; i++)
{
myList.AddHead(i);
}
// Get the starting position value
POSITION myP = myList.GetTailPosition();
// Iterate through the entire list
i = 0;
int j;
do {
j = myList.GetPrev(myP);
ATLASSERT(i == j);
i++;
} while (myP != NULL);
CAtlList::INARGTYPE
Тип, используемый при передаче элемента в качестве входного аргумента.
typedef ETraits::INARGTYPE INARGTYPE;
CAtlList::InsertAfter
Вызовите этот метод, чтобы вставить новый элемент в список после указанной позиции.
POSITION InsertAfter(POSITION pos, INARGTYPE element);
Параметры
pos
Значение POSITION, после которого будет вставлен новый элемент.
Элемент
Элемент, который необходимо вставить.
Возвращаемое значение
Возвращает значение POSITION нового элемента.
Замечания
В сборках отладки произойдет сбой утверждения, если список недействителен, если вставка завершается ошибкой, или если попытка вставить элемент после хвоста.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
POSITION myPos = myList.AddHead(1);
myPos = myList.InsertAfter(myPos, 2);
myPos = myList.InsertAfter(myPos, 3);
// Confirm the tail value is as expected
ATLASSERT(myList.GetTail() == 3);
CAtlList::InsertBefore
Вызовите этот метод, чтобы вставить новый элемент в список до указанной позиции.
POSITION InsertBefore(POSITION pos, INARGTYPE element);
Параметры
pos
Новый элемент будет вставлен в список до этого значения POSITION.
Элемент
Элемент, который необходимо вставить.
Возвращаемое значение
Возвращает значение POSITION нового элемента.
Замечания
В отладочных сборках произойдет сбой утверждения, если список недействителен, если вставка завершается ошибкой, или если попытка вставить элемент перед головой.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
POSITION myPos = myList.AddHead(1);
myPos = myList.InsertBefore(myPos, 2);
myPos = myList.InsertBefore(myPos, 3);
// Confirm the head value is as expected
ATLASSERT(myList.GetHead() == 3);
CAtlList::IsEmpty
Вызовите этот метод, чтобы определить, является ли список пустым.
bool IsEmpty() const throw();
Возвращаемое значение
Возвращает значение true, если список не содержит объектов, в противном случае — значение false.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(1);
myList.AddTail(2);
myList.AddTail(3);
myList.AddTail(4);
// Confirm not empty
ATLASSERT(myList.IsEmpty() == false);
// Remove the tail element
myList.RemoveTailNoReturn();
// Confirm not empty
ATLASSERT(myList.IsEmpty() == false);
// Remove the head element
myList.RemoveHeadNoReturn();
// Confirm not empty
ATLASSERT(myList.IsEmpty() == false);
// Remove all remaining elements
myList.RemoveAll();
// Confirm empty
ATLASSERT(myList.IsEmpty() == true);
CAtlList::MoveToHead
Вызовите этот метод, чтобы переместить указанный элемент в голову списка.
void MoveToHead(POSITION pos) throw();
Параметры
pos
Значение POSITION элемента для перемещения.
Замечания
Указанный элемент перемещается из текущей позиции в голову списка. В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(1);
myList.AddTail(2);
myList.AddTail(3);
myList.AddTail(4);
// Move the tail element to the head
myList.MoveToHead(myList.GetTailPosition());
// Confirm the head is as expected
ATLASSERT(myList.GetHead() == 4);
// Move the head element to the tail
myList.MoveToTail(myList.GetHeadPosition());
// Confirm the tail is as expected
ATLASSERT(myList.GetTail() == 4);
CAtlList::MoveToTail
Вызовите этот метод, чтобы переместить указанный элемент в хвост списка.
void MoveToTail(POSITION pos) throw();
Параметры
pos
Значение POSITION элемента для перемещения.
Замечания
Указанный элемент перемещается из текущей позиции в хвост списка. В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
См. пример CAtlList ::MoveToHead.
CAtlList::RemoveAll
Вызовите этот метод, чтобы удалить все элементы из списка.
void RemoveAll() throw();
Замечания
Этот метод удаляет все элементы из списка и освобождает выделенную память. В сборках отладки будет возникать функция ATLASSERT, если все элементы не удаляются или если структура списка повреждена.
Пример
См. пример CAtlList ::IsEmpty.
CAtlList::RemoveAt
Вызовите этот метод, чтобы удалить один элемент из списка.
void RemoveAt(POSITION pos) throw();
Параметры
pos
Значение POSITION элемента, которое нужно удалить.
Замечания
Элемент, на который ссылается pos, удаляется, а память освобождается. Можно использовать для RemoveAt удаления головы или хвоста списка.
В сборках отладки произойдет сбой утверждения, если список недействителен или при удалении элемента приводит к тому, что список обращается к памяти, которая не является частью структуры списка.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);
// Use RemoveAt to remove elements one by one
myList.RemoveAt(myList.Find(100));
myList.RemoveAt(myList.Find(200));
myList.RemoveAt(myList.Find(300));
// Confirm all have been deleted
ATLASSERT(myList.IsEmpty() == true);
CAtlList::RemoveHead
Вызовите этот метод, чтобы удалить элемент в начале списка.
E RemoveHead();
Возвращаемое значение
Возвращает элемент в начале списка.
Замечания
Головной элемент удаляется из списка, а память освобождается. Возвращается копия элемента. В отладочных сборках произойдет сбой утверждения, если список пуст.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);
// Confirm the head of the list
ATLASSERT(myList.GetHead() == 100);
// Remove the head of the list
ATLASSERT(myList.RemoveHead() == 100);
// Confirm the new head of the list
ATLASSERT(myList.GetHead() == 200);
CAtlList::RemoveHeadNoReturn
Вызовите этот метод, чтобы удалить элемент в голове списка без возврата значения.
void RemoveHeadNoReturn() throw();
Замечания
Головной элемент удаляется из списка, а память освобождается. В отладочных сборках произойдет сбой утверждения, если список пуст.
Пример
См. пример CAtlList ::IsEmpty.
CAtlList::RemoveTail
Вызовите этот метод, чтобы удалить элемент в хвосте списка.
E RemoveTail();
Возвращаемое значение
Возвращает элемент в хвосте списка.
Замечания
Хвостовой элемент удаляется из списка, а память освобождается. Возвращается копия элемента. В отладочных сборках произойдет сбой утверждения, если список пуст.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
myList.AddTail(300);
// Confirm the tail of the list
ATLASSERT(myList.GetTail() == 300);
// Remove the tail of the list
ATLASSERT(myList.RemoveTail() == 300);
// Confirm the new tail of the list
ATLASSERT(myList.GetTail() == 200);
CAtlList::RemoveTailNoReturn
Вызовите этот метод, чтобы удалить элемент в хвосте списка без возврата значения.
void RemoveTailNoReturn() throw();
Замечания
Хвостовой элемент удаляется из списка, а память освобождается. В отладочных сборках произойдет сбой утверждения, если список пуст.
Пример
См. пример CAtlList ::IsEmpty.
CAtlList::SetAt
Вызовите этот метод, чтобы задать значение элемента в заданной позиции в списке.
void SetAt(POSITION pos, INARGTYPE element);
Параметры
pos
Значение POSITION, соответствующее элементу для изменения.
Элемент
Новое значение элемента.
Замечания
Заменяет существующее значение элементом. В сборках отладки произойдет сбой утверждения, если pos равен NULL.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
myList.AddTail(100);
myList.AddTail(200);
// Use SetAt to change the values stored in the head and
// tail of the list
myList.SetAt(myList.GetHeadPosition(), myList.GetHead() * 10);
myList.SetAt(myList.GetTailPosition(), myList.GetTail() * 10);
// Confirm the values
ATLASSERT(myList.GetHead() == 1000);
ATLASSERT(myList.GetTail() == 2000);
CAtlList::SwapElements
Вызовите этот метод для замены элементов в списке.
void SwapElements(POSITION pos1, POSITION pos2) throw();
Параметры
pos1
Первое значение POSITION.
pos2
Второе значение POSITION.
Замечания
Переключает элементы в указанных двух позициях. В сборках отладки произойдет сбой утверждения, если любое положение равно NULL.
Пример
// Define the integer list
CAtlList<int> myList;
// Populate the list
for (int i = 0; i < 100; i++)
{
myList.AddHead(i);
}
// Order is: 99, 98, 97, 96...
ATLASSERT(myList.GetHead() == 99);
ATLASSERT(myList.GetTail() == 0);
// Perform a crude bubble sort
for (int j = 0; j < 100; j++)
{
for(int i = 0; i < 99; i++)
{
if (myList.GetAt(myList.FindIndex(i)) >
myList.GetAt(myList.FindIndex(i+1)))
{
myList.SwapElements(myList.FindIndex(i), myList.FindIndex(i+1));
}
}
}
// Order is: 0, 1, 2, 3...
ATLASSERT(myList.GetHead() == 0);
ATLASSERT(myList.GetTail() == 99);
См. также
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по