| Programming Guide | |
Reads an occurrence of bundle item data
char *sm_get_bundle_data(char *bundle_name, int item_no, int occur);
bundle_name- The name of the bundle to read. Supply
NULLor empty string to specify the unnamed bundle.item_no- The bundle offset of the item whose data you want to read. Each data item is identified by its offset within the bundle, where the first data item has an offset value of 1.
occur- The occurrence to read from
item_no. If the data item contains only one occurrence, supply a value of 1.
- · Success: A pointer to the buffer that gets the bundle data.
sm_get_bundle_datareads an occurrence from the data itemitem_noand returns a pointer to the data's location. Each occurrence in a bundle item is a null-terminated string. Ifoccuris greater than 1,sm_get_bundle_datatraverses the bundle item until it finds the specified occurrence.Because Panther reuses the memory location in which the bundle data is copied, you should read this data immediately after calling
sm_get_bundle_data.
sm_append_bundle_data, sm_is_bundle