Appxweb Meta
Home > Developer > Objects > array


meta - AML object declaration extension - AML object declaration package - AML object declaration data - AML object declaration function - AML object declaration view - AML object declaration scalar - AML object declaration array - AML object declaration pointer - AML object declaration script - AML object declaration call_script - AML object declaration render - AML object declaration navigate - AML object declaration menu - AML object declaration menu - AML object declaration dialog - AML object declaration report - AML object declaration window - AML object declaration

<report>

Figure: Object Chart (array Object Highlighted)
Syntax <report>
Example
 
Element: array
Parent: data
Description: Declaration of a data object having an array data structure. One and two dimensional arrays are supported. Data elements within the array are zero based. That is index 0 refers to the first element of the array.
Occurs: 0 or unbound. (i. e Within the <data> element the <array> element can occur zero or many times.)
 Attribute: AM_data_id
 Description: Unique alphanumeric indentifier of this array data object.
Value Type: string
Value: user defined
Occurs: 1 (i.e required)
 Attribute: scope
 Description: Specifies whether the variable is added to the namespace of the web browsers script host.
Value Type: enumeration
Value:
public - (default) added to namespace of web browsers script host and therefore able to be scripted within the browser.
private - not addded to namespace of web browsers script host
Occurs: 0 or 1 (i.e optional)
 Attribute: state
 Description: Specifies whether variable is able to be changed.
Value Type: enumeration
Value:
variable - (default) value of the variable is able to be changed
constant - value of the variable is constant
volitile - value of the variable is able to be changed but is not saved when data is saved locally to a file
Occurs: 0 or 1 (i.e optional)
 Attribute: format
 Description: Specifies whether the variable’s value is wrapped in a CDATA section.
Value Type: enumeration
Value:
markup - (default) value is considered markup
cdata - causes the value_xxx element value to be wrapped in a CDATA section. Doing so forces the parser to interpret the contents as character data and not markup. For example

<aml:value_html>
   <![CDATA[ <b>The example</b> ]]>
<aml:value_html>

Occurs: 0 or 1 (i.e optional)
 Attribute: rows
 Description: Size of the first dimension of the array. ie Number of rows.
Value Type: unsigned integer eg 1,2,3,4 etc
Value: user defined
Occurs: 1 (i.e required)
 Attribute: cols
 Description: Size of the second dimension of the array. ie Number of columns.
Value Type: unsigned integer
Value: user defined (default=1)
Occurs: 0 or 1 (i.e optional)
 
Element: default_xxx
Parent: array
Description: Default value of items within the array. xxx representing the variable data type. Available types include:

     default_str       default_num       default_int       default_unsignedint       default_byte       default_bool
      default_b64binary       default_hexbinary       default_date       default_time       default_datetime
      default_uri       default_language       default_xml       default_html       default_svg       default_rdf

Note the current version of Meta does not perform validation against the data type of the variable with this functionality planned for future versions.
Value Type: Dependent on the data type.
Value : User defined string/character data consistent with the data type.
Occurs: 0 or 1 (i.e optional)
 
Element: value_xxx
Parent: array
Description: Value of the array item at the specified row column position. xxx representing the variable data type. Available types include:

     value_str       value_num       value_int       value_unsignedint       value_byte       value_bool
      value_b64binary       value_hexbinary       value_date       value_time       value_datetime
      value_uri       value_language       value_xml       value_html       value_svg       value_rdf

Note the current version of Meta does not perform validation against the data type of the variable with this functionality planned for future versions.
Value Type: Dependent on the variable data type.
Value : User defined string/character data consistent with the variable data type.
Occurs: 1 or unbound (i.e the <value_xxx> element appears once or many times within the <array> element with the upper limit being consistent with the number items within the array)
 Attribute: row
 Description: Array element row index (zero based)
Value Type: unsigned integer eg 0, 1,2,3,4 etc
Value: user defined
Occurs: 1 (i.e required)
 Attribute: col
 Description: Array element column index (zero based).
Value Type: unsigned integer
Value: user defined (default=0)
Occurs: 0 or 1 (i.e optional)
 

top