0000598: Provide FLAM character conversion modul as separate target

Notes
(0000697) Falk Reichbott (administrator) 2014-11-21 15:56	Separate DLL for character conversion (libfl5icv.so/dll FL5ICVLB) add with version 5.1.2. Doxygen interface specification is still unter construction.

(0000704) Falk Reichbott (administrator) 2014-11-27 08:18 edited on: 2014-11-27 08:31	Available with version 5.1.2 Description This module provides a libiconv conform interface for memory to memory character conversion. All special feature of the FLUC character conversion module are provided over the TO and FROM string specification in fliconv_open() function. iconvlist(NULL,NULL); h=iconv_open("UTF16LE//BOM","1141//ELF2NL//IGNORE//TRANSLIT//REPORT(report.txt)"); r=iconv(h,&inDat,&inLen,&outDat,&outLen); iconv_close(h); Please have a look at the FLICONV.c sample file which implements the linux like ICONV utility (fliconv) based on this library. The open function supports encoding strings and CCSIDS. The fliconv_list() function provides all supported CCSIDs, CHARSETs and the corresponding encoding strings. If the compiler switch FICONV defined, then all the 'fliconv' entries are also available as 'iconv' functions. Means to port your existing code you must simply replace: -#include<iconf.h> +#define FICONV +#include"FLCICV.h" With this replacement you can re-build your source. To use the special features you must extent our encoding strings specifications. Input encoding string enhancements: //BOM - Manage byte order change //ENL2LF - Convert EBCDIC new line (0x15) to line feed (0x0A) Output encoding string enhancements: //BOM - Write byte order mark //ELF2NL - Convert EBCDIC line feed (0x0A) to new line (0x15) //TOUPPER - Upper case mapping //TOLOWER - Lower case mapping //TOSUPPER - Special upper case mapping //TOSLOWER - Special lower case mapping //TOFOLD - Special case folding //TOUESR - User table/module defined case mapping //IGNORE - Ignore invalid characters //TRANSLIT['('[systab]')'] - Transliterate invalid characters [ICONV] //SUBSTITUTE['('[codepoint_list]')'] - Substitute invalid characters [0x1A] //USRMOD'('module_name')' - Use a predefined user table module //USRTAB'('file_name')' - Use a free defined user table text file //REPORT['('[file_name]')'] - Write a report file [STDERR] Current supported system transliteration table: ICONV - Transliteration table of libiconv Current supported user table module names: CCUTNPAS - UCS subset for String-Latin (XOEV/NPA) CCUTSPEA - UCS subset for SEPA (all valid UTF-8 character < 128) CCUTDELA - UCS subset of IBM1141, CP1252 and ISO8859-15 CCUTDLAX - UCS Subset of IBM1141, CP1252, ISO8859-15 and XOEF For more information about free defined user table text file please refer to the FLCL user manual. Advantage to normal iconv implementations: - Support of encoding string and CCSIDs, list supported CCSIDs and Encoding strings - EBCDIC New Line (0x15) to Line Feed (0x0A) management - Subset support (String.Latin, SEPA, ...) and free defined user tables - Recursive mapping and transliteration ('U:'->'UE') - Case mapping, comprehensive reporting, byte order change handling - A little bit faster and less memory and CPU consumption Differences to the normal iconv: - Use more errno's (mainly for user table parsing and such things, not for conversion it self) - E2BIG is set if the output buffer smaller then the input data multiplied by the provided expansion factor -> No data is converted if the output buffer to small (increase performance significantly) - More functions to provide about, version, license, statistic, error and other information - Byte order mark is only printed to the output file if the BOM keyword defined in the TO string - The list function get encoding string, the CCSID and the corresponding CHARSET (UTF/ASCII/EBCDIC) information For additional information please refer to the interface specification in the Download area.

Issue History
Date Modified	Username	Field	Change
2014-11-13 12:01	Falk Reichbott	New Issue
2014-11-13 12:01	Falk Reichbott	Status	new => assigned
2014-11-13 12:01	Falk Reichbott	Assigned To	=> Mykhailo Moldavskyy
2014-11-18 07:57	Falk Reichbott	Target Version	5.2 => 5.1
2014-11-21 15:56	Falk Reichbott	Note Added: 0000697
2014-11-27 08:18	Falk Reichbott	Note Added: 0000704
2014-11-27 08:18	Falk Reichbott	Status	assigned => resolved
2014-11-27 08:18	Falk Reichbott	Fixed in Version	=> 5.1
2014-11-27 08:18	Falk Reichbott	Resolution	open => fixed
2014-11-27 08:31	Falk Reichbott	Note Edited: 0000704	View Revisions
2014-12-02 07:43	Falk Reichbott	Category	4. Element, Byte or Record API => 4. Element, Byte, Record or other API
2015-04-15 15:36	Falk Reichbott	Fixed in Version	5.1 => 5.1.02

Relationships