embdata.c

Function embDataListDel

Deletes the tables of data list. Calls ajTableFree for each table in the list, and then calls ajListFree to free the actual list.

Synopsis

Prototype

void embDataListDel (
      AjPList* data
);

Output

data:(Output)is the list of data tables to delete

Returns

void:No return value

Description

Deletes the tables of data list. Calls ajTableFree 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 3.0.0

Function embDataListRead

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
);

Output

data:(Output)is the list of data tables.

Input & Output

pfile:(Modify)pointer to the data file

Returns

void:No return value

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 3.0.0

Function embDataListGetTables

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
);

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

void:No return value

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 3.0.0

Function embDataListGetTable

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
);

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 3.0.0