9.3.79 LBOUND (ARRAY [,DIM])

Description:  Returns the lower bounds for all dimensions of an array, or the lower bound for a specified dimension. 
Class:  Inquiry function; Generic 
Arguments:  ARRAY Must be an array (of any data type). It must not be an allocatable array that is not allocated, or a disassociated pointer. 
  DIM (opt) Must be a scalar integer with a value in the range 1 to n, where n is the rank of ARRAY.  
Results:  The result type is default integer. If DIM is present, the result is a scalar. Otherwise, the result is a rank- one array with one element for each dimension of ARRAY. Each element in the result corresponds to a dimension of ARRAY.

If ARRAY is an array section or an array expression that is not a whole array or array structure component, each element of the result has the value 1.

If ARRAY is a whole array or array structure component, LBOUND (ARRAY, DIM) has a value equal to the lower bound for subscript DIM of ARRAY (if ARRAY(DIM) is nonzero). If ARRAY(DIM) has size zero, the corresponding element of the result has the value 1. 


Consider the following:

REAL ARRAY_A (1:3, 5:8)
REAL ARRAY_B (2:8, -3:20)

LBOUND (ARRAY_A) is (1, 5). LBOUND (ARRAY_A, DIM=2) is 5.

LBOUND (ARRAY_B) is (2, -3). LBOUND (ARRAY_B (5:8, :)) is (1,1) because the arguments are array sections.

Previous Page Next Page Table of Contents