Click here to Skip to main content
15,867,686 members
Articles / Programming Languages / C++

How to Build libiconv with Microsoft Visual Studio

Rate me:
Please Sign up or sign in to vote.
4.85/5 (33 votes)
21 Dec 2011LGPL36 min read 162.6K   12.6K   63   35
The GNU library libiconv does not provide the way to build the library with Microsoft Visual Studio now. But, I want to share my way to do so

Introduction

Libiconv is one of the most useful and famous libraries that converts texts between encodings and has been developed under GNU projects. However, now it does not provide the way to build it with Microsoft Visual Studio but with gcc. Before, it had provided but now stopped explaining how to build it with Microsoft Visual Studio. However, many of the computer programmers are using Microsoft Visual Studio and want to build libiconv with Microsoft Visual Studio. So, this article is about how to build libiconv with Microsoft Visual Studio. If you can build libiconv with Microsoft Visual Studio, you will be able to change various compilation options and build it in order to optimize libiconv according to your preference and needs.

Background

If you have no idea about libiconv, you can refer to it here or you can Google for it. You may be confused with iconv and libiconv. Iconv is the executable program that uses libiconv while libiconv is the library for converting text strings between two different encodings. This article is related to libiconv. However, this article is not about libiconv but about how to build libiconv with Microsoft Visual Studio. The GNU library libiconv is under LGPL license. So, you have to be really careful when you use libiconv for your commercial use or when you don't want to publicize your source code. About LPGL license, you can refer here.

How to Get the Source Code of libiconv

At the moment, the most recent version of libiconv is 1.14. You can download the source code of libiconv 1.14 here and here. Of course, you can get the older versions of libiconv here.

How to Build

I am going to explain the case of Microsoft Visual Studio 2010 professional edition but the explanation can be applied to the earlier versions of Microsoft Visual Studio and to the express edition of each of them.

First Step

You download the most recent version of libiconv which is 1.14 from here or here. And unzip the downloaded file "libiconv-1.14.tar.gz" on your certain folder.

Second Step

You run your Microsoft Visual Studio. Then, you make a new WIN32 project. Let's say "libiconv" as the project name. Check to create directory for solution. Choose DLL as the application type and check Empty project for additional options. Click the button "finish" to generate the new project.

Image 1

Image 2

Third Step

Now, you have to copy some files from the folders generated by unzipping "libiconv-1.14.tar.gz" to the project folders. To build "libiconv", you need to compile three files "localcharset.c", "relocatable.c" and "iconv.c". That is the key idea!

Copy three files "relocatable.h", "relocatable.c" and "iconv.c" in the folder "...\libiconv-1.14\lib\" to the project folder "...\libiconv\libiconv\".
Copy "...\libiconv-1.14\libcharset\lib\localcharset.c" to the project folder "...\libiconv\libiconv\".
Copy "...\libiconv-1.14\libcharset\include\localcharset.h.build.in" to the project folder "...\libiconv\libiconv\" and then, rename the copied "localcharset.h.build.in" to "localcharset.h.
Copy "...\libiconv-1.14\windows\libiconv.rc" to the project folder "...\libiconv\libiconv\".

Make folder "include" under the project folder "...\libiconv\" so to make "...\libiconv\include".
Copy "...\libiconv-1.14\include\iconv.h.build.in" to the project include folder "...\libiconv\include" and then, rename the copied "iconv.h.build.in" to "iconv.h".
Copy "...\libiconv-1.14\config.h.in" to the project include folder "...\libiconv\include" and then, rename the copied "config.h.in" to "config.h".
And then, copy all the header files (*.h) and definition files (*.def) in the folder "...\libiconv-1.14\lib" to the project include folder "...\libiconv\include".

Fourth Step

Now, you have to add existing items to the project "libiconv" that we made at the second step. Execute "project > Add Existing items..." at the main menu to add existing items to the project.

Image 3

Fifth Step

You can make 64-bit platform through configuration manager in order to generate libiconv.dll for 64-bit system. You can also make two other configurations "ReleaseStatic" and "DebugStatic" in order to generate libiconvStatic.lib as a static link library.

At the project properties, change Output Directory as "$(SolutionDir)$(Configuration)_$(Platform)\" and Intermediate Directory as "$(SolutionDir)obj\$(ProjectName)\$(Configuration)_$(Platform)\".

Image 4

Change Include Directories as "..\include;$(IncludePath)":

Image 5

You have to add "BUILDING_LIBICONV" and "BUILDING_LIBCHARSET" to Peprocessor Definitions of all Platforms and of all configurations.

Image 6

You'd better set Runtime Library to "Multi-threaded" when building dynamic link library libiconv.dll. Then, the dependency on VC Runtime library can be controlled by the applications that will be built and dynamically linked with libiconv.dll because libiconv.dll does not need VC Runtime library but only the application that uses libiconv.dll may or may not need VC Runtime library. However, when building the static link library libiconvStatic.lib, you can choose Runtime Library option for libiconvStatic.lib depending on the application that uses libiconvStatic.lib.

Image 7

You have to change Precompiled Header option to "Not Using Precompiled Headers".

Image 8

Sixth Step

Now, it is the time to tweak the source code of the libiconv.

libiconv.rc

Open libiconv.rc with text editor or the source code editor of Visual Studio IDE by double-clicking libiconv.rc in the Solution explorer and insert some code at line 4 as follows:

C++
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
#define PACKAGE_VERSION_MAJOR       1
#define PACKAGE_VERSION_MINOR       14
#define PACKAGE_VERSION_SUBMINOR    0
#define PACKAGE_VERSION_STRING      "1.14"
////////////////////////////////////////////////////////////////////////////////

You may be asked to change Line endings to "Windows (CR LF)". Then, let it do so. It will be more convenient for you if you mainly use Windows.

localcharset.c

Open localcharset.c and delete or comment the lines 76 - 79 as follows:

C++
///////////////////////// 삭제 / DELETE / удалить ///////////////////////
///* Get LIBDIR.  */
//#ifndef LIBDIR
//# include "configmake.h"
//#endif
////////////////////////////////////////////////////////////////////////////////

iconv.c

Open iconv.c and delete or comment the lines 246 - 248 and add three lines there as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//size_t iconv (iconv_t icd,
//              ICONV_CONST char* * inbuf, size_t *inbytesleft,
//              char* * outbuf, size_t *outbytesleft)
///////////////////////// ?? / ADD / ????????? //////////////////////
size_t iconv (iconv_t icd,
              const char* * inbuf, size_t *inbytesleft,
              char* * outbuf, size_t *outbytesleft)
////////////////////////////////////////////////////////////////////////////////

localcharset.h

Open localcharset.h and delete or comment the lines 23 - 27 and add 7 lines there as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//#if @HAVE_VISIBILITY@ && BUILDING_LIBCHARSET
//#define LIBCHARSET_DLL_EXPORTED __attribute__((__visibility__("default")))
//#else
//#define LIBCHARSET_DLL_EXPORTED
//#endif
///////////////////////// ?? / ADD / ????????? //////////////////////
#ifdef BUILDING_LIBCHARSET
#define LIBCHARSET_DLL_EXPORTED __declspec(dllexport)
#elif USING_STATIC_LIBICONV
#define LIBCHARSET_DLL_EXPORTED
#else
#define LIBCHARSET_DLL_EXPORTED __declspec(dllimport)
#endif
////////////////////////////////////////////////////////////////////////////////

config.h

Open config.h in the project include folder "...\libiconv\include" and delete or comment the lines 29 - 30 as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
///* Define as good substitute value for EILSEQ. */
//#undef EILSEQ
////////////////////////////////////////////////////////////////////////////////

Otherwise you can redefine EILSEQ as good substitute value.

iconv.h

Open iconv.h in the project include folder "...\libiconv\include" and delete or comment the line 175 and add 1 line as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//#if @HAVE_WCHAR_T@
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
#if HAVE_WCHAR_T
////////////////////////////////////////////////////////////////////////////////

Delete or comment the line 128 and add 1 line as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//#if @USE_MBSTATE_T@
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
#if USE_MBSTATE_T
////////////////////////////////////////////////////////////////////////////////

Delete or comment the lines 107-108 and add 2 lines as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//#if @USE_MBSTATE_T@
//#if @BROKEN_WCHAR_H@
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
#if USE_MBSTATE_T
#if BROKEN_WCHAR_H
////////////////////////////////////////////////////////////////////////////////

Delete or comment the line 89 and add 2 lines as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//extern LIBICONV_DLL_EXPORTED size_t iconv (iconv_t cd, @ICONV_CONST@ char* * inbuf, 
//size_t *inbytesleft, char* * outbuf, size_t *outbytesleft);
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
extern LIBICONV_DLL_EXPORTED size_t iconv (iconv_t cd, const char* * inbuf, 
	size_t *inbytesleft, char* * outbuf, size_t *outbytesleft);
////////////////////////////////////////////////////////////////////////////////

Delete or comment the lines 26 - 31 and add 8 lines as follows:

C++
///////////////////////// 삭제 / DELETE / УДАЛИТЬ ///////////////////////
//#if @HAVE_VISIBILITY@ && BUILDING_LIBICONV
//#define LIBICONV_DLL_EXPORTED __attribute__((__visibility__("default")))
//#else
//#define LIBICONV_DLL_EXPORTED
//#endif
//extern LIBICONV_DLL_EXPORTED @DLL_VARIABLE@ int _libiconv_version; /* Likewise */
///////////////////////// 추가 / ADD / ДОВАВЛЯТЬ //////////////////////
#if BUILDING_LIBICONV
#define LIBICONV_DLL_EXPORTED __declspec(dllexport)
#elif USING_STATIC_LIBICONV
#define LIBICONV_DLL_EXPORTED
#else
#define LIBICONV_DLL_EXPORTED __declspec(dllimport)
#endif
extern LIBICONV_DLL_EXPORTED int _libiconv_version; /* Likewise */
////////////////////////////////////////////////////////////////////////////////

How to Use

When you use newly built libiconv, the only header file that you need is iconv.h. You will need to link either the import library libiconv.lib or the static library libiconvStatic.lib in your project property or write the code in one of your source file as follows:

C++
#pragma comment (lib, "libiconv.lib")
or
#pragma comment (lib, "libiconvStatic.lib")

In the source of the application that uses this library either libiconv.dll or libiconvStatic.lib, if you don't define anything but only include iconv.h, your application will use libiconv.dll while it will use libiconvStatic.lib if you define USING_STATIC_LIBICONV before you include iconv.h in your application as follows:

C++
//#define USING_STATIC_LIBICONV
#include <iconv.h>

Copyright Issues

The original libiconv is under LGPL licence. So, the tweaked libiconv has also to be under LGPL. If you develop any application that uses libiconv, you have to be careful about copyright issues. If your application is linked with libiconv.dll dynamically, you don't have to publicize your source code of your application. However, if your application is linked statically with libiconvStatic.lib, you have to publicize either the source code of the application or the object files (*.obj) of the application so that others can build the application that is linked statically with the library under LGPL license.

License

This article, along with any associated source code and files, is licensed under The GNU Lesser General Public License (LGPLv3)


Written By
Korea (Republic of) Korea (Republic of)
I like programming.
I am teaching at AUCA (American University of Central Asia) now.

Comments and Discussions

 
QuestionHow to build libiconv1.16 with Microsoft Visual studio 2019? Pin
Julie Liang5-Apr-20 0:08
Julie Liang5-Apr-20 0:08 
PraiseThanks Pin
Роман Кривошеенко29-Feb-20 18:08
Роман Кривошеенко29-Feb-20 18:08 
PraiseThx so much Pin
Member 1401706811-Oct-18 23:29
Member 1401706811-Oct-18 23:29 
QuestionVery nice article Pin
Member 133916295-Sep-17 2:30
Member 133916295-Sep-17 2:30 
GeneralSimply Briliant Pin
yasir_hussain_shah9-Mar-16 18:38
yasir_hussain_shah9-Mar-16 18:38 
GeneralMy vote of 5 Pin
kritzel_sw24-Nov-15 0:52
professionalkritzel_sw24-Nov-15 0:52 
QuestionGetting "failure during conversion to COFF: file invalid or corrupt" Pin
Member 115109799-Mar-15 9:39
Member 115109799-Mar-15 9:39 
QuestionRE: How to Build libiconv with Microsoft Visual Studio Pin
Member 1140340426-Jan-15 6:21
Member 1140340426-Jan-15 6:21 
SuggestionI have a solution ,it can work with MD Pin
RainbowSky5-Aug-14 23:13
RainbowSky5-Aug-14 23:13 
QuestionMulti-threaded Pin
Member 1020660014-Aug-13 1:10
Member 1020660014-Aug-13 1:10 
AnswerRe: Multi-threaded Pin
PARK Youngho16-Sep-13 7:49
PARK Youngho16-Sep-13 7:49 
GeneralRe: Multi-threaded Pin
RainbowSky5-Aug-14 18:19
RainbowSky5-Aug-14 18:19 
GeneralMy vote of 5 Pin
Gerald Schade12-May-13 1:21
Gerald Schade12-May-13 1:21 
QuestionThanks a lot! Pin
SlobodanG26-Apr-13 8:41
SlobodanG26-Apr-13 8:41 
QuestionError RC2135 in C++ project due to UTF-8 encoding of RC file Pin
coder11228-Mar-13 10:33
coder11228-Mar-13 10:33 
GeneralMy vote of 5 Pin
Gassantos2-Mar-13 4:04
Gassantos2-Mar-13 4:04 
QuestionWorks as a charm! Pin
yurkir21-Feb-13 20:19
yurkir21-Feb-13 20:19 
QuestionWhat about libcharset Pin
budricb5-Nov-12 5:22
budricb5-Nov-12 5:22 
Questionlibiconv in visual studio Pin
Pradeep Abeygunawardhana7-May-12 19:49
Pradeep Abeygunawardhana7-May-12 19:49 
AnswerRe: libiconv in visual studio Pin
PARK Youngho10-May-12 1:29
PARK Youngho10-May-12 1:29 
GeneralRe: libiconv in visual studio Pin
Pradeep Abeygunawardhana13-May-12 14:49
Pradeep Abeygunawardhana13-May-12 14:49 
GeneralRe: libiconv in visual studio Pin
Pradeep Abeygunawardhana17-May-12 19:09
Pradeep Abeygunawardhana17-May-12 19:09 
GeneralMy suggestion. Pin
PARK Youngho18-May-12 5:06
PARK Youngho18-May-12 5:06 
QuestionThanks Pin
Member 156288728-Mar-12 4:33
Member 156288728-Mar-12 4:33 
AnswerRe: Thanks and some doubts Pin
Gassantos2-Mar-13 4:25
Gassantos2-Mar-13 4:25 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.