MergeLists()

Синтаксис

MergeLists(SourceList() , DestinationList() [, Location])

Описание

Перемещает все элементы из Связного Списка SourceList() в Связный Список DestinationList(). Это быстрая операция, потому что при объединении Списков сами данные не перемещаются.

Параметры

SourceList()	Список, из которого будут взяты элементы. После возврата функции этот Список станет пустым.
DestinationList()	Список, в который будут перемещены элементы. После возврата функции этот Список будет содержать элементы обоих Списков.
Location (дополн.)	Параметр определяющий место вставки элементов в DestinationList(). Этот параметр может быть одним из следующих значений: #PB_List_Last : Добавить элементы в конце DestinationList() (по умолчанию) #PB_List_First : Вставить элементы в начало DestinationList() #PB_List_Before: Вставить элементы перед текущим элементом DestinationList() #PB_List_After : Вставить элементы после текущего элемента DestinationList()

Возвращаемое значение

Ничего.

Пример

NewList A.s() ; Создаёт Список A()
AddElement(A()): A() = "a0"
AddElement(A()): A() = "a1"
AddElement(A()): A() = "a2"
AddElement(A()): A() = "a3"

NewList B.s() ; Создаёт Список B()
AddElement(B()): B() = "b0"
AddElement(B()): B() = "b1"
AddElement(B()): B() = "b2"
AddElement(B()): B() = "b3"

SelectElement(B(), 1) ; Делает элемент содержащий "b1" текущим элементом в Списке B()
MergeLists(A(), B(), #PB_List_Before) ; Вставляет элементы Списка A() перед элементом содержащим "b1" в Списке B()

ForEach B()
    Debug B()
Next

См. также

SplitList()

Поддерживаемые OS

Все