Functions | |
void | Show_Owner (const char *segment, char *owner) |
void | Show_Owner_By_Key (HC_KEY key, char *owner) |
HC_KEY | KShow_Owner_By_Key (HC_KEY key) |
HC_KEY | KShow_Owner_Original_Key (HC_KEY key) |
void Show_Owner | ( | const char * | segment, | |
char * | owner | |||
) |
Returns the segment which contains a given segment or which contains an item with a given key.
segment | - The name of a segment whose owning segment you wish to find. | |
owner | - The segment which owns segment. Returned to user. Passed by reference always. |
If the key or the segment refers to the root segment ("/"), then there is no owner: owner will be returned as blank or null, and ownerkey will be returned as zero. This is not considered an error---no message is generated.
Show_Owner is nearly the same as:
Open_Segment (segment) Show_Pathname_Expansion ("^", owner) Close_Segment ()(The differences are that Open_Segment() will create segment if it didn't exist, while Show_Owner would just complain, and that the root segment would give indigestion to Show_Pathname_Expansion() of "^").
void Show_Owner_By_Key | ( | HC_KEY | key, | |
char * | owner | |||
) |
Similar to Show_Owner(), but operates on an object referenced by an HC_KEY.
key | - The unique numeric identifier pointing to an object in the database. | |
owner | - The segment which owns segment. Returned to user. Passed by reference always. |
HC_KEY KShow_Owner_By_Key | ( | HC_KEY | key | ) |
Similar to KShow_Owner(), but operates on an object referenced by an HC_KEY.
key | - The unique numeric identifier pointing to an object in the database. |
HC_KEY KShow_Owner_Original_Key | ( | HC_KEY | key | ) |
Similar to KShow_Owner_By_Key(), but returns the original HOOPS key to an object that has been renumbered. If the object has not been renumbered, this function is identical to KShow_Owner_By_Key().
key | - The unique numeric identifier pointing to an object in the database. |