Reads an occurrence of bundle item datachar *sm_get_bundle_data(char *bundle_name, int item_no, int occur);
- The name of the bundle to read. Supply
NULLor empty string to specify the unnamed bundle.
- 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.
- The occurrence to read from
item_no. If the data item contains only one occurrence, supply a value of 1.
sm_get_bundle_datareads an occurrence from the data item
item_noand returns a pointer to the data's location. Each occurrence in a bundle item is a null-terminated string. If
occuris 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