ABOUT:

The Chaga string arithmetic library (libchaga) allows one to compute numbers with arbitrary 
precision. This library is a key component of the Chaga programming language and the Chaga 
compiler; however, the Chaga string arithmetic library can also be utilized as a standalone 
product.

Documentation is posted online at:
https://chagaprogramminglanguage.org/documentation.html

Chaga string arithmetic library
Copyright (C) 2026 Robert James Bruce

The Chaga string arithmetic library is free software: you can redistribute it and/or modify it 
under the terms of the GNU General Public License as published by the Free Software Foundation, 
either version 3 of the License, or (at your option) any later version.

The Chaga string arithmetic library is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 
PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License 
along with the Chaga compiler. If not, see <https://www.gnu.org/licenses/>.


DOWNLOAD:

Source code for the Chaga string arithmetic library is available at:
https://chagaprogramminglanguage.org/download.html


BUILDING:

The Chaga string arithmetic library is written in the C programming language and can be compiled 
with the GNU C compiler. The Chaga string arithmetic library may be statically linked to an 
application or dynamically linked as a shared object (also called a Dynamic Linked Library or 
DLL). Successfully building the Chaga string arithmetic library will create three binary files: 
a statically linked library, a shared object library, and a demonstration program which tests 
and most of the features of the Chaga string arithmetic library.

Unpack the Chaga compiler collection archive:

tar xzf ./libchaga-0.5.9.tgz
cd ./libchaga/build
cmake ..
make
make install

Note: the last step "make install" may require administrator priviledges. The static and shared 
libchaga library will be automatically installed in /usr/local/lib on Unix-like operating systems
(GNU/Linux, MacOS, etc.).


GNU/LINUX DISTRIBUTIONS:

If the installation is successful, use sudo (super-user do) or login with administrator 
priviledges to run the following command: ldconfig -v

If /usr/local/lib is a path in your libraries, you should see libchaga.so and libchaga_static.a
listed in the output from the ldconfig command above.


TESTING:

In the local build directory where you built the Chaga string arithmetic library is a file named:
chaga_string_arithmetic_library_testing

This program runs many tests to validate the results of the Chaga string arithmetic library. I hope
you enjoy the library and find it useful for computation.


QUESTIONS OR COMMENTS:
Please email Robert Bruce at: rob@chagaprogramminglanguage.org

