|
mdz_ansi_alg Overview and Reference
mdz_ansi_alg - very lightweight and versatile C library, containing string-processing algorithms for handling contiguous single-byte (ASCII/ANSI) strings.
The source code is highly-portable and conforms to the ANSI C 89/90 standard. Builds are available for Win32/Win64, Linux, FreeBSD, Android, macOS.
mdz_ansi_alg Advantages
1. High Portability: The entire codebase conforms to the ANSI C 89/90 standard.
2. Minimal Dependencies: mdz_ansi_alg 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. Especially when processing very large string (e.g., hundreds of megabytes or gigabytes).
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.
Please refer to mdz_ansi_alg Wiki for API details.
mdz_ansi_alg API Reference
mdz_ansi_alg is algorithms library for contiguous single-byte string, containing ASCII (0..127) and "ANSI" (128 - 255) characters.
Functions are algorithms for processing input data. There are no memory allocations happen inside functions and no dynamic memory use.
String may contain 0-terminators ('\0') inside, and must end with 0-terminator.
Capacity - how many bytes of memory is reserved for string content. Capacity does not include 0-terminator byte, thus reserved memory should be at least 1 byte bigger than Capacity .
Size - how many characters are actually residing in a string.
Init functions:
mdz_ansi_alg_init
mdz_ansi_alg_insert
Find functions:
mdz_ansi_alg_findSingle
mdz_ansi_alg_find
mdz_ansi_alg_rfindSingle
mdz_ansi_alg_rfind
mdz_ansi_alg_firstOf
mdz_ansi_alg_firstNotOf
mdz_ansi_alg_lastOf
mdz_ansi_alg_lastNotOf
Remove functions:
mdz_ansi_alg_removeFrom
mdz_ansi_alg_remove
mdz_ansi_alg_trimLeft
mdz_ansi_alg_trimRight
mdz_ansi_alg_trim
Miscellaneous functions:
mdz_ansi_alg_compare
mdz_ansi_alg_count
Initializes mdz_ansi_alg library and license. This function should be called before any other function of the library.
mdz_bool mdz_ansi_alg_init(const unsigned long* pnFirstNameHash, const unsigned long* pnLastNameHash, const unsigned long* pnEmailHash, const unsigned long* pnLicenseHash);
Parameter | Description |
pnFirstNameHash | user first name hash code |
pnLastNameHash | user last name hash code |
pnEmailHash | user e-mail hash code |
pnLicenseHash | license hash code |
Return | Description |
mdz_true | if the initialization succeeded, otherwise mdz_false |
mdz_ansi_alg Reference
Insert pcItems into pcData from nLeftPos position. pcData and pcItems cannot overlap. New size is returned in pnDataSize .
Size and capacity - do not include 0-terminator; thus size and capacity of empty string with no free space are 0
enum mdz_error mdz_ansi_alg_insert(char* pcData, size_t* pnDataSize, size_t nDataCapacity, size_t nLeftPos, const char* pcItems, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator and have enough capacity for insertion of pcItems |
pnDataSize | pointer to current Size . Size is 0 for empty string. If insertion succeeded, new size is returned here |
nDataCapacity | maximal capacity of pcData buffer. nDataCapacity does not include 0-terminator byte, thus pcData buffer should be at least 1 byte bigger than nDataCapacity |
nLeftPos | 0-based position to insert. If nLeftPos == Size items are appended. nLeftPos > Size is not allowed |
pcItems | items to insert. Cannot be NULL |
nCount | number of items to insert. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_CAPACITY | nDataCapacity is 0 (no space for insertion) or SIZE_MAX (no space for 0-terminator) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ITEMS | pcItems is NULL |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGLEFT | nLeftPos > Size |
MDZ_ERROR_BIGCOUNT | Size + nCount > nDataCapacity |
MDZ_ERROR_OVERLAP | [pcData ; pcData + Size + nCount ] area and pcItems overlap |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
Find first occurrence of cItem in pcData . 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_alg_findSingle(const char* pcData, size_t nLeftPos, size_t nRightPos, char cItem, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based start position to search from left. Use 0 to search from the beginning of string |
nRightPos | 0-based end position to search up to. Use Size-1 to search till the end of string |
cItem | character to find |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if cItem not found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find first occurrence of pcItems in pcData 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_alg_find(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based start position to search from left. Use 0 to search from the beginning of string |
nRightPos | 0-based end position to search up to. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_BIGCOUNT | nCount is bigger than search area (between nLeftPos and nRightPos ) |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if pcItems not found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find last occurrence of cItem in pcData . 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_alg_rfindSingle(const char* pcData, size_t nLeftPos, size_t nRightPos, char cItem, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search from the end of string |
cItem | character to find |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if cItem not found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find last occurrence of pcItems in pcData 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_alg_rfind(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search from the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_BIGCOUNT | nCount is bigger than search area (between nLeftPos and nRightPos ) |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if pcItems not found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find first occurrence of any item of pcItems in string. 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_alg_firstOf(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if no item of pcItems found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find first non-occurrence of any item of pcItems in string. 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_alg_firstNotOf(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if no item of pcItems found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find last occurrence of any item of pcItems in string. 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_alg_lastOf(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if no item of pcItems found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Find last non-occurrence of any item of pcItems in string. 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_alg_lastNotOf(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based end position to find up to. Use 0 to search till the beginning of string |
nRightPos | 0-based start position to find from right. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if no item of pcItems found or error happened |
Result | 0-based position of first match |
mdz_ansi_alg Reference
Remove nCount item(s) starting from 0-based nLeftPos position
enum mdz_error mdz_ansi_alg_removeFrom(char* pcData, size_t* pnDataSize, size_t nLeftPos, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator |
pnDataSize | pointer to current Size . If removal succeed, new size is returned here |
nLeftPos | 0-based start position to remove item(s) from. Use 0 to remove from the beginning of string |
nCount | number of item(s) to remove. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_ZERO_SIZE | Size is 0 (string is empty) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGLEFT | nLeftPos >= Size |
MDZ_ERROR_BIGCOUNT | nLeftPos + nCount > Size |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
Remove all ocurrences of nCount item(s) matching to pcItems , residing between nLeftPos and nRightPos
enum mdz_error mdz_ansi_alg_remove(char* pcData, size_t* pnDataSize, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator |
pnDataSize | pointer to current Size . If removal succeed, new size is returned here |
nLeftPos | 0-based start position to remove item(s) from. Use 0 to search from the beginning of string |
nRightPos | 0-based end position to remove item(s) up to. Use Size-1 to search till the end of string |
pcItems | items to remove. Cannot be NULL |
nCount | number of item(s) to remove. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_ZERO_SIZE | Size is 0 (string is empty) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ITEMS | pcItems is NULL |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGRIGHT | nRightPos >= Size |
MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
MDZ_ERROR_BIGCOUNT | nCount is bigger than search area (between nLeftPos and nRightPos ) |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
Remove items which are contained in pcItems from left, until first non-contained in pcItems item is reached.
enum mdz_error mdz_ansi_alg_trimLeft(char* pcData, size_t* pnDataSize, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator |
pnDataSize | pointer to current Size . If removal succeed, new size is returned here |
nLeftPos | 0-based start position to trim item(s) from left. Use 0 to trim from the beginning of string |
nRightPos | 0-based end position to trim item(s) up to. Use Size-1 to trim till the end of string |
pcItems | items to trim. Cannot be NULL |
nCount | number of items to trim. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_ZERO_SIZE | Size is 0 (string is empty) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ITEMS | pcItems is NULL |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGRIGHT | nRightPos >= Size |
MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
Remove items which are contained in pcItems from right, until first non-contained in pcItems item is reached.
enum mdz_error mdz_ansi_alg_trimRight(char* pcData, size_t* pnDataSize, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator |
pnDataSize | pointer to current Size . If removal succeed, new size is returned here |
nLeftPos | 0-based end position to trim item(s) up to. Use 0 to trim till the beginning of string |
nRightPos | 0-based start position to trim item(s) from right. Use Size-1 to trim from the end of string |
pcItems | items to trim. Cannot be NULL |
nCount | number of items to trim. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_ZERO_SIZE | Size is 0 (string is empty) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ITEMS | pcItems is NULL |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGRIGHT | nRightPos >= Size |
MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
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_alg_trim(char* pcData, size_t* pnDataSize, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount);
Parameter | Description |
pcData | pointer to string. It should end with 0-terminator |
pnDataSize | pointer to current Size . If removal succeed, new size is returned here |
nLeftPos | 0-based start position to trim item(s) from left. Use 0 to trim from the beginning of string |
nRightPos | 0-based start position to trim item(s) from right. Use Size-1 to trim from the end of string |
pcItems | items to trim. Cannot be NULL |
nCount | number of items to trim. Cannot be 0 |
Return | Description |
MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
MDZ_ERROR_DATA | pcData is NULL |
MDZ_ERROR_SIZE | pnDataSize is NULL |
MDZ_ERROR_ZERO_SIZE | Size is 0 (string is empty) |
MDZ_ERROR_TERMINATOR | there is no 0-terminator in the end of pcData ([Size ] position) |
MDZ_ERROR_ITEMS | pcItems is NULL |
MDZ_ERROR_ZERO_COUNT | nCount is 0 |
MDZ_ERROR_BIGRIGHT | nRightPos >= Size |
MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
MDZ_ERROR_NONE | function succeeded, new size is written in pnDataSize |
mdz_ansi_alg Reference
Compare content of string with pcItems . If penError is not NULL , error will be written there
enum mdz_ansi_compare_result mdz_ansi_alg_compare(const char* pcData, size_t nDataSize, size_t nLeftPos, const char* pcItems, size_t nCount, mdz_bool bPartialCompare, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nDataSize | Size of pcData |
nLeftPos | 0-based start position to compare from left. Use 0 to compare from the beginning of string |
pcItems | items to compare. Cannot be NULL |
nCount | number of items to compare. Cannot be 0 |
bPartialCompare | if mdz_true compare only nCount items, otherwise compare full strings |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_SIZE | Size is 0 (empty string) |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGLEFT | nLeftPos >= Size |
| MDZ_ERROR_BIGCOUNT | nLeftPos + nCount > Size |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
MDZ_COMPARE_EQUAL or MDZ_COMPARE_NONEQUAL | Result of comparison |
mdz_ansi_alg Reference
Counts number of pcItems substring occurences in string. If penError is not NULL , error will be written there
size_t mdz_ansi_alg_count(const char* pcData, size_t nLeftPos, size_t nRightPos, const char* pcItems, size_t nCount, mdz_bool bAllowOverlapped, enum mdz_error* penError);
Parameter | Description |
pcData | pointer to string |
nLeftPos | 0-based start position to search from left. Use 0 to search from the beginning of string |
nRightPos | 0-based end position to search up to. Use Size-1 to search till the end of string |
pcItems | items to find. Cannot be NULL |
nCount | number of items to find. Cannot be 0 |
bAllowOverlapped | mdz_true if overlapped substrings should be counted, otherwise mdz_false |
penError | if not NULL , error will be written there. There are following errors possible: |
| Value | Description |
| MDZ_ERROR_LICENSE | license is not initialized using mdz_ansi_alg_init() or invalid |
| MDZ_ERROR_DATA | pcData is NULL |
| MDZ_ERROR_ITEMS | pcItems is NULL |
| MDZ_ERROR_ZERO_COUNT | nCount is 0 |
| MDZ_ERROR_BIGRIGHT | nRightPos is SIZE_MAX |
| MDZ_ERROR_BIGLEFT | nLeftPos > nRightPos |
| MDZ_ERROR_BIGCOUNT | nCount is bigger than search area (between nLeftPos and nRightPos ) |
| MDZ_ERROR_NONE | function succeeded |
Return | Description |
SIZE_MAX | if error happened |
Result | count of substring occurences. 0 if not found |
mdz_ansi_alg Reference
|