embdata.c
Deletes the tables of data list. Calls ajTablestrFree for each table in the
list, and then calls ajListFree to free the actual list.
Synopsis
Prototype
void embDataListDel (
AjPList* data
);
| Type | Name | Read/Write | Description |
|---|
| AjPList* | data | Output | is the list of data tables to delete |
| void | | RETURN | |
Output
| data: | (Output) | is the list of data tables to delete |
Returns
Description
Deletes the tables of data list. Calls ajTablestrFree for each table in the
list, and then calls ajListFree to free the actual list.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 6.4.0
General routine for reading in data from a file. The keys and values of
each table are stored as AjPStr.
Synopsis
Prototype
void embDataListRead (
AjPList data,
AjPFile pfile
);
| Type | Name | Read/Write | Description |
|---|
| AjPList | data | Output | is the list of data tables. |
| AjPFile | pfile | Modify | pointer to the data file |
| void | | RETURN | |
Output
| data: | (Output) | is the list of data tables. |
Input & Output
| pfile: | (Modify) | pointer to the data file |
Returns
Description
General routine for reading in data from a file. The keys and values of
each table are stored as AjPStr.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 6.4.0
Returns a list of data tables as requested. The data must already have been
read in and stored as a list of tables. An unsigned integer is used to
request tables. The first table has a value of 1, the second a value of 2,
the third a value of 4, the fourth a value of 8 etc. For example a value
of 10 would request the second and fourth tables from the list in that
order. Only returns a list of pointers to the data. It does not copy the
tables.
Synopsis
Prototype
void embDataListGetTables (
const AjPList fullList,
AjPList returnList,
ajuint required
);
| Type | Name | Read/Write | Description |
|---|
| const AjPList | fullList | Input | The list containing all the tables
of data |
| AjPList | returnList | Output | The new list containing just the tables
requested |
| ajuint | required | Input | used to request tables. A value of 1
requests the first table, a value of 16 requests the fifth table,
a value of 14 returns the second third and fourth tables in the
original list. |
| void | | RETURN | |
Input
| fullList: | (Input) | The list containing all the tables
of data |
| required: | (Input) | used to request tables. A value of 1
requests the first table, a value of 16 requests the fifth table,
a value of 14 returns the second third and fourth tables in the
original list. |
Output
| returnList: | (Output) | The new list containing just the tables
requested |
Returns
Description
Returns a list of data tables as requested. The data must already have been
read in and stored as a list of tables. An unsigned integer is used to
request tables. The first table has a value of 1, the second a value of 2,
the third a value of 4, the fourth a value of 8 etc. For example a value
of 10 would request the second and fourth tables from the list in that
order. Only returns a list of pointers to the data. It does not copy the
tables.
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 6.4.0
Returns a single table of data from the list of data tables. The data must
already have been read in and stored as a list of tables. An unsigned
integer is used to request a table. The first table in the list has a
value of 1, the second a value of 2, the third a value of 4, the fourth a
value of 8 etc. For example a value of 64 would request the seventh data
table in the list. When looking for which table to return the position of
the lowest set bit in the value determines which table is returned i.e.
a value of 66 would request the second table (not the seventh)
Synopsis
Prototype
AjPTable embDataListGetTable (
const AjPList fullList,
ajuint required
);
| Type | Name | Read/Write | Description |
|---|
| const AjPList | fullList | Input | The list containing all the tables
of data |
| ajuint | required | Input | used to request a table. A value of 1
requests the first table, a value of 16 requests the fifth table,
a value of 14 returns the second table in the original list. |
| AjPTable | | RETURN | the data table. Key and value are stored as AjPStrs |
Input
| fullList: | (Input) | The list containing all the tables
of data |
| required: | (Input) | used to request a table. A value of 1
requests the first table, a value of 16 requests the fifth table,
a value of 14 returns the second table in the original list. |
Returns
| AjPTable: | the data table. Key and value are stored as AjPStrs |
Description
Returns a single table of data from the list of data tables. The data must
already have been read in and stored as a list of tables. An unsigned
integer is used to request a table. The first table in the list has a
value of 1, the second a value of 2, the third a value of 4, the fourth a
value of 8 etc. For example a value of 64 would request the seventh data
table in the list. When looking for which table to return the position of
the lowest set bit in the value determines which table is returned i.e.
a value of 66 would request the second table (not the seventh)
Usage
See source code
Example
In preparation
Errors
See source code
Dependencies
See source code
See Also
See other functions in this section
Availability
In release 6.4.0