func_iconv.c

Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (c) 2005,2006,2007 Sven Slezak <sunny@mezzo.net>
00005  *
00006  * See http://www.asterisk.org for more information about
00007  * the Asterisk project. Please do not directly contact
00008  * any of the maintainers of this project for assistance;
00009  * the project provides a web site, mailing lists and IRC
00010  * channels for your use.
00011  *
00012  * This program is free software, distributed under the terms of
00013  * the GNU General Public License Version 2. See the LICENSE file
00014  * at the top of the source tree.
00015  */
00016 
00017 /*!
00018  * \file
00019  *
00020  * \brief Charset conversions
00021  *
00022  * \author Sven Slezak <sunny@mezzo.net>
00023  *
00024  * \ingroup functions
00025  */
00026 
00027 /*** MODULEINFO
00028    <depend>iconv</depend>
00029    <support_level>core</support_level>
00030  ***/
00031 
00032 #include "asterisk.h"
00033 
00034 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 413589 $")
00035 
00036 #include <ctype.h>
00037 #include <iconv.h>
00038 
00039 #include "asterisk/module.h"
00040 #include "asterisk/channel.h"
00041 #include "asterisk/pbx.h"
00042 #include "asterisk/utils.h"
00043 #include "asterisk/app.h"
00044 
00045 /*** DOCUMENTATION
00046    <function name="ICONV" language="en_US">
00047       <synopsis>
00048          Converts charsets of strings. 
00049       </synopsis>
00050       <syntax>
00051          <parameter name="in-charset" required="true">
00052             <para>Input charset</para>
00053          </parameter>
00054          <parameter name="out-charset" required="true">
00055             <para>Output charset</para>
00056          </parameter>
00057          <parameter name="string" required="true">
00058             <para>String to convert, from <replaceable>in-charset</replaceable> to <replaceable>out-charset</replaceable></para>
00059          </parameter>
00060       </syntax>
00061       <description>
00062          <para>Converts string from <replaceable>in-charset</replaceable> into <replaceable>out-charset</replaceable>.
00063          For available charsets, use <literal>iconv -l</literal> on your shell command line.</para>
00064          <note><para>Due to limitations within the API, ICONV will not currently work with
00065          charsets with embedded NULLs. If found, the string will terminate.</para></note>
00066       </description>
00067    </function>
00068  ***/
00069 
00070 
00071 /*! 
00072  * Some systems define the second arg to iconv() as (const char *),
00073  * while others define it as (char *).  Cast it to a (void *) to 
00074  * suppress compiler warnings about it. 
00075  */
00076 #define AST_ICONV_CAST void *
00077 
00078 static int iconv_read(struct ast_channel *chan, const char *cmd, char *arguments, char *buf, size_t len)
00079 {
00080    AST_DECLARE_APP_ARGS(args,
00081       AST_APP_ARG(in_charset);
00082       AST_APP_ARG(out_charset);
00083       AST_APP_ARG(text);
00084    );
00085    iconv_t cd;
00086    size_t incount, outcount = len;
00087    char *parse;
00088 
00089    if (ast_strlen_zero(arguments)) {
00090       ast_log(LOG_WARNING, "Syntax: ICONV(<in-charset>,<out-charset>,<text>) - missing arguments!\n");
00091       return -1;
00092    }
00093 
00094    parse = ast_strdupa(arguments);
00095    AST_STANDARD_APP_ARGS(args, parse);
00096 
00097    if (args.argc < 3) {
00098       ast_log(LOG_WARNING, "Syntax: ICONV(<in-charset>,<out-charset>,<text>) %u\n", args.argc);
00099       return -1;
00100    }
00101 
00102    incount = strlen(args.text);
00103 
00104    ast_debug(1, "Iconv: \"%s\" %s -> %s\n", args.text, args.in_charset, args.out_charset);
00105 
00106    cd = iconv_open(args.out_charset, args.in_charset);
00107 
00108    if (cd == (iconv_t) -1) {
00109       ast_log(LOG_ERROR, "conversion from '%s' to '%s' not available. type 'iconv -l' in a shell to list the supported charsets.\n", args.in_charset, args.out_charset);
00110       return -1;
00111    }
00112 
00113    if (iconv(cd, (AST_ICONV_CAST) &args.text, &incount, &buf, &outcount) == (size_t) -1) {
00114       if (errno == E2BIG)
00115          ast_log(LOG_WARNING, "Iconv: output buffer too small.\n");
00116       else if (errno == EILSEQ)
00117          ast_log(LOG_WARNING,  "Iconv: illegal character.\n");
00118       else if (errno == EINVAL)
00119          ast_log(LOG_WARNING,  "Iconv: incomplete character sequence.\n");
00120       else
00121          ast_log(LOG_WARNING,  "Iconv: error %d: %s.\n", errno, strerror(errno));
00122    }
00123    iconv_close(cd);
00124 
00125    return 0;
00126 }
00127 
00128 
00129 static struct ast_custom_function iconv_function = {
00130    .name = "ICONV",
00131    .read = iconv_read
00132 };
00133 
00134 static int unload_module(void)
00135 {
00136    return ast_custom_function_unregister(&iconv_function);
00137 }
00138 
00139 static int load_module(void)
00140 {
00141    return ast_custom_function_register(&iconv_function);
00142 }
00143 
00144 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Charset conversions");
00145 

Generated on Thu Apr 16 06:27:35 2015 for Asterisk - The Open Source Telephony Project by  doxygen 1.5.6