SplitList()

Синтаксис

SplitList(SourceList() , DestinationList() [, KeepCurrent])

Описание

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

Параметры

SourceList()	Список, из которого будут перемещены элементы. Текущий элемент Списка определяет точку разделения Списка. Если нет текущего элемента, то все элементы остаются в SourceList().
DestinationList()	Список, в который будут перемещены элементы. Все существующие элементы в этом Списке будут удалены перед добавлением новых элементов.
KeepCurrent (дополн.)	Остается ли текущий элемент SourceList() в SourceList() или будет перемещен в DestinationList(). Если этот параметр - #True, то текущий элемент остается в SourceList(). Если это - #False (по умолчанию), то текущий элемент перемещается в DestinationList().

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

Ничего.

Комментарии

Если 'KeepCurrent' установлен в #True то текущий элемент SOURCELIST() будет последним элементом Списка SOURCELIST().
Если этот параметр установлен в #False то текущий элемент перемещается в Список DestinationList(), а новым текущим элементом становится предыдущий. Если же предыдущего элемента нет, то после возврата функции у Списка больше не будет текущего элемента.

У Списка DestinationList() в любом случае не будет текущего элемента.

Пример

NewList A()
NewList B()

For i = 0 To 10
    AddElement(A())
    A() = i
Next i

; Разделяет Список A() на 5-м элементе и перемещает остальные элементы в Список B()
SelectElement(A(), 5)
SplitList(A(), B())

Debug " -- A( ) -- "
ForEach A()
    Debug A()
Next

Debug " -- B( ) -- "
ForEach B()
    Debug B()
Next

См. также

MergeLists()

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

Все