indexing
description: "[
Sequences of values, all of the same type or of a conforming one,
accessible through integer indices in a contiguous interval.
]"
legal: "See notice at end of class."
status: "See notice at end of class."
date: "$Date: 2006-09-28 15:15:41 -0700 (Thu, 28 Sep 2006) $"
revision: "$Revision: 63967 $"
class interface
ARRAY [G]
create
make (min_index, max_index: INTEGER_32)
`min_index'`max_index'
`min_index'`max_index'
require
valid_bounds: min_index <= max_index + 1
ensure
lower_set: lower = min_index
upper_set: upper = max_index
items_set: all_default
make_from_array (a: ARRAY [G])
`a'
`ARRAY'
require
array_exists: a /= Void
make_from_cil (na: NATIVE_ARRAY [like item])
`na'
require
is_dotnet: {PLATFORM}.is_dotnet
na_not_void: na /= Void
convert
make_from_cil: {NATIVE_ARRAY [G]},
make_from_cil: {SPECIAL [G]},
make_from_cil ({NATIVE_ARRAY [G]})
feature
make (min_index, max_index: INTEGER_32)
`min_index'`max_index'
`min_index'`max_index'
require
valid_bounds: min_index <= max_index + 1
ensure
lower_set: lower = min_index
upper_set: upper = max_index
items_set: all_default
make_from_array (a: ARRAY [G])
`a'
`ARRAY'
require
array_exists: a /= Void
make_from_cil (na: NATIVE_ARRAY [like item])
`na'
require
is_dotnet: {PLATFORM}.is_dotnet
na_not_void: na /= Void
feature
area: SPECIAL [G]
TO_SPECIAL
entry (i: INTEGER_32): G
`i'
require
valid_key: valid_index (i)
generating_type: STRING_8
ANY
generator: STRING_8
ANY
has (v: G): BOOLEAN
`v'
object_comparison
ensure CONTAINER
not_found_in_empty: Result implies not is_empty
item alias "[]" (i: INTEGER_32): G assign put
`i'
ARRAYinfix "@"
require TABLE
valid_key: valid_index (i)
require TO_SPECIAL
valid_index: valid_index (i)
infix "@" (i: INTEGER_32): G assign put
`i'
ARRAYitem
require TABLE
valid_key: valid_index (i)
require TO_SPECIAL
valid_index: valid_index (i)
feature
additional_space: INTEGER_32
RESIZABLE
ensure RESIZABLE
at_least_one: Result >= 1
capacity: INTEGER_32
ARRAYcount
require BOUNDED
True
ensure then
consistent_with_bounds: Result = upper - lower + 1
count: INTEGER_32
ARRAYcapacity
require FINITE
True
ensure then
consistent_with_bounds: Result = upper - lower + 1
growth_percentage: INTEGER_32 is 50
RESIZABLE
index_set: INTEGER_INTERVAL
require INDEXABLE
True
ensure INDEXABLE
not_void: Result /= Void
ensure then
same_count: Result.count = count
same_bounds: ((Result.lower = lower) and (Result.upper = upper))
lower: INTEGER_32
minimal_increase: INTEGER_32 is 5
RESIZABLE
occurrences (v: G): INTEGER_32
`v'
ensure BAG
non_negative_occurrences: Result >= 0
upper: INTEGER_32
feature
frozen deep_equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
shallow_implies_deep: standard_equal (some, other) implies Result
both_or_none_void: (some = Void) implies (Result = (other = Void))
same_type: (Result and (some /= Void)) implies some.same_type (other)
symmetric: Result implies deep_equal (other, some)
frozen equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.is_equal (other))
is_equal (other: like Current): BOOLEAN
`other'
require ANY
other_not_void: other /= Void
ensure ANY
symmetric: Result implies other.is_equal (Current)
consistent: standard_is_equal (other) implies Result
frozen standard_equal (some: ANY; other: like arg #1): BOOLEAN
`some'`other'
ANY
ensure ANY
definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.standard_is_equal (other))
frozen standard_is_equal (other: like Current): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
ensure ANY
same_type: Result implies same_type (other)
symmetric: Result implies other.standard_is_equal (Current)
feature
all_default: BOOLEAN
ensure
definition: Result = (count = 0 or else ((item (upper) = Void or else item (upper) = item (upper).default) and subarray (lower, upper - 1).all_default))
changeable_comparison_criterion: BOOLEAN
object_comparison
CONTAINER
conforms_to (other: ANY): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
extendible: BOOLEAN
full: BOOLEAN
require BOX
True
is_empty: BOOLEAN
FINITE
require CONTAINER
True
is_inserted (v: G): BOOLEAN
`v'
`has (v)'
COLLECTION
object_comparison: BOOLEAN
equal`='
`='
CONTAINER
prunable: BOOLEAN
resizable: BOOLEAN
capacity
RESIZABLE
same_items (other: like Current): BOOLEAN
`other'
require
other_not_void: other /= Void
ensure
definition: Result = ((count = other.count) and then (count = 0 or else (item (upper) = other.item (other.upper) and subarray (lower, upper - 1).same_items (other.subarray (other.lower, other.upper - 1)))))
same_type (other: ANY): BOOLEAN
`other'
ANY
require ANY
other_not_void: other /= Void
ensure ANY
definition: Result = (conforms_to (other) and other.conforms_to (Current))
valid_index (i: INTEGER_32): BOOLEAN
`i'
require TABLE
True
require TO_SPECIAL
True
ensure then INDEXABLE
only_if_in_index_set: Result implies ((i >= index_set.lower) and (i <= index_set.upper))
valid_index_set: BOOLEAN
feature
compare_objects
equal
`='
CONTAINER
require CONTAINER
changeable_comparison_criterion: changeable_comparison_criterion
ensure CONTAINER
object_comparison
compare_references
`='
equal
CONTAINER
require CONTAINER
changeable_comparison_criterion: changeable_comparison_criterion
ensure CONTAINER
reference_comparison: not object_comparison
feature
enter (v: like item; i: INTEGER_32)
`i'`v'
require
valid_key: valid_index (i)
fill (other: CONTAINER [G])
`other'
`other'
COLLECTION
require COLLECTION
other_not_void: other /= Void
extendible: extendible
force (v: like item; i: INTEGER_32)
`v'`i'
`i'
ensure
inserted: item (i) = v
higher_count: count >= old count
put (v: like item; i: INTEGER_32)
`i'`v'
require TABLE
valid_key: valid_index (i)
require TO_SPECIAL
valid_index: valid_index (i)
ensure then INDEXABLE
insertion_done: item (i) = v
ensure TO_SPECIAL
inserted: item (i) = v
subcopy (other: ARRAY [like item]; start_pos, end_pos, index_pos: INTEGER_32)
`other'`start_pos'`end_pos'
`index_pos'
require
other_not_void: other /= Void
valid_start_pos: other.valid_index (start_pos)
valid_end_pos: other.valid_index (end_pos)
valid_bounds: (start_pos <= end_pos) or (start_pos = end_pos + 1)
valid_index_pos: valid_index (index_pos)
enough_space: (upper - index_pos) >= (end_pos - start_pos)
feature
clear_all
ensure
stable_lower: lower = old lower
stable_upper: upper = old upper
default_items: all_default
discard_items
ensure
default_items: all_default
prune_all (v: G)
`v'
object_comparison
COLLECTION
require COLLECTION
prunable: prunable
ensure COLLECTION
no_more_occurrences: not has (v)
feature
automatic_grow
Growth_percentage
RESIZABLE
ensure RESIZABLE
increased_capacity: capacity >= old capacity + old capacity * growth_percentage // 100
conservative_resize (min_index, max_index: INTEGER_32)
`min_index'`max_index'
require
good_indices: min_index <= max_index
ensure
no_low_lost: lower = min_index or else lower = old lower
no_high_lost: upper = max_index or else upper = old upper
grow (i: INTEGER_32)
`i'
ensure RESIZABLE
new_capacity: capacity >= i
feature
linear_representation: LINEAR [G]
to_c: ANY
require
not_is_dotnet: not {PLATFORM}.is_dotnet
to_cil: NATIVE_ARRAY [G]
require
is_dotnet: {PLATFORM}.is_dotnet
ensure
to_cil_not_void: Result /= Void
to_special: SPECIAL [G]
ensure
to_special_not_void: Result /= Void
feature
copy (other: like Current)
`other'
clone
require ANY
other_not_void: other /= Void
type_identity: same_type (other)
ensure ANY
is_equal: is_equal (other)
ensure then
equal_areas: area.is_equal (other.area)
frozen deep_copy (other: like Current)
copy`other'deep_twin
ANY
require ANY
other_not_void: other /= Void
ensure ANY
deep_equal: deep_equal (Current, other)
frozen deep_twin: like Current
ANY
ensure ANY
deep_equal: deep_equal (Current, Result)
frozen standard_copy (other: like Current)
`other'
ANY
require ANY
other_not_void: other /= Void
type_identity: same_type (other)
ensure ANY
is_standard_equal: standard_is_equal (other)
frozen standard_twin: like Current
`other'
ANY
ensure ANY
standard_twin_not_void: Result /= Void
equal: standard_equal (Result, Current)
subarray (start_pos, end_pos: INTEGER_32): ARRAY [G]
`start_pos'`end_pos'
require
valid_start_pos: valid_index (start_pos)
valid_end_pos: end_pos <= upper
valid_bounds: (start_pos <= end_pos) or (start_pos = end_pos + 1)
ensure
lower: Result.lower = start_pos
upper: Result.upper = end_pos
frozen twin: like Current
`Current'
twincopycopy
ANY
ensure ANY
twin_not_void: Result /= Void
is_equal: Result.is_equal (Current)
feature
frozen default: like Current
ANY
frozen default_pointer: POINTER
`POINTER'
`p'default
`p'`POINTER'
ANY
default_rescue
ANY
frozen do_nothing
ANY
feature
do_all (action: PROCEDURE [ANY, TUPLE [G]])
`action'
`action'
require
action_not_void: action /= Void
do_if (action: PROCEDURE [ANY, TUPLE [G]]; test: FUNCTION [ANY, TUPLE [G], BOOLEAN])
`action'`test'
`action'`test'
require
action_not_void: action /= Void
test_not_void: test /= Void
for_all (test: FUNCTION [ANY, TUPLE [G], BOOLEAN]): BOOLEAN
`test'
require
test_not_void: test /= Void
there_exists (test: FUNCTION [ANY, TUPLE [G], BOOLEAN]): BOOLEAN
`test'
require
test_not_void: test /= Void
feature
io: STD_FILES
ANY
out: STRING_8
ANYtagged_out
ANY
print (some: ANY)
`some'
ANY
frozen tagged_out: STRING_8
ANYout
ANY
feature
operating_environment: OPERATING_ENVIRONMENT
ANY
invariant
area_exists: area /= Void
consistent_size: capacity = upper - lower + 1
non_negative_count: count >= 0
index_set_has_same_count: valid_index_set
RESIZABLE
increase_by_at_least_one: minimal_increase >= 1
BOUNDED
valid_count: count <= capacity
full_definition: full = (count = capacity)
FINITE
empty_definition: is_empty = (count = 0)
non_negative_count: count >= 0
ANY
reflexive_equality: standard_is_equal (Current)
reflexive_conformance: conforms_to (Current)
INDEXABLE
index_set_not_void: index_set /= Void
indexing
library: "EiffelBase: Library of reusable components for Eiffel."
copyright: "Copyright (c) 1984-2006, Eiffel Software and others"
license: "Eiffel Forum License v2 (see http://www.eiffel.com/licensing/forum.txt)"
source: "[
Eiffel Software
356 Storke Road, Goleta, CA 93117 USA
Telephone 805-685-1006, Fax 805-685-6869
Website http://www.eiffel.com
Customer support http://support.eiffel.com
]"
end ARRAY