[Enterprise Extensions only]

ArrayDef::length

Overview The length read and write operations allow the access and update of the length attribute of an array definition (CORBA::ArrayDef) within the Interface Repository.
Original interface ArrayDef Interface
Exceptions CORBA::SystemException


Intended Usage

The length attribute specifies the number of elements in the array. Read and write length operations are supported.

IDL Syntax

  attribute unsigned long length;

Read operations

Input parameters
none
Return values
CORBA::ULong

The returned value is the current value of the length attribute of the array definition (CORBA::ArrayDef) object.

Write operations

Input parameters
CORBA::ULong length

The length parameter is the new value to which the length attribute of the CORBA::ArrayDef object will be set.

Return values
none

Example

  // C++
     // assume that 'this_array' has already been initialized
     CORBA::ArrayDef * this_array;
 
     // change the length attribute of the array definition
     CORBA::ULong new_length = 51;
     this_array-> length (new_length);
 
     // obtain the length of an array definition
     CORBA::ULong returned_length;
     returned_length = this_array-> length ();