codesets.library is an AmigaOS shared library to handle different codesets (i.e. ISO-8859-1, UTF-8, etc.) and their respective conversions. It provides public functions for applications to deal with multiple codesets and convert them properly.
LGPL-2.1 License
Classic Amiga systems, but even modern AmigaOS versions like AmigaOS4 and MorphOS don't come with a centralized programming interface for dealing with different codesets. Especially for the more and more important dealing with the UTF-8 codeset (e.g. in internet communication programs like YAM or SimpleMail) a centralized way or API is definitly required and provides signification advantages. In addition, it should serve as a single interface point for developers wanting to develop multi-platform applications without having to implement charset conversion routines on each OS differently.
codesets.library should solve this by providing 3rd party developers an efficient and easy to use API for dealing with different codesets like ISO-8859-15, Amiga-1251 but also the mentioned UTF-8 standard, etc. It is already widly used in known programs like YAM or SimpleMail and therefore considered very stable.
codesets.library is available for AmigaOS3, AmigaOS4, MorphOS and AROS.
The currently internally supported (hardcoded) charsets/codesets are: (conversions are possible from and to each codeset):
In addition, external charset table files can be stored in LIBS:Charsets
or loaded by an application from PROGDIR:Charsets
. The charset files included
with this distributions are:
More additional, but rarly used charset tables can be found at: http://www.unicode.org/Public/MAPPINGS/
NOTE: Please note that on operating systems having own codeset/charset querying support (e.g. AmigaOS4), codesets.library tries to use the system's functionality as much as possible and will load all additional codesets supported by the OS itself. Therefore, the above list is just meant to list the very bare minimum of supported codesets. Please check with your operating system manual before manually installing additional charset tables as they might already be available in your OS. In case an internal charset conflicts with an external charset file, the internal charset is preferred.
All releases up to the most current ones can be downloaded from our central releases management.
To report bugs use the bug/issue tracker.
Extract the archive to a temporary directory.
> cd RAM:
> lha x codesets.lha
Go to the codesets/Libs/<OS>
directory where <OS>
is the directory
matching the operating system you want to install the library for:
> cd codesets/Libs/AmigaOS4
copy the library out of the <OS>
directory to your LIBS:
directory.
> copy codesets.library LIBS:
In case you are running an operating system from which codesets.library
can't directly obtain additional charsets/codesets, you have to copy
additional charset files to the LIBS:Charsets
directory. (This is only
required for AmigaOS3 and MorphOS):
> cd RAM:codesets
> copy ALL Charsets LIBS:
reboot and enjoy the new version ;)
codesets.library was originally written in 2001 and is Copyright (C) 2001-2005 by Alfonso Ranieri. As of 2005 the library is maintained by an independent open source team and Copyright (C) 2005-2021 codesets.library Open Source Team.
codesets.library is distributed and licensed under the GNU Lesser General Public License Version 2.1. See COPYING for more detailed information.