+
Point of view
All features
class FAST_ARRAY3 [E_]
Summary
Resizable three dimensional array. Unlike ARRAY3, the lower1, lower2 and lower3 bounds are frozen to 0. Thus, one can expect better performances.
Direct parents
Inherit list: COLLECTION3
Insert list: NATIVE_ARRAY_COLLECTOR
Class invariant
Overview
Creation features
{ANY}
Features
{ANY}
{}
{FAST_ARRAY3}
{ANY}
Implementation of others feature from COLLECTION3:
{ANY}
Writing:
{ANY}
Looking and comparison:
{ANY}
Resizing:
{ANY}
Looking and Searching:
{ANY}
Other features:
{ANY}
  • replace_all (old_value: E_, new_value: E_)
    Replace all occurrences of the element old_value by new_value using is_equal for comparison.
  • fast_replace_all (old_value: E_, new_value: E_)
    Replace all occurrences of the element old_value by new_value using operator = for comparison.
Garbage collector tuning (very low-level):
{}
  • mark_native_arrays
    For performance reasons, the unused area of storage is always left as it is when some elements are removed.
Indexing:
{ANY}
Index validity:
{ANY}
Counting:
{ANY}
{ANY}
Looking and comparison:
{ANY}
Printing:
{ANY}
Miscellaneous features:
{ANY}
{ANY}
  • test (e1: E_, e2: E_): BOOLEAN
    In order to avoid run-time type errors, feature safe_equal calls is_equal only when e1 and e2 have exactly the same dynamic type.
  • safe_equal (e1: E_, e2: E_): BOOLEAN
    In order to avoid run-time type errors, feature safe_equal calls is_equal only when e1 and e2 have exactly the same dynamic type.
{}
upper1: INTEGER_32
writable attribute
{ANY}
Upper index bound for dimension 1.
count1: INTEGER_32
writable attribute
{ANY}
Size of the first dimension.
upper2: INTEGER_32
writable attribute
{ANY}
Upper index bound for dimension 2.
count2: INTEGER_32
writable attribute
{ANY}
Size of the second dimension.
upper3: INTEGER_32
writable attribute
{ANY}
Upper index bound for dimension 3.
count3: INTEGER_32
writable attribute
{ANY}
Size of the third dimension.
count: INTEGER_32
writable attribute
{ANY}
Total number of elements.
count2x3: INTEGER_32
writable attribute
{}
To speed up access, this value is always equal to count2 * count3
storage: NATIVE_ARRAY[E_]
writable attribute
capacity: INTEGER_32
writable attribute
of storage.
lower1: INTEGER_32
is 0
constant attribute
{ANY}
Lower index bound for dimension 1.
lower2: INTEGER_32
is 0
constant attribute
{ANY}
Lower index bound for dimension 2.
lower3: INTEGER_32
is 0
constant attribute
{ANY}
Lower index bound for dimension 3.
make (new_count1: INTEGER_32, new_count2: INTEGER_32, new_count3: INTEGER_32)
effective procedure
{ANY}
Create or reset Current with new dimensions.
from_collection3 (model: COLLECTION3[E_])
effective procedure
{ANY}
Uses the model to update Current.
from_collection (contents: COLLECTION[E_], new_count1: INTEGER_32, new_count2: INTEGER_32, new_count3: INTEGER_32)
effective procedure
{ANY}
Reset all bounds using new_count#i.
from_model (model: COLLECTION[COLLECTION[COLLECTION[E_]]])
effective procedure
{ANY}
The model is used to fill line by line the COLLECTION3.
item (line: INTEGER_32, column: INTEGER_32, depth: INTEGER_32): E_
effective function
{ANY}
put (x: E_, line: INTEGER_32, column: INTEGER_32, depth: INTEGER_32)
effective procedure
{ANY}
force (element: E_, line: INTEGER_32, column: INTEGER_32, depth: INTEGER_32)
effective procedure
{ANY}
Put element at position (line,column,depth).
copy (other: FAST_ARRAY3 [E_])
effective procedure
{ANY}
sub_collection3 (line_min: INTEGER_32, line_max: INTEGER_32, column_min: INTEGER_32, column_max: INTEGER_32, depth_min: INTEGER_32, depth_max: INTEGER_32): FAST_ARRAY3 [E_]
effective function
{ANY}
Create a new object using selected area of Current.
set_all_with (x: E_)
effective procedure
{ANY}
All element are set with the value x.
all_default: BOOLEAN
effective function
{ANY}
Do all items have their type's default value?
slice (l1: INTEGER_32, up1: INTEGER_32, l2: INTEGER_32, up2: INTEGER_32, l3: INTEGER_32, up3: INTEGER_32): FAST_ARRAY3 [E_]
effective function
{ANY}
Create a new collection initialized with elements of range low..up.
set_slice (element: E_, l1: INTEGER_32, up1: INTEGER_32, l2: INTEGER_32, up2: INTEGER_32, l3: INTEGER_32, up3: INTEGER_32)
effective procedure
{ANY}
Set all the elements in the range [(l1,up1),(l2,up2),(l3,up3)] of Current with the element 'element'.
swap (line1: INTEGER_32, column1: INTEGER_32, depth1: INTEGER_32, line2: INTEGER_32, column2: INTEGER_32, depth2: INTEGER_32)
effective procedure
{ANY}
Swap the element at index (line1,column1,depth1) with the element at index (line2,column2,depth2).
occurrences (elt: E_): INTEGER_32
effective function
{ANY}
Number of occurrences using is_equal.
fast_occurrences (elt: E_): INTEGER_32
effective function
{ANY}
Number of occurrences using =.
resize (new_count1: INTEGER_32, new_count2: INTEGER_32, new_count3: INTEGER_32)
effective procedure
{ANY}
has (x: E_): BOOLEAN
effective function
{ANY}
Look for x using equal for comparison.
fast_has (x: E_): BOOLEAN
effective function
{ANY}
Same as has but use = for comparison
replace_all (old_value: E_, new_value: E_)
effective procedure
{ANY}
Replace all occurrences of the element old_value by new_value using is_equal for comparison.
fast_replace_all (old_value: E_, new_value: E_)
effective procedure
{ANY}
Replace all occurrences of the element old_value by new_value using operator = for comparison.
mark_native_arrays
effective procedure
{}
For performance reasons, the unused area of storage is always left as it is when some elements are removed.
line_minimum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of lower1.
column_minimum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of lower2.
depth_minimum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of lower3.
line_maximum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of upper1.
column_maximum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of upper2.
depth_maximum: INTEGER_32
frozen
effective function
{ANY}
Equivalent of upper3.
valid_line (line: INTEGER_32): BOOLEAN
frozen
effective function
{ANY}
valid_index1 (line: INTEGER_32): BOOLEAN
effective function
{ANY}
valid_column (column: INTEGER_32): BOOLEAN
frozen
effective function
{ANY}
valid_index2 (column: INTEGER_32): BOOLEAN
effective function
{ANY}
valid_depth (depth: INTEGER_32): BOOLEAN
frozen
effective function
{ANY}
valid_index3 (depth: INTEGER_32): BOOLEAN
effective function
{ANY}
valid_index (line: INTEGER_32, column: INTEGER_32, depth: INTEGER_32): BOOLEAN
frozen
effective function
{ANY}
line_count: INTEGER_32
frozen
effective function
{ANY}
Equivalent of count1.
column_count: INTEGER_32
frozen
effective function
{ANY}
depth_count: INTEGER_32
frozen
effective function
{ANY}
clear_all
frozen
effective procedure
{ANY}
Set all items to default values.
fast_is_equal (other: FAST_ARRAY3 [E_]): BOOLEAN
effective function
{ANY}
Do both collections have the same lower1, lower2, lower3, upper1, upper2 and upper3, and items?
is_equal (other: FAST_ARRAY3 [E_]): BOOLEAN
effective function
{ANY}
Do both collections have the same lower1, lower2, lower3, upper1, upper2 and upper3, and items?
is_equal_map (other: FAST_ARRAY3 [E_]): BOOLEAN
effective function
{ANY}
Do both collections have the same lower, upper, and items?
fill_tagged_out_memory
frozen
effective procedure
{ANY}
Append a viewable information in tagged_out_memory in order to affect the behavior of out, tagged_out, etc.
set_area (element: E_, line_min: INTEGER_32, line_max: INTEGER_32, column_min: INTEGER_32, column_max: INTEGER_32, depth_min: INTEGER_32, depth_max: INTEGER_32)
effective procedure
{ANY}
Set all the elements of the selected area rectangle with element.
test (e1: E_, e2: E_): BOOLEAN
effective function
{ANY}
In order to avoid run-time type errors, feature safe_equal calls is_equal only when e1 and e2 have exactly the same dynamic type.
safe_equal (e1: E_, e2: E_): BOOLEAN
effective function
{ANY}
In order to avoid run-time type errors, feature safe_equal calls is_equal only when e1 and e2 have exactly the same dynamic type.
mark_item (native_array: NATIVE_ARRAY[E_], index: INTEGER_32)
{}
To be used _only_ inside the definition of mark_native_arrays.