Class interface representing a manager for SimpleTableInternal (aka STI). More...
#include <arcane/core/ISimpleTableInternalMng.h>
Public Member Functions | |
| virtual void | clearInternal ()=0 |
| Method to clear the content of the SimpleTableInternal. | |
| virtual Integer | addRow (const String &row_name)=0 |
| Method to add a row. | |
| virtual Integer | addRow (const String &row_name, ConstArrayView< Real > elements)=0 |
| Method to add a row. | |
| virtual bool | addRows (StringConstArrayView rows_names)=0 |
| Method to add multiple rows. | |
| virtual Integer | addColumn (const String &column_name)=0 |
| Method to add a column. | |
| virtual Integer | addColumn (const String &column_name, ConstArrayView< Real > elements)=0 |
| Method to add a column. | |
| virtual bool | addColumns (StringConstArrayView columns_names)=0 |
| Method to add multiple columns. | |
| virtual bool | addElementInRow (Integer position, Real element)=0 |
| Method to add an element to a row. | |
| virtual bool | addElementInRow (const String &row_name, Real element, bool create_if_not_exist=true)=0 |
| Method to add an element to a row. | |
| virtual bool | addElementInSameRow (Real element)=0 |
| Method to add an element to the row most recently manipulated. | |
| virtual bool | addElementsInRow (Integer position, ConstArrayView< Real > elements)=0 |
| Method to add multiple elements to a row. | |
| virtual bool | addElementsInRow (const String &row_name, ConstArrayView< Real > elements, bool create_if_not_exist=true)=0 |
| Method to add multiple elements to a row. | |
| virtual bool | addElementsInSameRow (ConstArrayView< Real > elements)=0 |
| Method to add multiple elements to the row most recently manipulated. | |
| virtual bool | addElementInColumn (Integer position, Real element)=0 |
| Method to add an element to a column. | |
| virtual bool | addElementInColumn (const String &column_name, Real element, bool create_if_not_exist=true)=0 |
| Method to add an element to a column. | |
| virtual bool | addElementInSameColumn (Real element)=0 |
| Method to add an element to the column most recently manipulated. | |
| virtual bool | addElementsInColumn (Integer position, ConstArrayView< Real > elements)=0 |
| Method to add multiple elements to a column. | |
| virtual bool | addElementsInColumn (const String &column_name, ConstArrayView< Real > elements, bool create_if_not_exist=true)=0 |
| Method to add multiple elements to a column. | |
| virtual bool | addElementsInSameColumn (ConstArrayView< Real > elements)=0 |
| Method to add multiple elements to the column most recently manipulated. | |
| virtual bool | editElementUp (Real element, bool update_last_position=true)=0 |
| Method to edit an element above the last element most recently manipulated (row above/same column). | |
| virtual bool | editElementDown (Real element, bool update_last_position=true)=0 |
| Method to edit an element below the last element most recently manipulated (row below/same column). | |
| virtual bool | editElementLeft (Real element, bool update_last_position=true)=0 |
| Method to edit an element to the left of the last element most recently manipulated (same row/column to the left). | |
| virtual bool | editElementRight (Real element, bool update_last_position=true)=0 |
| Method allowing editing an element to the right of the last element recently manipulated (same row/column to the right). | |
| virtual Real | elementUp (bool update_last_position=false)=0 |
| Method allowing retrieval of an element above the last element recently manipulated (row above/same column). | |
| virtual Real | elementDown (bool update_last_position=false)=0 |
| Method allowing retrieval of an element below the last element recently manipulated (row below/same column). | |
| virtual Real | elementLeft (bool update_last_position=false)=0 |
| Method allowing retrieval of an element to the left of the last element recently manipulated (same row/column to the left). | |
| virtual Real | elementRight (bool update_last_position=false)=0 |
| Method allowing retrieval of an element to the right of the last element recently manipulated (same row/column to the right). | |
| virtual bool | editElement (Real element)=0 |
| Method allowing modification of an element in the table. | |
| virtual bool | editElement (Integer position_x, Integer position_y, Real element)=0 |
| Method allowing modification of an element in the table. | |
| virtual bool | editElement (const String &column_name, const String &row_name, Real element)=0 |
| Method allowing modification of an element in the table. | |
| virtual Real | element ()=0 |
| Method allowing retrieval of a copy of an element. | |
| virtual Real | element (Integer position_x, Integer position_y, bool update_last_position=false)=0 |
| Method allowing retrieval of a copy of an element. | |
| virtual Real | element (const String &column_name, const String &row_name, bool update_last_position=false)=0 |
| Method allowing retrieval of a copy of an element. | |
| virtual RealUniqueArray | row (Integer position)=0 |
| Method allowing retrieval of a copy of a row. | |
| virtual RealUniqueArray | row (const String &row_name)=0 |
| Method allowing retrieval of a copy of a row. | |
| virtual RealUniqueArray | column (Integer position)=0 |
| Method allowing retrieval of a copy of a column. | |
| virtual RealUniqueArray | column (const String &column_name)=0 |
| Method allowing retrieval of a copy of a column. | |
| virtual Integer | rowSize (Integer position)=0 |
| Method allowing retrieval of the size of a row. Including hypothetical 'gaps' in the row. | |
| virtual Integer | rowSize (const String &row_name)=0 |
| Method allowing retrieval of the size of a row. Including hypothetical 'gaps' in the row. | |
| virtual Integer | columnSize (Integer position)=0 |
| Method allowing retrieval of the size of a column. Including hypothetical 'gaps' in the column. | |
| virtual Integer | columnSize (const String &column_name)=0 |
| Method allowing retrieval of the size of a column. Including hypothetical 'gaps' in the column. | |
| virtual Integer | rowPosition (const String &row_name)=0 |
| Method allowing retrieval of the position of a row. | |
| virtual Integer | columnPosition (const String &column_name)=0 |
| Method allowing retrieval of the position of a column. | |
| virtual Integer | numberOfRows ()=0 |
| Method allowing retrieval of the number of rows in the table. This is, in a sense, the maximum number of elements a column can contain. | |
| virtual Integer | numberOfColumns ()=0 |
| Method allowing retrieval of the number of columns in the table. This is, in a sense, the maximum number of elements a row can contain. | |
| virtual String | rowName (Integer position)=0 |
| Method allowing retrieval of the name of a row from its position. | |
| virtual String | columnName (Integer position)=0 |
| Method allowing retrieval of the name of a column from its position. | |
| virtual bool | editRowName (Integer position, const String &new_name)=0 |
| Method allowing changing the name of a row. | |
| virtual bool | editRowName (const String &row_name, const String &new_name)=0 |
| Method allowing changing the name of a row. | |
| virtual bool | editColumnName (Integer position, const String &new_name)=0 |
| Method allowing changing the name of a column. | |
| virtual bool | editColumnName (const String &column_name, const String &new_name)=0 |
| Method allowing changing the name of a column. | |
| virtual Integer | addAverageColumn (const String &column_name)=0 |
| Method allowing creation of a column containing the average of elements of each row. | |
| virtual Ref< SimpleTableInternal > | internal ()=0 |
| Method allowing retrieval of a reference to the object SimpleTableInternal used. | |
| virtual void | setInternal (const Ref< SimpleTableInternal > &simple_table_internal)=0 |
| Method allowing setting a reference to a SimpleTableInternal. | |
Class interface representing a manager for SimpleTableInternal (aka STI).
This manager allows for several types of operations on the STI: adding rows, columns, values, etc.
There are two modes of operation (which can be mixed):
The first mode is the easiest to use and is sufficient for most users. You provide a name (or position) of a row or column and a value, and this value is placed after the other values in the row or column.
The second mode is more advanced and is mainly used to replace elements already present or to optimize performance (if there are 40 rows, 40 values to add sequentially, and you use the column names 40 times, this results in 40 String searches in a StringUniqueArray, which is not optimal performance). A pointer representing the last added element is present in STI. You can modify elements around this pointer (top, bottom, left, right) using the available methods. This pointer can be placed anywhere using the element() methods. This pointer is not read by the methods of the first mode but is updated by them.
Definition at line 61 of file ISimpleTableInternalMng.h.
|
pure virtual |
Method allowing creation of a column containing the average of elements of each row.
| column_name | The name of the new column. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add a column.
| column_name | The name of the column. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add a column.
If the number of elements in 'elements' is greater than the number of rows, the addition still takes place (but the extra elements will not be added).
| column_name | The name of the column. Must not be empty. |
| elements | The elements to add to the column. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple columns.
| rows_names | The names of the columns. Each name must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add an element to a column.
| column_name | The name of the column. |
| element | The element to add. |
| create_if_not_exist | To specify whether the column should be created if it does not already exist. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add an element to a column.
| position | The position of the column. |
| element | The element to add. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add an element to a row.
| row_name | The name of the row. |
| element | The element to add. |
| create_if_not_exist | To specify whether the row should be created if it does not already exist. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add an element to a row.
| position | The position of the row. |
| element | The element to add. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add an element to the column most recently manipulated.
This method differs from 'editElementDown()' because here, an element is added to the end of the column, not necessarily after the last added element.
| element | The element to add. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add an element to the row most recently manipulated.
This method differs from 'editElementRight()' because here, an element is added to the end of the row, not necessarily after the last added element.
| element | The element to add. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to add multiple elements to a column.
If the number of elements in 'elements' is greater than the number of available rows, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
| column_name | The name of the column. |
| elements | The array of elements to add. |
| create_if_not_exist | To specify whether the column should be created if it does not already exist. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple elements to a column.
If the number of elements in 'elements' is greater than the number of available rows, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
| position | The position of the column. |
| elements | The array of elements to add. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple elements to a row.
If the number of elements in 'elements' is greater than the number of available columns, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
| row_name | The name of the row. |
| elements | The array of elements to add. |
| create_if_not_exist | To specify whether the row should be created if it does not already exist. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple elements to a row.
If the number of elements in 'elements' is greater than the number of available columns, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
| position | The position of the row. |
| elements | The array of elements to add. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple elements to the column most recently manipulated.
If the number of elements in 'elements' is greater than the number of available rows, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
Apart from the fact that we are manipulating an array here, this method differs from 'editElementDown()' because here, elements are added to the end of the column, not necessarily after the last added element.
| elements | The array of elements to add. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple elements to the row most recently manipulated.
If the number of elements in 'elements' is greater than the number of available columns, the addition still takes place (but the extra elements will not be added) and a return value of false will be returned.
Apart from the fact that we are manipulating an array here, this method differs from 'editElementRight()' because here, elements are added to the end of the row, not necessarily after the last added element.
| elements | The array of elements to add. |
Implemented in Arcane::SimpleTableInternalMng.
Method to add a row.
| row_name | The name of the row. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add a row.
If the number of elements in 'elements' is greater than the number of columns, the addition still takes place (but the extra elements will not be added).
| row_name | The name of the row. Must not be empty. |
| elements | The elements to insert into the row. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to add multiple rows.
| rows_names | The names of the rows. Each name must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method to clear the content of the SimpleTableInternal.
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of a column.
| column_name | The name of the column. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of a column.
| position | The position of the column. |
Implemented in Arcane::SimpleTableInternalMng.
Method allowing retrieval of the name of a column from its position.
| position | The position of the column. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of the position of a column.
| row_name | The name of the column. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of the size of a column. Including hypothetical 'gaps' in the column.
| position | The name of the column. |
Implemented in Arcane::SimpleTableInternalMng.
Method allowing retrieval of the size of a column. Including hypothetical 'gaps' in the column.
| position | The position of the column. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing changing the name of a column.
| column_name | The current name of the column. |
| new_name | The new name of the column. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing changing the name of a column.
| position | The position of the column. |
| new_name | The new name of the column. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing modification of an element in the table.
| column_name | The name of the column where the element is located. |
| row_name | The name of the row where the element is located. |
| element | The replacement element. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method allowing modification of an element in the table.
| position_x | The position of the column to modify. |
| position_y | The position of the row to modify. |
| element | The replacement element. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method allowing modification of an element in the table.
The x and y positions correspond to the location of the last manipulated element.
This method is useful after using 'elemUDLR(true)', for example.
| element | The replacement element. |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to edit an element below the last element most recently manipulated (row below/same column).
The element being modified thus becomes the last modified element at the end of this method (if update_last_position = true).
This method differs from 'addElementInSameColumn()' because here, an element is added (or modified) below the last manipulated element, which is not necessarily at the end of the column.
| element | The element to modify. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to edit an element to the left of the last element most recently manipulated (same row/column to the left).
The element being modified thus becomes the last modified element at the end of this method (if update_last_position = true).
| element | The element to modify. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method allowing editing an element to the right of the last element recently manipulated (same row/column to the right).
The element being modified thus becomes the last modified element at the end of this method (if update_last_position = true).
This method differs from 'addElementInSameRow()' because here, we add (or modify) an element to the right of the last manipulated element, which is not necessarily at the end of the column.
| element | The element to modify. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method to edit an element above the last element most recently manipulated (row above/same column).
The element being modified thus becomes the last modified element at the end of this method (if update_last_position = true).
| element | The element to modify. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
References element().
|
pure virtual |
Method allowing changing the name of a row.
| row_name | The current name of the row. |
| new_name | The new name of the row. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing changing the name of a row.
| position | The position of the row. |
| new_name | The new name of the row. Must not be empty. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of an element.
The x and y positions correspond to the location of the last manipulated element.
Implemented in Arcane::SimpleTableInternalMng.
Referenced by addElementInColumn(), addElementInColumn(), addElementInRow(), addElementInRow(), addElementInSameColumn(), addElementInSameRow(), editElement(), editElement(), editElement(), editElementDown(), editElementLeft(), editElementRight(), and editElementUp().
|
pure virtual |
Method allowing retrieval of a copy of an element.
| column_name | The name of the column where the element is located. |
| row_name | The name of the row where the element is located. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of an element.
| position_x | The position of the column where the element is located. |
| position_y | The position of the row where the element is located. |
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of an element below the last element recently manipulated (row below/same column).
The element retrieved thus becomes the last "modified" element at the end of this method (if update_last_position = true).
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of an element to the left of the last element recently manipulated (same row/column to the left).
The element retrieved thus becomes the last "modified" element at the end of this method (if update_last_position = true).
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of an element to the right of the last element recently manipulated (same row/column to the right).
The element retrieved thus becomes the last "modified" element at the end of this method (if update_last_position = true).
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of an element above the last element recently manipulated (row above/same column).
The element retrieved thus becomes the last "modified" element at the end of this method (if update_last_position = true).
| update_last_position | Should the "last modified element" cursor be moved? |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a reference to the object SimpleTableInternal used.
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of the number of columns in the table. This is, in a sense, the maximum number of elements a row can contain.
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of the number of rows in the table. This is, in a sense, the maximum number of elements a column can contain.
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of a row.
| row_name | The name of the row. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of a copy of a row.
| position | The position of the row. |
Implemented in Arcane::SimpleTableInternalMng.
Method allowing retrieval of the name of a row from its position.
| position | The position of the row. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing retrieval of the position of a row.
| row_name | The name of the row. |
Implemented in Arcane::SimpleTableInternalMng.
Method allowing retrieval of the size of a row. Including hypothetical 'gaps' in the row.
| position | The name of the row. |
Implemented in Arcane::SimpleTableInternalMng.
Method allowing retrieval of the size of a row. Including hypothetical 'gaps' in the row.
| position | The position of the row. |
Implemented in Arcane::SimpleTableInternalMng.
|
pure virtual |
Method allowing setting a reference to a SimpleTableInternal.
| simple_table_internal | The reference to a SimpleTableInternal. |
Implemented in Arcane::SimpleTableInternalMng.