maxdz Software GmbH

mdz_ansi_16 Overview and Reference

mdz_ansi_16 Advantages

1. High Portability: The entire codebase conforms to the ANSI C 89/90 standard.

2. Minimal Dependencies: mdz_ansi_16 functions solely depend on standard C-library functions. This means you can integrate the library into your code without any additional dependencies beyond the standard platform libraries/APIs.

3. Performance: The library functions are highly optimized for speed, particularly for operations like searching.

4. Flexibilty: Most library functions offer both "left position" and "right position" parameters, allowing you to limit the processing area. Additionally, the library provides more string functions than comparable libraries such as STL, Boost, or GLib.

5. Extended Error-Checking: All functions use strict error-checking mechanisms and return specific error codes pointing the problem precisely.

6. Extended Control: The functions perform only explicit operations. For example, when an "insert" function is called, it will return an error if there is not enough capacity in string - no implicit memory allocations/reservations will be made.

7. No Memory Overhead: The functions are designed to process input data without making internal memory allocations or using dynamic memory.

8. Metadata encapsulated: String controls its Size and Capacity, thus making automatical checking and if necessary adjustment during each string function call.

mdz_ansi_16 General Information and Functions

mdz_ansi_16 is library for contiguous single-byte string, containing ASCII (0..127) and "ANSI" (128 - 255) characters.
There are no dynamic memory-allocations happen inside functions.

String may contain 0-terminators ('\0') inside, and must end with 0-terminator.

String should be attached to static/pre-allocated char
buffer and contains metadata (Size, Capacity).

Capacity - how many bytes of memory is reserved for string content.
Size - how many characters are actually residing in a string.

Init functions:

mdz_ansi_16_init
mdz_ansi_16_attach

Status functions:

mdz_ansi_16_size
mdz_ansi_16_capacity
mdz_ansi_16_data
mdz_ansi_16_dataConst

Insert/remove functions:

mdz_ansi_16_insert
mdz_ansi_16_removeFrom
mdz_ansi_16_remove
mdz_ansi_16_trimLeft
mdz_ansi_16_trimRight
mdz_ansi_16_trim

Find functions:

mdz_ansi_16_findSingle
mdz_ansi_16_find
mdz_ansi_16_rfindSingle
mdz_ansi_16_rfind
mdz_ansi_16_firstOf
mdz_ansi_16_firstNotOf
mdz_ansi_16_lastOf
mdz_ansi_16_lastNotOf

Miscellaneous functions:

mdz_ansi_16_compare
mdz_ansi_16_count
mdz_ansi_16_replace
mdz_ansi_16_reverse

mdz_ansi_16_init

Initializes mdz_ansi_16 library and license. This function should be called before any other function of the library.

mdz_bool mdz_ansi_16_init(const unsigned long* pnFirstNameHash, const unsigned long* pnLastNameHash, const unsigned long* pnEmailHash, const unsigned long* pnLicenseHash);

mdz_ansi_16_attach

Attach string to pre-allocated pcBuffer of nBufferSize bytes. If penError is not NULL, error will be written there

mdz_Ansi16* mdz_ansi_16_attach(char* pcBuffer, unsigned short nBufferSize, enum mdz_error* penError);

mdz_ansi_16_size

Return Size of string Data in characters/bytes.

unsigned short mdz_ansi_16_size(const mdz_Ansi16* psAnsi);

mdz_ansi_16_capacity

Return Capacity of string Data in characters/bytes.

unsigned short mdz_ansi_16_capacity(const mdz_Ansi16* psAnsi);

mdz_ansi_16_data

Return pointer to string Data.

char* mdz_ansi_16_data(mdz_Ansi16* psAnsi);

mdz_ansi_16_dataConst

Return const pointer to string Data.

const char* mdz_ansi_16_dataConst(const mdz_Ansi16* psAnsi);

mdz_ansi_16_insert

Insert pcItems from nLeftPos position. Data and pcItems cannot overlap. New Size is written in psAnsi.

enum mdz_error mdz_ansi_16_insert(mdz_Ansi16* psAnsi, size_t nLeftPos, const char* pcItems, size_t nCount);

mdz_ansi_16_findSingle

Find first occurrence of cItem. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_findSingle(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, char cItem, enum mdz_error* penError);

mdz_ansi_16_find

Find first occurrence of pcItems using optimized Boyer-Moore-Horspool search. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_find(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_rfindSingle

Find last occurrence of cItem. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_rfindSingle(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, char cItem, enum mdz_error* penError);

mdz_ansi_16_rfind

Find last occurrence of pcItems using optimized Boyer-Moore-Horspool search. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_rfind(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_firstOf

Find first occurrence of any item of pcItems. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_firstOf(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_firstNotOf

Find first non-occurrence of any item of pcItems. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_firstNotOf(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_lastOf

Find last occurrence of any item of pcItems. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_lastOf(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_lastNotOf

Find last non-occurrence of any item of pcItems. Returns 0-based position of match (if found), or SIZE_MAX if not found or error happened. If penError is not NULL, error will be written there

size_t mdz_ansi_16_lastNotOf(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);

mdz_ansi_16_removeFrom

Remove nCount item(s) starting from 0-based nLeftPos position

enum mdz_error mdz_ansi_16_removeFrom(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nCount);

mdz_ansi_16_remove

Remove all ocurrences of nCount item(s) matching to pcItems, residing between nLeftPos and nRightPos

enum mdz_error mdz_ansi_16_remove(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, mdz_bool bFromLeft);

mdz_ansi_16_trimLeft

Remove items which are contained in pcItems from left, until first non-contained in pcItems item is reached.

enum mdz_error mdz_ansi_16_trimLeft(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);

mdz_ansi_16_trimRight

Remove items which are contained in pcItems from right, until first non-contained in pcItems item is reached.

enum mdz_error mdz_ansi_16_trimRight(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);

mdz_ansi_16_trim

Remove items which are contained in pcItems from left and from right, until first non-contained in pcItems item is reached.

enum mdz_error mdz_ansi_16_trim(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);

mdz_ansi_16_compare

Compare content of Data with pcItems. If penError is not NULL, error will be written there

enum mdz_ansi_compare_result mdz_ansi_16_compare(const mdz_Ansi16* psAnsi, size_t nLeftPos, const char* pcItems, size_t nCount, mdz_bool bPartialCompare, enum mdz_error* penError);

mdz_ansi_16_count

Counts number of pcItems substring occurences in Data. If penError is not NULL, error will be written there

size_t mdz_ansi_16_count(const mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, mdz_bool bAllowOverlapped, mdz_bool bFromLeft, enum mdz_error* penError);

mdz_ansi_16_replace

Replace every occurence of pcItemsBefore with pcItemsAfter in Data. There should be enough Capacity for replacing data.

enum mdz_error mdz_ansi_16_replace(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos, const char* pcItemsBefore, size_t nCountBefore, const char* pcItemsAfter, size_t nCountAfter, mdz_bool bFromLeft, enum mdz_ansi_replace_type enReplacementType);

mdz_ansi_16_reverse

Reverses characters in string, like "1234" into "4321".

enum mdz_error mdz_ansi_16_reverse(mdz_Ansi16* psAnsi, size_t nLeftPos, size_t nRightPos);