From 605c4d1739e5b3e5069a24bb68708cd1a787cee6 Mon Sep 17 00:00:00 2001 From: Herwin Bozet Date: Wed, 30 Sep 2026 22:03:10 +0200 Subject: [PATCH] Update CLAUDE.md, CRC32B.pbi, _ChainedHashMap.pbi, and 1 more file --- CLAUDE.md | 15 +++ core/commons/CRC32B/CRC32B.pbi | 82 +++++++++++++++ core/commons/HashMap/HashMap.pbi | 8 ++ core/commons/HashMap/_ChainedHashMap.pbi | 121 +++++++++++++++++++++++ 4 files changed, 226 insertions(+) create mode 100644 CLAUDE.md create mode 100644 core/commons/CRC32B/CRC32B.pbi create mode 100644 core/commons/HashMap/HashMap.pbi create mode 100644 core/commons/HashMap/_ChainedHashMap.pbi diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..df6e47d --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,15 @@ +# YASS 13 - Claude AI Instructions + +## Languages +* PureBasic + +## Structure +* core - ... + * client - ... + * commons - Code shared between client and server + * CRC32B - Hashing algo + * HashMap - HashMap implementation**s** + * server - ... +* defs - ... + * items - ... + * reagents - ... diff --git a/core/commons/CRC32B/CRC32B.pbi b/core/commons/CRC32B/CRC32B.pbi new file mode 100644 index 0000000..f17efe4 --- /dev/null +++ b/core/commons/CRC32B/CRC32B.pbi @@ -0,0 +1,82 @@ +;{- Code Header +; ==- Basic Info -================================ +; Name: CRC32B.pbi +; Author: Herwin Bozet (NibblePoker) +; +; ==- Compatibility -============================= +; Tested compiler version: +; * PureBasic 5.73 LTS (x86/x64) +; * PureBasic 6.21 (x86/x64) +; * PureBasic 6.21 C Backend (arm64) +; +; ==- Links & License -=========================== +; License: CC0 1.0 Universal (Public Domain) +;} + + +; ------------------------------------------------------------------------------ +;- Notes + +; Based on: +; * https://github.com/aziascreations/C99-Utility-Libraries/blob/master/src/hash/crc32/crc32.c + + + +; ------------------------------------------------------------------------------ +;- Public Static Functions + +Procedure.q Hash_CRC32B(*sourceData, sourceDataSize.i) + Protected byteOffset.i + Protected currentByte.a + Protected crc32Checksum.q = $FFFFFFFF + Protected tableIndex.i + + For byteOffset = 0 To sourceDataSize - 1 + currentByte = PeekA(*sourceData + byteOffset) + tableIndex = (currentByte ! crc32Checksum) & 255 + crc32Checksum = (crc32Checksum >> 8) ! (PeekL(?CRC32B_Table + tableIndex * 4) & $FFFFFFFF) + Next byteOffset + + ProcedureReturn (~crc32Checksum) & $FFFFFFFF +EndProcedure + + + +; ------------------------------------------------------------------------------ +;- DataSection + +DataSection + CRC32B_Table: + Data.l $00000000, $77073096, $ee0e612c, $990951ba, $076dc419, $706af48f, $e963a535, $9e6495a3 + Data.l $0edb8832, $79dcb8a4, $e0d5e91e, $97d2d988, $09b64c2b, $7eb17cbd, $e7b82d07, $90bf1d91 + Data.l $1db71064, $6ab020f2, $f3b97148, $84be41de, $1adad47d, $6ddde4eb, $f4d4b551, $83d385c7 + Data.l $136c9856, $646ba8c0, $fd62f97a, $8a65c9ec, $14015c4f, $63066cd9, $fa0f3d63, $8d080df5 + Data.l $3b6e20c8, $4c69105e, $d56041e4, $a2677172, $3c03e4d1, $4b04d447, $d20d85fd, $a50ab56b + Data.l $35b5a8fa, $42b2986c, $dbbbc9d6, $acbcf940, $32d86ce3, $45df5c75, $dcd60dcf, $abd13d59 + Data.l $26d930ac, $51de003a, $c8d75180, $bfd06116, $21b4f4b5, $56b3c423, $cfba9599, $b8bda50f + Data.l $2802b89e, $5f058808, $c60cd9b2, $b10be924, $2f6f7c87, $58684c11, $c1611dab, $b6662d3d + Data.l $76dc4190, $01db7106, $98d220bc, $efd5102a, $71b18589, $06b6b51f, $9fbfe4a5, $e8b8d433 + Data.l $7807c9a2, $0f00f934, $9609a88e, $e10e9818, $7f6a0dbb, $086d3d2d, $91646c97, $e6635c01 + Data.l $6b6b51f4, $1c6c6162, $856530d8, $f262004e, $6c0695ed, $1b01a57b, $8208f4c1, $f50fc457 + Data.l $65b0d9c6, $12b7e950, $8bbeb8ea, $fcb9887c, $62dd1ddf, $15da2d49, $8cd37cf3, $fbd44c65 + Data.l $4db26158, $3ab551ce, $a3bc0074, $d4bb30e2, $4adfa541, $3dd895d7, $a4d1c46d, $d3d6f4fb + Data.l $4369e96a, $346ed9fc, $ad678846, $da60b8d0, $44042d73, $33031de5, $aa0a4c5f, $dd0d7cc9 + Data.l $5005713c, $270241aa, $be0b1010, $c90c2086, $5768b525, $206f85b3, $b966d409, $ce61e49f + Data.l $5edef90e, $29d9c998, $b0d09822, $c7d7a8b4, $59b33d17, $2eb40d81, $b7bd5c3b, $c0ba6cad + Data.l $edb88320, $9abfb3b6, $03b6e20c, $74b1d29a, $ead54739, $9dd277af, $04db2615, $73dc1683 + Data.l $e3630b12, $94643b84, $0d6d6a3e, $7a6a5aa8, $e40ecf0b, $9309ff9d, $0a00ae27, $7d079eb1 + Data.l $f00f9344, $8708a3d2, $1e01f268, $6906c2fe, $f762575d, $806567cb, $196c3671, $6e6b06e7 + Data.l $fed41b76, $89d32be0, $10da7a5a, $67dd4acc, $f9b9df6f, $8ebeeff9, $17b7be43, $60b08ed5 + Data.l $d6d6a3e8, $a1d1937e, $38d8c2c4, $4fdff252, $d1bb67f1, $a6bc5767, $3fb506dd, $48b2364b + Data.l $d80d2bda, $af0a1b4c, $36034af6, $41047a60, $df60efc3, $a867df55, $316e8eef, $4669be79 + Data.l $cb61b38c, $bc66831a, $256fd2a0, $5268e236, $cc0c7795, $bb0b4703, $220216b9, $5505262f + Data.l $c5ba3bbe, $b2bd0b28, $2bb45a92, $5cb36a04, $c2d7ffa7, $b5d0cf31, $2cd99e8b, $5bdeae1d + Data.l $9b64c2b0, $ec63f226, $756aa39c, $026d930a, $9c0906a9, $eb0e363f, $72076785, $05005713 + Data.l $95bf4a82, $e2b87a14, $7bb12bae, $0cb61b38, $92d28e9b, $e5d5be0d, $7cdcefb7, $0bdbdf21 + Data.l $86d3d2d4, $f1d4e242, $68ddb3f8, $1fda836e, $81be16cd, $f6b9265b, $6fb077e1, $18b74777 + Data.l $88085ae6, $ff0f6a70, $66063bca, $11010b5c, $8f659eff, $f862ae69, $616bffd3, $166ccf45 + Data.l $a00ae278, $d70dd2ee, $4e048354, $3903b3c2, $a7672661, $d06016f7, $4969474d, $3e6e77db + Data.l $aed16a4a, $d9d65adc, $40df0b66, $37d83bf0, $a9bcae53, $debb9ec5, $47b2cf7f, $30b5ffe9 + Data.l $bdbdf21c, $cabac28a, $53b39330, $24b4a3a6, $bad03605, $cdd70693, $54de5729, $23d967bf + Data.l $b3667a2e, $c4614ab8, $5d681b02, $2a6f2b94, $b40bbe37, $c30c8ea1, $5a05df1b, $2d02ef8d +EndDataSection diff --git a/core/commons/HashMap/HashMap.pbi b/core/commons/HashMap/HashMap.pbi new file mode 100644 index 0000000..04a5ee9 --- /dev/null +++ b/core/commons/HashMap/HashMap.pbi @@ -0,0 +1,8 @@ + +#YASS13_HashMap_Type = "Chained" + +CompilerIf #YASS13_HashMap_Type = "Chained" + +CompilerElse + CompilerError("You must defined a valid core hashmap type !") +CompilerEndIf diff --git a/core/commons/HashMap/_ChainedHashMap.pbi b/core/commons/HashMap/_ChainedHashMap.pbi new file mode 100644 index 0000000..abb95c3 --- /dev/null +++ b/core/commons/HashMap/_ChainedHashMap.pbi @@ -0,0 +1,121 @@ + +EnableExplicit + +#HashMap_InitialPower = 9 +#HashMap_InsertIterations = 100000 + +;{ + +Structure ChainedHashMapBucket + *BucketData + *Next.ChainedHashMapBucket + Hash.q +EndStructure + +Structure ChainedHashMap + EntryCount.i + Capacity.i + SizePower.a + *Buckets.ChainedHashMapBucket[0] +EndStructure + + +Prototype CbFree(*Data) + +Procedure.l MakeBitMask(BitCount.b) + EnableASM + MOV eax, $00000001 + MOV cl, BitCount + SHL eax, cl + DEC eax + ProcedureReturn + DisableASM +EndProcedure + +Procedure.i CHM_Create(SizePower.b) + Protected *CHM.ChainedHashMap = AllocateMemory(SizeOf(ChainedHashMap) + (SizeOf(Integer) * (MakeBitMask(SizePower) + 1))) + + If *CHM <> #Null + *CHM\EntryCount = 0 + *CHM\SizePower = SizePower + + Protected iBucket + For iBucket = 0 To MakeBitMask(SizePower) + *CHM\Buckets[iBucket] = #Null + Next + EndIf + + ProcedureReturn *CHM +EndProcedure + +Procedure.i CHM_GetByHash(*CHM.ChainedHashMap, Hash.q) + If *CHM <> #Null + Protected *CurrentBucket.ChainedHashMapBucket = *CHM\Buckets[(Hash & MakeBitMask(*CHM\SizePower))] + + While *CurrentBucket <> #Null + If *CurrentBucket\Hash = Hash + ProcedureReturn *CurrentBucket\BucketData + EndIf + *CurrentBucket = *CurrentBucket\Next + Wend + EndIf + + ProcedureReturn #Null +EndProcedure + +Procedure.b CHM_OverwriteByHash(*CHM.ChainedHashMap, *Data, Hash.q, *FreeingCallback.CbFree = #Null) + If *CHM <> #Null + Protected *PreviousBucket.ChainedHashMapBucket = #Null + Protected *CurrentBucket.ChainedHashMapBucket = *CHM\Buckets[(Hash & MakeBitMask(*CHM\SizePower))] + + ; We iterate over the bucket chain until we find a collision or an in-between. + While *CurrentBucket <> #Null + If *CurrentBucket\Hash >= Hash + Break + EndIf + *PreviousBucket = *CurrentBucket + *CurrentBucket = *CurrentBucket\Next + Wend + + If *CurrentBucket = #Null Or *CurrentBucket\Hash <> Hash + ; We either reached the end of the list, or no buckets was in the current slot. + ; Or, we have an in-between, or we are at the start of the list. + Protected *NewBucket.ChainedHashMapBucket = AllocateMemory(SizeOf(ChainedHashMapBucket)) + + If *NewBucket <> #Null + *NewBucket\Next = *CurrentBucket + *NewBucket\BucketData = *Data + *NewBucket\Hash = Hash + + If *PreviousBucket <> #Null + ; In-between, or we are at the start of the List. + *PreviousBucket\Next = *NewBucket + Else + ; Start of the list. + *CHM\Buckets[(Hash & MakeBitMask(*CHM\SizePower))] = *NewBucket + EndIf + + *CHM\EntryCount = *CHM\EntryCount + 1 + ProcedureReturn #True + EndIf + ElseIf *FreeingCallback <> #Null + ; Handling collision. + CallFunctionFast(*FreeingCallback, *CurrentBucket\BucketData) + *CurrentBucket\BucketData = *Data + ProcedureReturn #True + EndIf + ; Implied else: Handling collision while forbidden to overwrite => doing nothing. + EndIf + + ProcedureReturn #False +EndProcedure + +Procedure CHM_DeleteByHash(*CHM.ChainedHashMap, Hash.q) + +EndProcedure + +Procedure CHM_Free(*CHM.ChainedHashMap) + +EndProcedure + +Procedure NoopFree(*Data) : EndProcedure