View source for CATable::GetDataByLabels

[[Category:ADE User Guide]]
[[ADE User Guide]] > [[ADE Server Class Reference]] > [[CATable]]
<languages />
<translate>
= [[CATable]]::GetDataByLabels(indexLabels) = <!--T:1-->

<!--T:2-->
Retrieves the value of an input table cell according to «indexLabels», which specify the label for each index of the table in order.

<!--T:3-->
The parameter specifies the coordinates of a cell in the table, using the index labels ([[CATable::GetDataByElements]] does the same using index position).  When the table is one dimensional, indexLabels can be a single value -- a text value when the index is a list-of-labels, or a number when the index is a numeric list.   Otherwise, indexLabels must be an array with ''N'' elements when the table is ''N''-dimensional.

<!--T:4-->
The order of the dimensions, as they are listed in «indexLabels», is determined by a previous call to [[CATable::SetIndexOrder]].

<!--T:5-->
The return value is the value of the table cell.  The manner in which this value is returned is determined by the [[CATable::RenderingStyle]].  

<!--T:6-->
When the result table is zero-dimensional (i.e., atomic, not an array), you must use [[CATable::AtomicValue]] to access the value.

= Examples = <!--T:7-->

== In VB == <!--T:8-->

 <!--T:9-->
dim editTab as CATable = var2d.DefTable

 <!--T:10-->
dim indexLabs(1)   ' Contains two elements, (0) and (1)
 indexLabs(0) = 3
 indexLabs(1) = "green"
 editTab.SetIndexOrder( Split("I,J",",") )
 
 ET = editTab.GetDataByLabels(indexLabs)

 <!--T:11-->
dim resTab as CATable = var2d.ResultTable
 resTab.SetIndexOrder( Split("I,J",","))
 RT = resultTab.GetDataByLabels(indexLabs)

 <!--T:12-->
RT1 = var1d.ResultTable.GetDataByLabels("red")

= Error Codes = <!--T:13-->

<!--T:14-->
:24 – “Subscripts must be an array of variants”
:25 – “Subscripts cannot be accessed”
:26 – “Lower bound of subscript array inaccessible”
:27 – “Upper bound of subscript array inaccessible”
:28 – “Must specify at least one element in table”
:30 – “Position does not exist”

= See Also = <!--T:15-->

<!--T:16-->
* [[CATable::SetIndexOrder]]
* [[CATable::RenderingStyle]] and [[CARenderingStyle]]
* [[CATable::GetDataByElements]]
* [[CATable::AtomicValue]]
* [[CATable::GetSafeArray]]
* [[CATable::SetDataByLabels]] and [[CATable::SetDataByElements]]
* [[CATable::Subscript]] and [[CATable::Slice]]
</translate>