tmm_all_propagation_model_names_list_get()
Note: Requires Terrain Modeling Module functionality
Abstract
Obtains a list of the names of all installed propagation models.
Syntax
tmm_all_propagation_model_names_list_get ()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Value
PrgT_List *
List of names of all installed propagation models.
Header
tmm.h
Example
PrgT_List * tlptr;
PrgT_List_Cell * cell_ptr;
/* print installed propagation models and parameter sets */
tlptr = tmm_all_propagation_model_names_list_get();
for (cell_ptr = prg_list_head_cell_get (tlptr); cell_ptr; cell_ptr = prg_list_cell_next_get (cell_ptr))
{
PrgT_List_Cell * a;
PrgT_List * params;
const char * name = (const char *) prg_list_cell_data_get (cell_ptr);
printf ("%s: ", name);
params = Ets_Pj_Tmm_Propagation_Model_Parameter_Set_Names_List_Get (name);
for (a = prg_list_head_cell_get (params); a; a = prg_list_cell_next_get (a))
{
printf ("%s ", (const char *) prg_list_cell_data_get (a));
}
}
Details
The returned list must be deallocated by the caller with prg_list_destroy (list_ptr, TRUE).
Purpose
Provides access to a list of all installed propagation models. Note that licensed models will appear in the list, but might not be usable if no license is available.
Errors
- None
Reference
- Use the function tmm_available_propagation_model_names_list_get() to get a list of all installed propagation models for which the client has a license.