XmTabListCopy(3X) UNIX System V XmTabListCopy(3X)
NAME
XmTabListCopy - A convenience function that creates a new
tab list from an existing list
SYNOPSIS
#include <Xm/Xm.h>
XmTabList XmTabListCopy(
XmTabList tablist,
int offset,
Cardinal count);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmTabListCopy creates a new tab list consisting of a copy of
a portion of the contents of the tablist argument. This
function starts copying at the specified offset value of the
tab list and copies count values.
tablist Specifies a tab list to be copied.
offset Specifies where to start copying. A value of 0
(zero) indicates begin at the beginning, a value
of 1 indicates to skip the first tab, and so on. A
negative indicates to begin counting backwards
from the end. A value of -1 indicates to start
copying from the last tab.
count Specifies the number of tabs to copy. A value of 0
(zero) indicates to copy all elements from the
starting point to the end (beginning if offset is
negative) of the tab list.
RETURN
If tablist is NULL, this function returns NULL. Otherwise,
this function returns a newly allocated XmTabList. If the
function does allocate an XmTabList, then the application is
responsible for managing the allocated space. The
application can recover the allocated space by calling
XmTabListFree.
RELATED
XmTabList(3) and XmTabListFree(3).
Page 1 (printed 1/22/99)