pekolib

General purpose single-header C++ library for assorted functionality and types. Some types include both a C-style and C++ style api.

peko_string

peko_string is a string type that wraps a char* so that the character data is mutable, while maintaining ease of use you may expect from a higher level string library.

struct peko_string {
  char* Data;
  int Length;
  int AllocSize;
}

Choose between C and C++ style. Defining PEKO_STRING_C before including peko_string.h will set it to use the C api.

#define PEKO_STRING_C
#include "peko_string.h"

C Style example

peko_string First;
set_string(&First, "SomeValue"); // First will have an allocated buffer that fits the size of the string automatically

peko_string Second;
set_string(&Second, &First, 100); // Copies First to Second, Second will have 100 character buffer

concat_string(&Second, &First);
resize_string(&First, 50);
trim_string(&Second);            // Reduces the buffer to the string length
search_string(&First, "Val", 2, 8);
substring(&Second, 0, 4);
clear_string(&First);

C++ Style example

The C++ style allows for setting the data with operator= and through the constructor, it will internally call .set() on itself. Due to the destructor, char* Data will automatically free() when the peko_string goes out of scope.

peko_string First;
First.set("SomeValue");

peko_string Second("Some Other Value");

// This does not reallocate for Second unless First is larger, it merely copies the characters into Second's buffer
Second = First;

First.concat(&Second);
Second.resize(256);
Second.trim();
First.search("Val", 2, 8);
// substring() behaves a little strangely compared to usual implementations. Second.Data becomes the substring after 
// the call, and a pointer to that Data is returned from the function to facilitate ease of setting another string
First = Second.substring(5, Second.Length);
First.clear();

Since the peko_string.Data is mutable, you can access it like a normal C array as well

peko_string Str("Value");
Str.Data[0] = 'W';
char C = Str.Data[3];

---

MIT License

Copyright (c) 2020 usayamaya

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.