These vectors link and unlink an item into and from a list.
|Call Parameters||Return Parameters|
|A0.L||Pointer to item.||A0.L||Preserved.|
|A1.L||Pointer to pointer to list.||A1.L||See Notes.|
No errors are returned by this vector call.
The examples below show a list being started and an item being unlinked.
The pointer to the list is the long word at ptr(A6) and that items are located at item1(A6), item2(A6), item3(A6) etc.
Init_l lea ptr(a6),a1 ; Pointer to pointer to list. clr.l (a1) ; 1st pointer must be zero. lea item1(a6),a0 ; Item to be set in the list movea.w UT_LINK,a2 ; UT_LINK vector address. jsr (a2) ; Make the call ; Now ptr(a6) contains the address of item1(a6). Unlink lea ptr(a6),a1 ; Pointer to pointer to list. lea item2(a6),a0 ; Item to be unlinked. movea.w UT_UNLNK,a2 ; UT_UNLNK vector address. jsr (a2) ; Make the call