(git:6a2e663)
list_timerenv Module Reference

An array-based list which grows on demand. When the internal array is full, a new array of twice the size will be allocated and the items are copied over. More...

Functions/Subroutines

logical function, public list_timerenv_isready (list)
 Test if the given list has been initialized. More...
 
subroutine, public list_timerenv_init (list, initial_capacity)
 Allocates the internal data-structures of the given list. This has to be called before any of the other routines. For deallocation call list_[valuetype]_destroy. More...
 
subroutine, public list_timerenv_destroy (list)
 Deallocated the internal data-structures of the given list. Caution: If the stored values are pointers, their targets will not get deallocated by this routine. More...
 
subroutine, public list_timerenv_set (list, value, pos)
 Assings the given value to the given position in the list. Thereby, the former value at that position gets overwritten. If the position is out of bounds, the program stops. More...
 
subroutine, public list_timerenv_push (list, value)
 Appends the given value at the end of the list. More...
 
subroutine, public list_timerenv_insert (list, value, pos)
 Inserts the given value at the givenn position within the list. Values which lay behind the insertion-position move one position up. More...
 
type(timer_env_type) function, pointer, public list_timerenv_peek (list)
 Returns the last element in the list. Is equivalent to: list_timerenv_get(list, list_timerenv_size(list)) More...
 
type(timer_env_type) function, pointer, public list_timerenv_pop (list)
 Returns the last element in the list and removes it. Is equivialent to: value = list_timerenv_get(list, list_timerenv_size(list)) call list_timerenv_del(list, list_timerenv_size(list)) More...
 
subroutine, public list_timerenv_clear (list)
 Removes all values from the list. The list itself is not deallocated. More...
 
type(timer_env_type) function, pointer, public list_timerenv_get (list, pos)
 Returns the value at the given position from the list. More...
 
subroutine, public list_timerenv_del (list, pos)
 Removes the value at the given position from the list. More...
 
integer function, public list_timerenv_size (list)
 Returns the current size of the list. More...
 

Detailed Description

An array-based list which grows on demand. When the internal array is full, a new array of twice the size will be allocated and the items are copied over.

This list can also be used as a stack. Have look at list_push(), list_pop() and list_peek().

History
12.2012 first version [ole]
Author
Ole Schuett

Function/Subroutine Documentation

◆ list_timerenv_isready()

logical function, public list_timerenv::list_timerenv_isready ( type(list_timerenv_type), intent(in)  list)

Test if the given list has been initialized.

Parameters
list...
Returns
...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 61 of file list_timerenv.F.

◆ list_timerenv_init()

subroutine, public list_timerenv::list_timerenv_init ( type(list_timerenv_type), intent(inout)  list,
integer, intent(in), optional  initial_capacity 
)

Allocates the internal data-structures of the given list. This has to be called before any of the other routines. For deallocation call list_[valuetype]_destroy.

Parameters
list...
initial_capacityThe initial size of the internal array (default=11).
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 77 of file list_timerenv.F.

◆ list_timerenv_destroy()

subroutine, public list_timerenv::list_timerenv_destroy ( type(list_timerenv_type), intent(inout)  list)

Deallocated the internal data-structures of the given list. Caution: If the stored values are pointers, their targets will not get deallocated by this routine.

Parameters
list...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 108 of file list_timerenv.F.

◆ list_timerenv_set()

subroutine, public list_timerenv::list_timerenv_set ( type(list_timerenv_type), intent(inout)  list,
type(timer_env_type), intent(in), pointer  value,
integer, intent(in)  pos 
)

Assings the given value to the given position in the list. Thereby, the former value at that position gets overwritten. If the position is out of bounds, the program stops.

Parameters
list...
value...
posPosition in the list - musst fulfill 0 < pos < list_size+1.
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 132 of file list_timerenv.F.

◆ list_timerenv_push()

subroutine, public list_timerenv::list_timerenv_push ( type(list_timerenv_type), intent(inout)  list,
type(timer_env_type), intent(in), pointer  value 
)

Appends the given value at the end of the list.

Parameters
list...
value...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 153 of file list_timerenv.F.

◆ list_timerenv_insert()

subroutine, public list_timerenv::list_timerenv_insert ( type(list_timerenv_type), intent(inout)  list,
type(timer_env_type), intent(in), pointer  value,
integer, intent(in)  pos 
)

Inserts the given value at the givenn position within the list. Values which lay behind the insertion-position move one position up.

Parameters
list...
value...
posPosition in the list - musst fulfill 0 < pos < list_size+2 .
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 180 of file list_timerenv.F.

◆ list_timerenv_peek()

type(timer_env_type) function, pointer, public list_timerenv::list_timerenv_peek ( type(list_timerenv_type), intent(inout)  list)

Returns the last element in the list. Is equivalent to: list_timerenv_get(list, list_timerenv_size(list))

Parameters
list...
Returns
...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 216 of file list_timerenv.F.

◆ list_timerenv_pop()

type(timer_env_type) function, pointer, public list_timerenv::list_timerenv_pop ( type(list_timerenv_type), intent(inout)  list)

Returns the last element in the list and removes it. Is equivialent to: value = list_timerenv_get(list, list_timerenv_size(list)) call list_timerenv_del(list, list_timerenv_size(list))

Parameters
list...
Returns
...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 240 of file list_timerenv.F.

◆ list_timerenv_clear()

subroutine, public list_timerenv::list_timerenv_clear ( type(list_timerenv_type), intent(inout)  list)

Removes all values from the list. The list itself is not deallocated.

Parameters
list...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 261 of file list_timerenv.F.

◆ list_timerenv_get()

type(timer_env_type) function, pointer, public list_timerenv::list_timerenv_get ( type(list_timerenv_type), intent(in)  list,
integer, intent(in)  pos 
)

Returns the value at the given position from the list.

Parameters
list...
posPosition in the list - musst fulfill 0 < pos < list_size+1 .
Returns
...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 284 of file list_timerenv.F.

◆ list_timerenv_del()

subroutine, public list_timerenv::list_timerenv_del ( type(list_timerenv_type), intent(inout)  list,
integer, intent(in)  pos 
)

Removes the value at the given position from the list.

Parameters
list...
posPosition in the list - musst fulfill 0 < pos < list_size+1 .
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 308 of file list_timerenv.F.

◆ list_timerenv_size()

integer function, public list_timerenv::list_timerenv_size ( type(list_timerenv_type), intent(in)  list)

Returns the current size of the list.

Parameters
list...
Returns
...
History
12.2012 created [ole]
Author
Ole Schuett

Definition at line 337 of file list_timerenv.F.