stringhunk.cpp

Go to the documentation of this file.

 
/*
Copyright (C) 2002-2025 UFO: Alien Invasion.
 
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
See the GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
*/
 
#include "stringhunk.h"
#include "../common/common.h"

bool STRHUNK_Add (stringHunk_t* hunk, const char* string)
{
    const ptrdiff_t filled = hunk->pos - hunk->hunk;
    const size_t remaining = hunk->size - filled;
    const size_t strLength = strlen(string);
    const bool overflow = remaining <= strLength;
 
    if (remaining < 1)
        return false;
 
    /* add delimiter char. */
    if (hunk->pos != hunk->hunk) {
        if (remaining == 1)
            return false;
        *hunk->pos++ = '\xFF';
    }
 
    Q_strncpyz(hunk->pos, string, remaining - 1);
    hunk->pos += overflow ? remaining - 1: strLength + 1;
    hunk->entries++;
    return !overflow;
}
 
void STRHUNK_Reset (stringHunk_t* hunk)
{
    hunk->pos = hunk->hunk;
    hunk->entries = 0;
    hunk->hunk[0] = '\0';
}
 
void STRHUNK_Visit (stringHunk_t* hunk, stringHunkVisitor_t visitor)
{
    const char* string = hunk->hunk;
 
    if (hunk->entries == 0)
        return;
 
    for (;;) {
        visitor(string);
        string += strlen(string) + 1;
        if (*string != '\xFF')
            break;
        string++;
    }
}
 
int STRHUNK_Size (const stringHunk_t* hunk)
{
    return hunk->entries;
}
 
size_t STRHUNK_GetFreeSpace (const stringHunk_t* hunk)
{
    return hunk->size - (ptrdiff_t)(hunk->pos - hunk->hunk);
}
 
stringHunk_t* STRHUNK_Create (size_t size)
{
    stringHunk_t* strHunk = Mem_AllocType(stringHunk_t);
    strHunk->size = size;
    strHunk->hunk = Mem_AllocTypeN(char, size);
    strHunk->pos = strHunk->hunk;
    return strHunk;
}
 
void STRHUNK_Delete (stringHunk_t** hunk)
{
    Mem_Free(*hunk);
    *hunk = nullptr;
}