Functions | |
void | Rename_Segment (const char *old, const char *new) |
void | Move_Segment (const char *old, const char *new) |
void Rename_Segment | ( | const char * | old, | |
const char * | new | |||
) |
Changes the name of a segment, and/or moves it somewhere else in the segment tree.
old | - Segment(s) to be renamed. | |
new | - Can name to use. May contain a "/*" on the end, but not any other wildcards (see below). |
If the new 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 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 is a blank or null string, the existing name of old, if any, is removed. The segment becomes a "nameless" segment (see Open_Segment() .)
void Move_Segment | ( | const char * | old, | |
const char * | new | |||
) |
Changes the name of a segment, and/or moves it somewhere else in the segment tree.
old | - Segment(s) to be renamed. | |
new | - Can name to use. May contain a "/*" on the end, but not any other wildcards. |