/**
 * Converting strings between charsets/codepages
 *
 * @file	platon/str/strconv.h
 * @author	Ondrej Jombik <nepto@platon.sk>
 * @version	\$Platon: libcfg+/src/platon/str/strconv.h,v 1.12 2003/04/23 19:28:37 nepto Exp $
 * @date	2000-2004
 */

#ifndef _PLATON_STR_STRCONV_H
#define _PLATON_STR_STRCONV_H

#ifndef PLATON_FUNC
# define PLATON_FUNC(_name) _name
#endif
#ifndef PLATON_FUNC_STR
# define PLATON_FUNC_STR(_name) #_name
#endif

#ifdef __cplusplus
extern "C" {
#endif

	/**
	 * Converts string from one charset to another
	 *
	 * @param	str				string to convert
	 * @param	charset_from	source charset/codepage
	 * @param	charset_to		destination charset/codepage
	 * @return	str on success, NULL on bad input parameters error
	 *
	 * See platon/str/charsets.h file for more info about charset
	 * parameters passed to this function.
	 */
	char *PLATON_FUNC(strconv)
		(char *str, char *charset_from, char *charset_to);

#ifdef __cplusplus
}
#endif

#endif /* #ifndef _PLATON_STR_STRCONV_H */