dbMoveGroupMember

dbMoveGroupMember( 
d_groupMem1 
[ d_groupMem2 ] 
) 
=> t / nil 

Description

Moves group member d_groupMem1 immediately after group member d_groupMem2.

Moving group members within a group is how members of ordered groups are reorganized. Group must be ordered and both members must belong to the same group.

Arguments

d_groupMem1	dbObject of the group member to be moved to a new position.
d_groupMem2	dbObject of the group member whose position is right before d_groupMem1 when the move is completed. If not passed or nil, d_groupMem1 is moved to the first position of the list.

Value Returned

t	The move was successful or if d_groupMem1 equals d_groupMem2.
nil	The group member is not moved.

Examples

g = dbCreateGroup(cv "GROUP" list("set" "ordered"))

a = dbAddObjectToGroup(g obj1)

b = dbAddObjectToGroup(g obj2)

c = dbAddObjectToGroup(g obj3)

d = dbAddObjectToGroup(g obj4)

dbMoveGroupMember(b c)

dbMoveGroupMember(d)

Related Topics

Group Creation and Modification Functions

Return to top