Functions | |
void | Create_Segment (const char *segment) |
HC_KEY | KCreate_Segment (const char *segment) |
void Create_Segment | ( | const char * | segment | ) |
Brings a segment into existence without opening it.
segment | - Name of the segment. |
Once in a while, you need to create a segment in advance of being ready to insert information into it. Include_Segment() and Style_Segment() , for example, require that the specified segment exist at the time of the call. Create_Segment() is an easy way to make the segment exist even if you're not ready to put something into it.
Create_Segment() is provided as a utility routine. It is absolutely identical to an Open_Segment() followed immediately by a Close_Segment() . You can open the segment again later, by name of course. Or if it's more convenient, by the key returned from KCreate_Segment() .
HC_KEY KCreate_Segment | ( | const char * | segment | ) |
Similar to Create_Segment(), but returns an HC_KEY to the object.
segment | - Name of the segment. |