tmm_available_propagation_model_names_list_get()
Note: Requires Terrain Modeling Module functionality
Abstract
Obtains a list of the names of all propagation models that are available for use.
Syntax
tmm_available_propagation_model_names_list_get ()
| Argument | Type | Description |
|---|---|---|
| no arguments |
Return Value
PrgT_List *
List of names of all propagation models that are available for use.
Header
tmm.h
Example
PrgT_List * tlptr;
PrgT_List_Cell * cell_ptr;
/* print available propagation models and parameter sets */
tlptr = tmm_available_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));
}
}
prg_list_destroy (tlptr, TRUE);
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 that either are unlicensed or are licensed and have a license available.
Errors
- None
Reference
- Use the function tmm_all_propagation_model_names_list_get() to get a list of all installed propagation models, whether or not available for use.