Class String

Kernel-Bridge/API/StringsAPI.h:23–688

}

template<typename TChar> class String {
private:
    static const TChar NullChar = 0;

    // Small string optimization (using stack memory for small strings):
    static constexpr unsigned char SSO_SIZE = 32;
    __declspec(align(MEMORY_ALLOCATION_ALIGNMENT)) TChar SsoBuffer[SSO_SIZE];

    static constexpr unsigned short AllocationGranularity = 64;

    using STRING_INFO = struct {
        TChar* Buffer;
        size_t Length; // Symbols count without null-terminator
        size_t BufferSize; // Buffer size in bytes
        BOOLEAN SsoUsing;
    };

    STRING_INFO Data;

    static inline VOID SetupSso(OUT STRING_INFO* StringInfo, const TChar* SsoBuffer) {
        StringInfo->Buffer = const_cast<TChar*>(SsoBuffer);
        StringInfo->Length = 0;
        StringInfo->BufferSize = SSO_SIZE * sizeof(TChar);
        StringInfo->SsoUsing = TRUE;
        StringInfo->Buffer[0] = NullChar;
        StringInfo->Buffer[SSO_SIZE - 1] = NullChar;
    }

    static inline TChar* StrAllocMem(size_t Bytes) {
#ifdef _NTDDK_
#ifdef POOL_NX_OPTIN
        return static_cast<TChar*>(ExAllocatePoolWithTag(ExDefaultNonPagedPoolType, Bytes, StrPoolTag));
#else
        return static_cast<TChar*>(ExAllocatePoolWithTag(NonPagedPool, Bytes, StrPoolTag));
#endif
#else
        return reinterpret_cast<TChar*>(new BYTE[Bytes]);
#endif
    }

    static inline VOID StrFreeMem(TChar* Memory) {
#ifdef _NTDDK_
        ExFreePoolWithTag(Memory, StrPoolTag);
#else
        delete[] Memory;
#endif
    }

    static bool Alloc(OUT STRING_INFO* StringInfo, size_t Characters) {
        if (!StringInfo || !Characters) return false;
        *StringInfo = {};
        size_t Size = (Characters + 1) * sizeof(TChar); // Null-terminated buffer
        Size = ((Size / AllocationGranularity) + 1) * AllocationGranularity;
        TChar* Buffer = StrAllocMem(Size);
        if (!Buffer) return false;
        Buffer[0] = NullChar;
        Buffer[Characters] = NullChar;
        StringInfo->Buffer = Buffer;