Functions | |
void | Rename_Segment (const char *old_seg_name, const char *new_seg_name) |
void | Move_Segment (const char *old_seg_name, const char *new_seg_name) |
void Rename_Segment | ( | const char * | old_seg_name, | |
const char * | new_seg_name | |||
) |
Changes the name of a segment, and/or moves it somewhere else in the segment tree.
old_seg_name | - Segment(s) to be renamed. | |
new_seg_name | - New name to use. May contain a "/*" on the end, but not any other wildcards (see below). |
If the new_seg_name specification contains a wildcard on the end, that wildcard gets matched with the lowest-level name on the incoming segment. For example, a rename from
"A/B/C" to "D/*" results in a segment named "D/C". More commonly, you would use a wildcard on the new_seg_name segment name only if you were using wildcards on the input name too, such as renaming from "A/B/*" to "D/*".
Include_Segment() and Style_Segment() references to a segment being Renamed will be left attached, even though the segment now has a name different from that specified in the original call to Include or Style.
If new_seg_name is a blank or null string, the existing name of old_seg_name, if any, is removed. The segment becomes a "nameless" segment (see Open_Segment() .)
void Move_Segment | ( | const char * | old_seg_name, | |
const char * | new_seg_name | |||
) |
Changes the name of a segment, and/or moves it somewhere else in the segment tree.
old_seg_name | - Segment(s) to be renamed. | |
new_seg_name | - New name to use. May contain a "/*" on the end, but not any other wildcards. |