Method AddItem

src/db/blockrecordarray.cpp:231–327

////////////////////////////////////////////////////////////////////////// AddItem //////////////////////////////////////////////////////////////////////////

// AddItem
///////////////////////////////////////////////////////////////////////////////
int cBlockRecordArray::AddItem(int8* pData, int dataSize, int mainIndex) //throw (eArchive)
{
    // make ourselves initialized, if we are not right now...
    //
    if (!Initialized())
    {
        InitForExistingBlock();
    }


    ASSERT(dataSize <= GetAvailableSpace());
    ASSERT(GetNumItems() <= MAX_RECORDS);
    ASSERT(dataSize > 0); // I am not sure if this is the right thing to do !
    ASSERT(mpBlockFile != 0);
    ASSERT(mainIndex != INVALID_INDEX);
    ASSERT(Initialized());
#ifdef _BLOCKFILE_DEBUG
    AssertValid();
    mpBlockFile->AssertValid();
#endif
    cDebug d("cBlockRecordArray::AddItem");
    d.TraceDetail("Entering... adding item of size %d to block %d\n", dataSize, mBlockNum);
    //
    // get the block we need and a reference into the index array....
    //
    cBlockFile::Block* pBlock     = mpBlockFile->GetBlock(mBlockNum);
    tIndexArray&       indexArray = util_GetIndexArray(pBlock);
    //
    // find an unused entry to put the item into...
    //
    tRecordIndex* pIndex   = indexArray.maRecordIndex;
    int           newIndex = 0;
    for (; newIndex < mNumItems; newIndex++, pIndex++)
    {
        if (pIndex->GetMainIndex() == INVALID_INDEX)
            break;
    }
    d.TraceDetail("Adding new item to index %d (max index + 1 = %d)\n", newIndex, mNumItems);
    // write the data we know for sure at this point...
    //
    pIndex->SetMainIndex(mainIndex);
    pBlock->SetDirty();
    //
    // calculate the offset for the new data
    //
    int prevOffset = (newIndex == 0 ? 0 : indexArray.maRecordIndex[newIndex - 1].GetOffset());
    pIndex->SetOffset(prevOffset + dataSize);

    if (newIndex == mNumItems)
    {
        //
        // increment the max number of indexes...
        //
        mNumItems++;
        indexArray.maRecordIndex[mNumItems].SetOffset(-1);
        indexArray.maRecordIndex[mNumItems].SetMainIndex(INVALID_INDEX);
    }
    else