## On this page
# Interface ModelCenter::IReferenceArray
Last update: 16.07.2025
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5149)
COM Instance.
**Inherits from**:
- [ModelCenter::IArray](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray)
## Members
- [autoGrow](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a74f194b29d46aacb12b7d4c445df729b)
- [autoSize](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1aca63a47369d69cbbf53532286b64a611)
- [createRefProp](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a9e2914c70c8c77002c0dbc502cdfa056)
- [dependentLinks](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1add9bd8c41cd4a5c77f7e762768b441a5)
- [dependents](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a7a3b136537fb09914b87b5997b937df0)
- [directDependents](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a862a4306dbf867e3db316d9547cea277)
- [directPrecedents](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1aa8041fca418266f2bee129804654abab)
- [fromString](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a9cb9dab871b4e86ed66fb53cc5473ebd)
- [fromStringEx](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a2a286a07b606f7e90ac4e1d281a49d38)
- [getDimensions](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a83abe70ccf5e8a0a582748d84e3d7956)
- [getFullName](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a44ebe17869a3b1b95568ea46299a9f3f)
- [getLength](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ad88eff947daa184ab953839666729ae5)
- [getMetadata](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ac6becc1bb1c5206e972c266164f838ca)
- [getName](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a282d98574e8d65d85c9908b6799321b7)
- [getRefPropValue](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1aecab78945a16a827081638609b48318d)
- [getRefPropValueAbsolute](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a76d1cee0ac71a9682e7ff9af6df9cf77)
- [getSize](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a3d171136e0b219dd4e2d0d1b4bb9aa1f)
- [getType](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ac3c3f33a239fe1182da434d7570346df)
- [getValue](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a32db352eed1650697f8b164546ea3eeb)
- [getValueAbsolute](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a9233b22b8ad38b1abf30bc68d543d789)
- [hasChanged](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a32bab88b29119d84a6429364fd651411)
- [hide](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a35c7c4ee97058e1636c56d4863c58e00)
- [invalidate](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a56ea1d83eb42dda4a7c06b6fbbf6ffd5)
- [isInput](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ae7e5c76cfd592a71fc7e5785c7cf6394)
- [isInputToComponent](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a317b7b47fa55798e212c426b4ac8f014)
- [isInputToModel](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a2d16dbc50ee0f77d5ca99b8a600e5023)
- [isValid](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a366cf132edcae4c78ff3c3c29d81ad03)
- [length](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1af118bdf4b120050d6700a7ceae7f5bec)
- [numDimensions](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a05a8f727001f8d1794bc33960736fd18)
- [OwningComponent](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a4b37dc07f0e626f6b833b772d57b06a3)
- [precedentLinks](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a084d49d02b9ff5812166721fcdc86018)
- [precedents](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1aea1973c58e45bafe3aeea797b91a4f6b)
- [reference](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a60216339479fb364f7e97cb5d9ea0b66)
- [reference](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1acd5c00c533970d30757f90445ec376cd)
- [referencedVariable](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1abb922c879568308b8c074165d596777e)
- [referencedVariables](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ad2c0541925f15b29800a9e924916615a)
- [setDimensions](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a3526172d364bb842ab3bc25f1cedf31b)
- [setLength](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a2cfaecd2a821841d414f0d9ac505659f)
- [setMetadata](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a31e14e94dd9316f40bf963a9da9939f7)
- [setRefPropValue](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a93e2bd4cf0f592ca8ec2a626fbd57432)
- [setSize](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a8b7b41ca5463a86aecb2368d73464c0e)
- [setValue](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a8ef388f09dd24fd704b46a7446016951)
- [size](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a0ec169188c7e660a32e9a3bc6792d26f)
- [toString](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1aaa37debc6216a5419715e0c542555850)
- [toStringAbsolute](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a1a0ecbbccb3fe3404c79976e9f07b8db)
- [toStringAbsoluteEx](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1aac2b33985ad310362db7c8c878096ae8)
- [toStringEx](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1af2ff697565c81552d49c0237cfc89ef7)
- [validate](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1af1dd28c351fcda3e3fea31facbd4fca3)
- [value](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1ad9e0cf09c5c40b6272808d3ba83489ba)
- [value](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a902f599bd7fe0bed1c5f1f51a49e291e)
## Properties
### Property hasChanged
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
boolean ModelCenter::IReferenceArray::hasChanged
```
**Return type**: boolean
### Property hide
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
boolean ModelCenter::IReferenceArray::hide
```
**Return type**: boolean
### Property OwningComponent
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
LPDISPATCH ModelCenter::IReferenceArray::OwningComponent
```
**Return type**: LPDISPATCH
### Property size
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
long ModelCenter::IReferenceArray::size
```
**Return type**: long
### Property numDimensions
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
long ModelCenter::IReferenceArray::numDimensions
```
**Return type**: long
### Property autoGrow
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 1)
```
boolean ModelCenter::IReferenceArray::autoGrow
```
Whether or not the reference array is set to automatically grow.
**Return type**: boolean
### Property value
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5224)
```
long ModelCenter::IReferenceArray::value
```
Value of an array element.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
**Return type**: long
### Property value
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5231)
```
double ModelCenter::IReferenceArray::value( long index)(long index)
```
Value of an array element.
**Parameters**:
- **index**: Index of the array element (0-based index).
- **newValue**:
**Return type**: double
### Property reference
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5239)
```
long ModelCenter::IReferenceArray::reference
```
Reference of an array element.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
**Return type**: long
### Property reference
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5246)
```
BSTR ModelCenter::IReferenceArray::reference( long index)(long index)
```
Reference of an array element.
**Parameters**:
- **index**: Index of the array element (0-based index).
- **newValue**:
**Return type**: BSTR
### Property referencedVariables
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5307)
```
long ModelCenter::IReferenceArray::referencedVariables
```
Gets the reference variables of the index element of the array.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
The references variables of the element.
**Return type**: long
### Property referencedVariable
**Definition**: `ModelCenter/src/ModelCenter.odl` (line 5316)
```
long ModelCenter::IReferenceArray::referencedVariable
```
Gets the reference variable of the index element of the array. Convenience method for if the indexed variable only has one reference.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
The reference variable of the index element.
**Return type**: long
## Public functions
### Function isValid
```
boolean ModelCenter::IReferenceArray::isValid()
```
Finds out whether or not the array is valid.
**Returns**:
yes(TRUE) or no(FALSE).
**Return type**: boolean
**Reimplements**: [isValid](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a20792cdbe6866825f978a2e30affca88)
### Function validate
```
void ModelCenter::IReferenceArray::validate()
```
Causes the array to validate itself.
**Return type**: void
**Reimplements**: [validate](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a31cda88a70c11ef884e9105ef4ee7d20)
### Function getName
```
BSTR ModelCenter::IReferenceArray::getName()
```
Gets the name of the array.
**Returns**:
The name of the array.
**Return type**: BSTR
**Reimplements**: [getName](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1ace7a0aeb83a64535f7caa63600783fa7)
### Function getFullName
```
BSTR ModelCenter::IReferenceArray::getFullName()
```
Gets the full ModelCenter path of the array.
**Returns**:
The full ModelCenter path of the array.
**Return type**: BSTR
**Reimplements**: [getFullName](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a699cf890f3743699cb25a7432c0f7f68)
### Function getType
```
BSTR ModelCenter::IReferenceArray::getType()
```
Gets the type of the array.
**Returns**:
The type of the array as a string.
**Return type**: BSTR
**Reimplements**: [getType](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1adf1ee02ba4bdf03ef0366e2f0a62b344)
### Function isInput
```
boolean ModelCenter::IReferenceArray::isInput()
```
Finds out whether or not the variable is an input with respect to the model. Returns the same value as [isInputToModel](interfaceModelCenter_1_1IReferenceArray.md#interfaceModelCenter_1_1IReferenceArray_1a2d16dbc50ee0f77d5ca99b8a600e5023).
**Return values**:
- **true**: Input
- **false**: Output
**Return type**: boolean
**Reimplements**: [isInput](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1af18eb203bc12f95a61b5876279ee17a9)
### Function toString
```
BSTR ModelCenter::IReferenceArray::toString()
```
Converts the array to a string, validating the array if necessary. If the variable is an array, it will to be of the form `"1, 2, 3"` for one-dimensional arrays or `"bounds[3,3] {1, 2, 3, 4, 5, 6, 7, 8, 9}"` for multi-dimensional arrays.
**Returns**:
The converted string value of the array.
**Return type**: BSTR
**Reimplements**: [toString](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a6ff821435a5704253ffdfb9334cc2dc4)
### Function fromString
```
void ModelCenter::IReferenceArray::fromString(BSTR value)
```
Sets the value of the array from a specified string. For `1D` arrays, the specification is of the form `'1,2,3'`.
For `nD` arrays, the specification is of the form `'bounds[2,2,2] {1,2,3,4,5,6,7,8}'`.
String arrays may optionally have the elements quoted in the form `'bounds[2,3] {"a", "b,c", "d", "", "e", "f"}'`
**Parameters**:
- **value**: New value.
**Parameters**:
- BSTR **value**
**Return type**: void
**Reimplements**: [fromString](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a97b06c86c2783603221e0b0215dc75c8)
### Function toStringAbsolute
```
BSTR ModelCenter::IReferenceArray::toStringAbsolute()
```
Converts the array to a string. If the variable is an array, it will to be of the form `"1, 2, 3"` for one-dimensional arrays or `"bounds[3,3] {1, 2, 3, 4, 5, 6, 7, 8, 9}"` for multi-dimensional arrays.
**Returns**:
The converted string value of the array.
**Return type**: BSTR
**Reimplements**: [toStringAbsolute](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1ad5ecd4799e995bf2c97015c718606550)
### Function invalidate
```
void ModelCenter::IReferenceArray::invalidate()
```
Marks the variable as invalid (needs to be computed). This will set all dependent variables invalid also.
**Return type**: void
**Reimplements**: [invalidate](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1abfaa3f2b5bff1412199f5014ca10c4d5)
### Function directPrecedents
```
LPDISPATCH ModelCenter::IReferenceArray::directPrecedents([optional]VARIANT followSuspended, [optional]VARIANT reserved)
```
Returns a list of variables that are immediate precedents to the value of this variable. This function returns all variables that influence this variable and are directly connected via a link to it.
**Parameters**:
- **followSuspended**: Optional boolean specifies whether links which are suspended should be included in the search. Default is false.
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariables](interfaceModelCenter_1_1IVariables.md#interfaceModelCenter_1_1IVariables) object.
**Parameters**:
- *\[optional\]* VARIANT **followSuspended**
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [directPrecedents](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a0367bcfe5c12848d1d10e1266a0a868e)
### Function directDependents
```
LPDISPATCH ModelCenter::IReferenceArray::directDependents([optional]VARIANT followSuspended, [optional]VARIANT reserved)
```
Returns a list of variables that are immediate dependents of the value of this variable. This function returns all variables that are influenced by this variable and are directly connected via a link to it.
**Parameters**:
- **followSuspended**: Optional boolean specifies whether links which are suspended should be included in the search. Default is false.
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariables](interfaceModelCenter_1_1IVariables.md#interfaceModelCenter_1_1IVariables) object.
**Parameters**:
- *\[optional\]* VARIANT **followSuspended**
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [directDependents](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a834a8ad8bfec0c4b0220b21979e82fca)
### Function precedentLinks
```
LPDISPATCH ModelCenter::IReferenceArray::precedentLinks([optional]VARIANT reserved)
```
Returns a list of links that are immediate precedents to the value of this variable. All the returned links will have this variable as the LHS of the equation. Except for arrays, the returned list will be 1 element long.
**Parameters**:
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariableLinks](interfaceModelCenter_1_1IVariableLinks.md#interfaceModelCenter_1_1IVariableLinks) object.
**Parameters**:
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [precedentLinks](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a8f2364939bd5efaab13ecdbc3cb7df51)
### Function dependentLinks
```
LPDISPATCH ModelCenter::IReferenceArray::dependentLinks([optional]VARIANT reserved)
```
Returns a list of links that immediately depend on the value of this variable. All the returned links will have this variable as part of a RHS equation.
**Parameters**:
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariableLinks](interfaceModelCenter_1_1IVariableLinks.md#interfaceModelCenter_1_1IVariableLinks) object.
**Parameters**:
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [dependentLinks](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1aecc2dc18b0ee43d5175503d44ca259c3)
### Function precedents
```
LPDISPATCH ModelCenter::IReferenceArray::precedents([optional]VARIANT followSuspended, [optional]VARIANT reserved)
```
Returns a list of variables that are precedents to the value of this variable. This function returns all variables that influence this variable, not just directly connected ones.
**Parameters**:
- **followSuspended**: Optional boolean specifies whether links which are suspended should be included in the search. Default is false.
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariables](interfaceModelCenter_1_1IVariables.md#interfaceModelCenter_1_1IVariables) object.
**Parameters**:
- *\[optional\]* VARIANT **followSuspended**
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [precedents](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1ab185a76064278e30ee48682164364e72)
### Function dependents
```
LPDISPATCH ModelCenter::IReferenceArray::dependents([optional]VARIANT followSuspended, [optional]VARIANT reserved)
```
Returns a list of variables that are dependent upon the value of this variable. This function returns all variables that are influenced by this variable, not just directly connected ones.
**Parameters**:
- **followSuspended**: Optional boolean specifies whether links which are suspended should be included in the search. Default is false.
- **reserved**: Reserved for future use.
**Returns**:
IDispatch\* to an [IVariables](interfaceModelCenter_1_1IVariables.md#interfaceModelCenter_1_1IVariables) object.
**Parameters**:
- *\[optional\]* VARIANT **followSuspended**
- *\[optional\]* VARIANT **reserved**
**Return type**: LPDISPATCH
**Reimplements**: [dependents](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a7cb300d678991e0b6449ad7b0d004906)
### Function isInputToComponent
```
boolean ModelCenter::IReferenceArray::isInputToComponent()
```
Checks whether or not the variable is an input. Returns true if the variable was originally added as an input, ignoring the current state that can change based off of links.
**Return values**:
- **true**: Input
- **false**: Output
**Return type**: boolean
**Reimplements**: [isInputToComponent](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a74e3e9729c8de2d3d091a6f22f7cb45b)
### Function isInputToModel
```
boolean ModelCenter::IReferenceArray::isInputToModel()
```
Checks whether or not the variable is an input. A linked input returns false (Output).
**Return values**:
- **true**: Input
- **false**: Output
**Return type**: boolean
**Reimplements**: [isInputToModel](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a87cc3a01fd30ce7c6380b5d1d6ff7df9)
### Function setMetadata
```
void ModelCenter::IReferenceArray::setMetadata(BSTR name, MetadataType type, VARIANT value, MetadataAccess access, boolean archive)
```
Sets the meta data value of the given meta data key name.
**Parameters**:
- **name**: Metadata specifier used to store the data.
- **type**:
- **value**:
- **access**:
- **archive**:
**Parameters**:
- BSTR **name**
- [MetadataType](namespaceModelCenter.md#namespaceModelCenter_1a59560dc5274b3a18daae06b531055153) **type**
- VARIANT **value**
- [MetadataAccess](namespaceModelCenter.md#namespaceModelCenter_1afea526d882aa1a4fd48b5a28b7b1c9dc) **access**
- boolean **archive**
**Return type**: void
**Reimplements**: [setMetadata](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a8b1a6f24260a22b01e738ed2fb1d4523)
### Function getMetadata
```
VARIANT ModelCenter::IReferenceArray::getMetadata(BSTR name)
```
Gets the meta data value of the given meta data key name.
**Parameters**:
- **name**: Metadata key name.
**Returns**:
Metadata value.
**Parameters**:
- BSTR **name**
**Return type**: VARIANT
**Reimplements**: [getMetadata](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a53f2d3f772584c3c43341ff4236402c9)
### Function toStringEx
```
BSTR ModelCenter::IReferenceArray::toStringEx(long index)
```
Converts the value of an array element to a string, validating the array if necessary.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
The value of the element as a string.
**Parameters**:
- long **index**
**Return type**: BSTR
**Reimplements**: [toStringEx](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a37c622ae9f50579f714ce98c0379cd98)
### Function fromStringEx
```
void ModelCenter::IReferenceArray::fromStringEx(BSTR value, long index)
```
Sets the value of an array element from a specified string.
**Parameters**:
- **value**: New value.
- **index**: Index of the array element (0-based index).
**Parameters**:
- BSTR **value**
- long **index**
**Return type**: void
**Reimplements**: [fromStringEx](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1ad23f4082662c464be07251d6d1695a2d)
### Function toStringAbsoluteEx
```
BSTR ModelCenter::IReferenceArray::toStringAbsoluteEx(long index)
```
Converts the value of an array element to a string.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
The value of the element as a string.
**Parameters**:
- long **index**
**Return type**: BSTR
**Reimplements**: [toStringAbsoluteEx](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a2e3041440581aab716c684fe88d2ee87)
### Function getLength
```
long ModelCenter::IReferenceArray::getLength([optional] VARIANT dim)
```
Get the length of the n'th dimension of the array.
**Parameters**:
- **dim**: Dimension of the array to query. This uses a 0 based index, so 0 will give you the first dimension, 1 the second, etc. If omitted, gives the first dimension
**Returns**:
Length(size) of the array.
**Parameters**:
- *\[optional\]* VARIANT **dim**
**Return type**: long
**Reimplements**: [getLength](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1a8a6965fe1217428d63d594384a634bfb)
### Function setLength
```
void ModelCenter::IReferenceArray::setLength(long length, [optional] VARIANT dim)
```
Sets the length of the n'th dimension of the array
**Parameters**:
- **length**: New length of the n'th dimension of the array
- **dim**: The dimension to set. This uses a 0 based index, so 0 will set the first dimension, 1 the second, etc. If omitted, sets the first dimension
**Parameters**:
- long **length**
- *\[optional\]* VARIANT **dim**
**Return type**: void
**Reimplements**: [setLength](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1ac632aa0e8bc7a6fcac41245e151beec8)
### Function setDimensions
```
void ModelCenter::IReferenceArray::setDimensions(long d1, [optional] VARIANT d2, [optional] VARIANT d3, [optional] VARIANT d4, [optional] VARIANT d5, [optional] VARIANT d6, [optional] VARIANT d7, [optional] VARIANT d8, [optional] VARIANT d9, [optional] VARIANT d10)
```
Sets the number of dimensions of an array and the length of each dimension in one call. An array initializes to 0 length. If any dimension of the array has 0 length, the whole array contains no data. You must set the array size before filling in values unless you are using the setArray() call.
**Parameters**:
- **d1**: length of the 1st dimension of the array
- **d2**: length of the 2nd dimension of the array. If omitted, the array is 1 dimensional
- **d3**: length of the 3rd dimension of the array. If omitted, the array is 2 dimensional
- **d4**: length of the 4th dimension of the array. If omitted, the array is 3 dimensional
- **d5**: length of the 5th dimension of the array. If omitted, the array is 4 dimensional
- **d6**: length of the 6th dimension of the array. If omitted, the array is 5 dimensional
- **d7**: length of the 7th dimension of the array. If omitted, the array is 6 dimensional
- **d8**: length of the 8th dimension of the array. If omitted, the array is 7 dimensional
- **d9**: length of the 9th dimension of the array. If omitted, the array is 8 dimensional
- **d10**: length of the 10th dimension of the array. If omitted, the array is 9 dimensional
**Parameters**:
- long **d1**
- *\[optional\]* VARIANT **d2**
- *\[optional\]* VARIANT **d3**
- *\[optional\]* VARIANT **d4**
- *\[optional\]* VARIANT **d5**
- *\[optional\]* VARIANT **d6**
- *\[optional\]* VARIANT **d7**
- *\[optional\]* VARIANT **d8**
- *\[optional\]* VARIANT **d9**
- *\[optional\]* VARIANT **d10**
**Return type**: void
**Reimplements**: [setDimensions](interfaceModelCenter_1_1IArray.md#interfaceModelCenter_1_1IArray_1af881060e37aae0ff4c2c2238683db950)
### Function getValue
```
double ModelCenter::IReferenceArray::getValue(int index)
```
Gets the value of an array element.
**Parameters**:
- **index**: Index of the array element (0-based index).
**Returns**:
The value.
**Parameters**:
- int **index**
**Return type**: double
### Function setValue
```
double ModelCenter::IReferenceArray::setValue(double value, int index)
```
Sets the value of an array element.
**Parameters**:
- **value**: New value.
- **index**: Index of the array element (0-based index).
**Returns**:
**Parameters**:
- double **value**
- int **index**
**Return type**: double
### Function createRefProp
```
IDispatch * ModelCenter::IReferenceArray::createRefProp(BSTR name, BSTR type)
```
Creates a reference property for the array.
**Parameters**:
- **name**: Name of the reference property.
- **type**: Type of reference property to create.
Allowed types are: double, long, boolean, and string.
**Returns**:
IDispatch\* to an [IRefArrayProp](interfaceModelCenter_1_1IRefArrayProp.md#interfaceModelCenter_1_1IRefArrayProp) object.
**Parameters**:
- BSTR **name**
- BSTR **type**
**Return type**: IDispatch \*
### Function getRefPropValue
```
VARIANT ModelCenter::IReferenceArray::getRefPropValue(BSTR name, int index)
```
Gets the value of a specified reference property for an element in the array.
**Parameters**:
- **name**: Name of the reference property.
- **index**: Index of the array element (0-based index).
**Returns**:
The value as a variant.
**Parameters**:
- BSTR **name**
- int **index**
**Return type**: VARIANT
### Function setRefPropValue
```
void ModelCenter::IReferenceArray::setRefPropValue(BSTR name, int index, BSTR value)
```
Sets the value of a specified reference property for an element in the array.
**Parameters**:
- **name**: Name of the reference property.
- **index**: Index of the array element (0-based index).
- **value**: New value.
**Parameters**:
- BSTR **name**
- int **index**
- BSTR **value**
**Return type**: void
### Function getRefPropValueAbsolute
```
VARIANT ModelCenter::IReferenceArray::getRefPropValueAbsolute(BSTR name, int index)
```
Gets the value of a specified reference property for an element in the array without running to validate.
**Parameters**:
- **name**: Name of the reference property.
- **index**: Index of the array element (0-based index).
**Returns**:
The value as a variant.
**Parameters**:
- BSTR **name**
- int **index**
**Return type**: VARIANT
### Function getValueAbsolute
```
double ModelCenter::IReferenceArray::getValueAbsolute(int index)
```
gets the value of the variable at a specific location without validating.
**Parameters**:
- **index**: The array element index (0-based index).
**Returns**:
The reference value.
**Parameters**:
- int **index**
**Return type**: double