SimpleParse Documentation

String Extraction and Signature Parsing Module

SimpleParse is a specialized module for extracting data between markers and identifying function-like signatures within string buffers. It is designed for lightweight scripting or configuration parsing where a full regex engine is overkill.

->rarr; Context Aware: Returns a Parsed struct containing global offsets, line numbers, and column positions.

-->rarr;rdsh; Structural Parsing: Automatically separates a match into its "Full String", "Signature", and "Inner Content".

-->rarr;rdsh; Tokenized Arguments: Automatically parses comma-separated arguments into a pointer array for direct access.

Core Extraction API

% Memory: parselineadv performs heap allocations for arguments in conparsed. Use freeconparsed() to prevent memory leaks. %

Logic & Navigation

Advanced Extraction: parselineadv is the primary engine for identifying lines and extracting their contents in one pass.

* Automatic Tokenization: When parselineadv detects parentheses (), it automatically populates the conparsed array by splitting content by commas.

* Memory Management: Because conparsed stores heap-allocated integers and strings, always call freeconparsed(&p) after processing the struct.

Advanced Parsing Example

const char* code = "something(1, \"Hello!\");";

Parsed p = parselineadv(code, 1);

Accessing parsed arguments:

int val = *(int*)p.conparsed[0];

char* str = (char*)p.conparsed[1];

Cleanup after use:

freeconparsed(&p);

$$High Priority$$

\ All string fields in the Parsed struct have a fixed limit of 256 characters. \

\ The conparsed array supports up to 64 arguments. \

$$$Warning!!$$$

Ensure the haystack buffer is null-terminated before passing it to any SimpleParse function to avoid memory overruns.

Module: SimpleThreads.h

Cross-Platform Multi-Threading Library

SimpleThreads is a zero-boilerplate, single-header library for C. It abstracts away the differences between Win32 API and POSIX Threads (pthreads) using an ID-based system.

Functionality

Thread Management

Core API

->rarr; Uses a static pool of 256 thread slots.

   int my_calc(int a, int b) {
       return a + b;
   }

   char* my_name(char* input) {
       return input;
   }

   // Inside main
   spawnthread(my_calc, "10, 20", 0);
   spawnthread(my_name, "\"Ted\"", 1);

   int res = *(int*)getreturn(0);
   char* name = (char*)getreturn(1);

// Formatting Examples
char* s = str_format("User ID: %d", 101); 
str_upper(s); // "USER ID: 101" 
str_trim(s);  // Removes whitespace 

// JSON Example
char* j = json_obj("s:name, i:age, b:active", "Ted", 21, 1); 
// Returns: {"name":"Ted", "age":21, "active":true}

    // 1. Declare and Initialize to Zero
    suint12288 big_val; 
    memset(&big_val, 0, sizeof(big_val));

    // 2. Assign and Manipulate
    big_val.limbs[0] = 1;
    suint12288_shl(&big_val, 12000); // 2^12000

    // 3. Print Results
    printf("Decimal Value: ");
    slibprint(big_val);