Parm Container Functions

All Parms in OpenVSP are stored in Parm Containers. The functions in this group can be used to work with Parm Containers through the API.

Click here to return to the main page. More...

Functions
string[]	FindContainers ()
string[]	FindContainersWithName (const string &in name)
string	FindContainer (const string &in name, int index)
string	GetContainerName (const string &in parm_container_id)
string[]	FindContainerGroupNames (const string &in parm_container_id)
string[]	FindContainerParmIDs (const string &in parm_container_id)

Detailed Description

Function Documentation

FindContainer()

string FindContainer	(	const string &in	name,
		int	index
	)

Get the ID of a Parm Container with specified name at input index

//===== Get Vehicle Parm Container ID ====//
string veh_id = FindContainer( "Vehicle", 0 );

See also

FindContainersWithName

Parameters

[in]	name	Parm Container name
[in]	index	Parm Container index

Returns

Parm Container ID

FindContainerGroupNames()

string [] FindContainerGroupNames

(

const string &in

parm_container_id

)

Get an array of Parm group names included in the specified Container

string user_ctr = FindContainer( "UserParms", 0 );
 
array<string> @grp_arr = FindContainerGroupNames( user_ctr );
 
Print( "---> UserParms Container Group IDs: " );
for ( int i = 0; i < grp_arr.size(); i++ )
{
    string message = "\t" + grp_arr[i] + "\n";
 
    Print( message );
}

Parameters

[in]

parm_container_id

Parm Container ID

Returns

Array of Parm group names

FindContainerParmIDs()

string [] FindContainerParmIDs

(

const string &in

parm_container_id

)

Get an array of Parm IDs included in the specified Container

//==== Add Pod Geometry ====//
string pod_id = AddGeom( "POD" );
 
//==== Add FeaStructure to Pod ====//
int struct_ind = AddFeaStruct( pod_id );
 
//==== Get Structure Name and Parm Container ID ====// 
string parm_container_name = GetFeaStructName( pod_id, struct_ind );
 
string parm_container_id = FindContainer( parm_container_name, struct_ind );
 
//==== Get and List All Parms in the Container ====// 
array<string> parm_ids = FindContainerParmIDs( parm_container_id );
 
for ( uint i = 0; i < uint(parm_ids.length()); i++ )
{
    string name_id = GetParmName( parm_ids[i] ) + string(": ") + parm_ids[i] + string("\n");
 
    Print( name_id );
}

Parameters

[in]

parm_container_id

Parm Container ID

Returns

Array of Parm IDs

FindContainers()

string [] FindContainers

(

)

Get an array of all Parm Container IDs

array<string> @ctr_arr = FindContainers();
 
Print( "---> API Parm Container IDs: " );
 
for ( int i = 0; i < ctr_arr.size(); i++ )
{
    string message = "\t" + ctr_arr[i] + "\n";
 
    Print( message );
}

Returns

Array of Parm Container IDs

FindContainersWithName()

string [] FindContainersWithName

(

const string &in

name

)

Get an array of Parm Container IDs for Containers with the specified name

array<string> @ctr_arr = FindContainersWithName( "UserParms" );
 
if ( ctr_arr.size() > 0 )            { Print( ( "UserParms Parm Container ID: " + ctr_arr[0] ) ); }

Parameters

[in]

name

Parm Container name

Returns

Array of Parm Container IDs

GetContainerName()

string GetContainerName

(

const string &in

parm_container_id

)

Get the name of the specified Parm Container

string veh_id = FindContainer( "Vehicle", 0 );
 
if ( GetContainerName( veh_id ) != "Vehicle" )         { Print( "---> Error: API GetContainerName" ); }

Parameters

[in]

parm_container_id

Parm Container ID

Returns

Parm Container name