OscatsItemBank

OscatsItemBank — Item Bank Class

Synopsis

struct              OscatsItemBank;
void                oscats_item_bank_add_item           (OscatsItemBank *bank,
                                                         OscatsAdministrand *item);
void                oscats_item_bank_remove_item        (OscatsItemBank *bank,
                                                         OscatsAdministrand *item);
guint               oscats_item_bank_num_items          (const OscatsItemBank *bank);
const OscatsAdministrand *  oscats_item_bank_get_item   (const OscatsItemBank *bank,
                                                         guint i);

Object Hierarchy

  GObject
   +----OscatsAdministrand
         +----OscatsItemBank

Properties

  "sizeHint"                 guint                 : Write / Construct Only

Description

Note: Since an OscatsItemBank is also an OscatsAdministrand, it can be tagged with characteristics and can also serve as an item group for multi-stage testing or testlets, with appropriately coded algorithms.

OscatsItemBank does not implement oscats_administrand_get_default_model(), oscats_administrand_set_model(), or oscats_administrand_get_model(). For oscats_administrand_set_default_model(), OscatsItemBank will set the default model for all items.

Details

struct OscatsItemBank

struct OscatsItemBank;


oscats_item_bank_add_item ()

void                oscats_item_bank_add_item           (OscatsItemBank *bank,
                                                         OscatsAdministrand *item);

Adds item to the item bank bank. (Increases the item reference count.) Note that items cannot be added if bank is frozen (see "frozen"). Note, this function does not check whether item is already in bank.

bank :

an OscatsItemBank

item :

an OscatsAdministrand. [transfer none]

oscats_item_bank_remove_item ()

void                oscats_item_bank_remove_item        (OscatsItemBank *bank,
                                                         OscatsAdministrand *item);

Removes item from the item bank bank. (Decreases the item reference count.) Note that items cannot be removed if bank is frozen (see "frozen"). If item is not in bank, the function does nothing.

bank :

an OscatsItemBank

item :

an OscatsAdministrand. [transfer none]

oscats_item_bank_num_items ()

guint               oscats_item_bank_num_items          (const OscatsItemBank *bank);

bank :

an OscatsItemBank

Returns :

the number of items in the bank

oscats_item_bank_get_item ()

const OscatsAdministrand *  oscats_item_bank_get_item   (const OscatsItemBank *bank,
                                                         guint i);

Must have i < number of items in the bank. (Item's reference count is not increased.)

bank :

an OscatsItemBank

i :

item index (0-based)

Returns :

the item i. [transfer none]

Property Details

The "sizeHint" property

  "sizeHint"                 guint                 : Write / Construct Only

Hint of how many items will be in the item bank.

Default value: 1