iconv_open man page on Tru64

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
Tru64 logo
[printable version]

iconv_open(3)							 iconv_open(3)

NAME
       iconv_open - Open a character codeset converter

SYNOPSIS
       #include <iconv.h>

       iconv_t iconv_open(
	       const char *tocode,
	       const char *fromcode );

LIBRARY
       The iconv library (libiconv)

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       iconv_open(): XSH5.0

       Refer to the standards(5) reference page	 for  more  information	 about
       industry standards and associated tags.

PARAMETERS
       Specifies the destination codeset.  Specifies the originating codeset.

DESCRIPTION
       The  iconv_open()  function  initializes a codeset converter. This con‐
       verter is used by the iconv function to	convert	 characters  from  one
       codeset	to another. The iconv_open() function finds the converter that
       performs the character conversion specified by the fromcode and	tocode
       parameters,  initializes	 that  converter,  then	 returns  a conversion
       descriptor of type iconv_t that identifies the converter.

       The conversion descriptor returned by this function remains valid until
       the  descriptor	is  closed for the process in which the application is
       run.  The descriptor can be closed by an iconv_close()  call  in	 which
       the  descriptor	is an argument or by a call to one of the exec() func‐
       tions.

       Note that standards do not define where codeset	converters  reside  or
       how vendors implement them.

       [Tru64 UNIX]  The iconv_open() codesets, the function then searches for
       a table converter. The algorithmic and table converter file  names  are
       formed  by  concatenating  the  tocode  parameter codeset name onto the
       fromcode parameter codeset name, with an underscore  between  the  two,
       for example:

       fromcode=ct tocode=ISO8859-1 Converter name=ct_ISO8859-1

       [Tru64  UNIX]  The  iconv_open()	 function  searches for an algorithmic
       converter in an iconv subdirectory of the directory  specified  in  the
       LOCPATH	environment  variable.	The function searches for a table con‐
       verter in an iconvTable subdirectory of the directory specified in  the
       LOCPATH	environment  variable. If LOCPATH is not defined, iconv_open()
       uses the default value: /usr/lib/nls/loc.

					Note

       [Tru64 UNIX]  The LOCPATH variable also overrides  the  default	search
       path  (/usr/lib/nls/loc) that is used to find locales. If this variable
       is defined, it must therefore specify a search  path  that  application
       and  system  software  can use to find both locales and converters. The
       LOCPATH variable is not defined by any standard, so use of the variable
       should be limited to testing locales or converters under development.

RETURN VALUES
       On  successful  completion, the iconv_open() function returns a conver‐
       sion descriptor. Otherwise, the function returns -1 cast to iconv_t and
       sets errno to indicate the error.

ERRORS
       If  any	of  the	 following conditions occur, the iconv_open() function
       sets errno to the corresponding value: The number of  file  descriptors
       specified  by  the OPEN_MAX configuration variable is currently open in
       the calling process.

	      [Tru64 UNIX]  Either the OPEN_MAX value or the per-process  soft
	      descriptor  limit	 is  checked.	[Tru64 UNIX]  The path used to
	      find the codeset converter is longer than	 PATH_MAX.   Too  many
	      files  are  currently  open in the system.  Insufficient virtual
	      memory is available.  The conversion specified by	 the  fromcode
	      and tocode parameters is not supported.

	      [Tru64 UNIX]  This condition may also indicate an incorrect LOC‐
	      PATH setting because support for	the  specified	conversion  is
	      determined by finding a converter whose name also specifies that
	      conversion.

SEE ALSO
       Commands: genxlt(1), iconv(1)

       Functions: iconv(3), iconv_close(3)

       Others: iconv_intro(5), standards(5)

								 iconv_open(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net