IntStr

Index

• Index;
• About;
• Examples;
• Building;
• Installation;
• Documentation.

About

This is a small C99 library for integer parsing and formatting. Parsing and fomratting functions work in stream-mode, i.e. they accept read and write callback functions as arguments and hence can work with any kind of character streams such as files and strings.

Out of the box there are special versions of parse and format functions with _file, _str and _str_n suffixes which handle files, strings and strings of specified size respectively.

Examples

Code:

#include <stdio.h>

#include <fominmv/intstr/all.h>

int main() {
    mint_fmt_file(2498, stdout, NULL);

    putchar('\n');

    struct mint_fmt_opts opts = MINT_FMT_OPTS_DEFAULT;

    opts.group_sep  = "_";
    opts.group_size = 3;
    opts.plus       = MINT_PLUS_SIGN;

    mint_fmt_file(2498000, stdout, &opts);

    putchar('\n');
}

Output:

2498
+2_498_000

Building

For building and installing a library you must have CMake installed.

First, configure a project running the following command in terminal:

cmake -B build -S .

Then if you want to build it as a shared library run the following command:

cmake -DBUILD_SHARED_LIBS=ON build

And finally build a library with the following command:

cmake --build build

Installation

Before installing you must first build a library.

If library is already built go to the project's root folder and run the following command in terminal:

cmake --install build

Documentation

You can wether use online documentation or build it locally.

To build documentation locally you must have Doxygen installed.

When it's installed go to the project's root folder and run the following command in the terminal:

doxygen

After this you will have a documentaion build in the /docs folder.