libfossil
fsl_card_F_list Struct Reference

A list of fsl_card_F objects. More...

#include "repo.h"

Collaboration diagram for fsl_card_F_list:

Data Fields

uint32_t capacity
 The number of entries currently allocated in this->list.
int32_t cursor
 An internal cursor into this->list, used primarily for properly traversing the file list in delta manifests.
uint32_t flags
 Internal flags.
fsl_card_F * list
 The list of F-cards.
uint32_t used
 The number of entries in this->list which are in use.

Detailed Description

A list of fsl_card_F objects.

F-cards used a custom list type, instead of the framework's generic fsl_list, because experience has shown that the number of (de)allocations we need for F-card lists has a large negative impact when parsing and creating artifacts en masse. This list type, unlike fsl_list, uses a conventional object array approach to storage, as opposed to an array of pointers (each entry of which has to be separately allocated).

These lists, and F-cards in generally, are typically maintained internally in the library. There's probably "no good reason" for clients to manipulate them.

Definition at line 207 of file repo.h.

Field Documentation

◆ capacity

uint32_t fsl_card_F_list::capacity

The number of entries currently allocated in this->list.

Definition at line 220 of file repo.h.

◆ cursor

int32_t fsl_card_F_list::cursor

An internal cursor into this->list, used primarily for properly traversing the file list in delta manifests.

Maintenance notes: internal updates to this member are the only reason some of the deck APIs require a non-const deck. This type needs to be signed for compatibility with some of the older algos, e.g. fsl__deck_F_seek_base().

Definition at line 230 of file repo.h.

◆ flags

uint32_t fsl_card_F_list::flags

Internal flags.

Never, ever modify these from client code.

Definition at line 234 of file repo.h.

◆ list

fsl_card_F* fsl_card_F_list::list

The list of F-cards.

The first this->used elements are in-use. This pointer may change any time the list is reallocated.

Definition at line 212 of file repo.h.

◆ used

uint32_t fsl_card_F_list::used

The number of entries in this->list which are in use.

Definition at line 216 of file repo.h.


The documentation for this struct was generated from the following file: