Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xmreptypeaddreverse(3x) [osf1 man page]

XmRepTypeAddReverse(3X) 												   XmRepTypeAddReverse(3X)

NAME
XmRepTypeAddReverse - A representation type manager function that installs the reverse converter for a previously registered representation type SYNOPSIS
#include <Xm/RepType.h> void XmRepTypeAddReverse (rep_type_id) XmRepTypeId rep_type_id; DESCRIPTION
XmRepTypeAddReverse installs the reverse converter for a previously registered representation type. The reverse converter takes a numeri- cal representation type value and returns its corresponding string value. Certain applications may require this capability to obtain a string value to display on a screen or to build a resource file. The values argument of the XmRepTypeRegister function can be used to register representation types with nonconsecutive values or with duplicate names for the same value. If the list of numerical values for a representation type contains duplicate values, the reverse con- verter uses the first name in the value_names list that matches the specified numeric value. For example, if a value_names array has can- cel, proceed, and abort, and the corresponding values array contains 0, 1, and 0, the reverse converter will return cancel instead of abort for an input value of 0. Specifies the identification number of the representation type SEE ALSO
XmRepTypeGetId(3X), XmRepTypeRegister(3X) XmRepTypeAddReverse(3X)

Check Out this Related Man Page

XmRepTypeRegister(3X)													     XmRepTypeRegister(3X)

NAME
XmRepTypeRegister - A representation type manager function that registers a representation type resource SYNOPSIS
#include <Xm/RepType.h> XmRepTypeId XmRepTypeRegister (rep_type, value_names, values, num_values) String rep_type; String *value_names; unsigned char *values; unsigned char num_values; DESCRIPTION
XmRepTypeRegister registers a representation type resource with the representation type manager. All features of the representation type management facility become available for the specified representation type. The function installs a forward type converter to convert string values to numerical representation type values. When the values argument is NULL, consecutive numerical values are assumed. The order of the strings in the value_names array determines the numerical values for the resource. For example, the first value name is 0; the second value name is 1; and so on. If it is non-NULL, the values argument can be used to assign values to representation types that have nonconsecutive values or have dupli- cate names for the same value. Representation types registered in this manner will consume additional storage and will be slightly slower than representation types with consecutive values. A representation type can only be registered once; if the same representation type name is registered more than once, the behavior is unde- fined. The function XmRepTypeAddReverse installs a reverse converter for a registered representation type. The reverse converter takes a repre- sentation type numerical value and returns the corresponding string value. If the list of numerical values for a representation type con- tains duplicate values, the reverse converter uses the first name in the value_names list that matches the specified numeric value. For example, if a value_names array has cancel, proceed, and abort, and the corresponding values array contains 0, 1, and 0, the reverse con- verter will return cancel instead of abort for an input value of 0. Specifies the representation type name. Specifies a pointer to an array of value names associated with the representation type. A value name is specified in lowercase characters without an "Xm" prefix. Words within a name are separated with underscores. Specifies a pointer to an array of values associated with the representation type. A value in this array is associated with the value name in the corresponding position of the value_names array. Specifies the number of entries in the value_names and values arrays. RETURN VALUE
Returns the identification number for the specified representation type. SEE ALSO
XmRepTypeAddReverse(3X), XmRepTypeGetId(3X), XmRepTypeGetNameList(3X), XmRepTypeGetRecord(3X), XmRepTypeGetRegistered(3X), XmRepTypeValid- Value(3X) XmRepTypeRegister(3X)
Man Page