Aggiunge un alias alla sezione dati.
Sintassi |
bool add_alias(const string &in name, const string &in target_name, const string &in target_path='') |
|---|---|
name |
Nome dell'alias (o origine) |
source_name |
Nome dell'elemento destinazione |
source_path |
Percorso dell'elemento destinazione (opzionale) |
Risultato |
Rende riferimento a nuova sezione dati creata, sezione nulla altrimenti |
Note |
Il nome dell'alias e il nome dell'elemento destinazione non possono contenere il carattere (|). L'elemento di destinazione può essere sia una variabile che una sezione dati figlia. Il percorso dell'elemento destinazione può contenere il carattere (|) come separatore di sezioni, il carattere (.) come sezione corrente, il carattere (..) come sezione parente. Se il percorso inizia con il carattere (|) è definito assoluto facendo riferimento all'elemento radice del documento, altrimenti è definito relativo facendo riferimento alla sezione dati stessa. |
Esempio di utilizzo:
fdoc::section @data;
// Nuova variabile salvata come v1, precedente era old_v1 data.write_int32("v1", 1000);
// Nuova variabile salvata come v2, precedentemente era old_v2, ora // spostata in sezione parent, sotto-sezione vars data.write_int32("v2", 1000);
// Se variabile v3 non esistente, viene cercata old_v3 int32 v3; data.add_alias("v3", "old_v3"); data.read_int32("v3", v3, 0);
// Se variabile v4 non esistente, viene cercata old_v4 nella sezione // parent, sotto-sezione vars int32 v4; data.add_alias("v4", "old_v4", "..|vars"); data.read_int32("v4", v4, 0);
|
