epoc32/include/stdapis/iconv.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h) This is the epoc32/include tree with the "platform" subtrees removed, and all but a selected few mbg and rsg files removed.

/*
* Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:
* Name        : iconv.h
* Part of     : LIBC
* Contains the source for character set conversion
* Version     : 
* This material, including documentation and any related 
* computer programs, is protected by copyright controlled by 
* Nokia Corporation. All rights are reserved. Copying, 
* including reproducing, storing, adapting or translating, any 
* or all of this material requires the prior written consent of 
* Nokia Corporation. This material also contains confidential 
* information which may not be disclosed to others without the 
* prior written consent of Nokia Corporation.
*
*/


 
#ifndef _ICONV_H
#define _ICONV_H

#include <stddef.h>
#include <sys/cdefs.h>

#ifdef __SYMBIAN32__
#include <_ansi.h>
#endif

__BEGIN_DECLS
typedef void *iconv_t;


/* Allocate memory for codeset conversion descriptor */
IMPORT_C iconv_t iconv_open(const char *tocharset, const char *fromcharset);


/* Converts characters in the input buffer from source character set to destination charcater set and stores the converted charcaters in output buffer */
IMPORT_C size_t iconv(iconv_t conversion_descriptor, const char **inbuf, size_t *inbytesleft,
    char **outbuf, size_t *outbytesleft);

/* Deallocates the memory allocated for codeset converison descriptor */
IMPORT_C int iconv_close(iconv_t conversion_descriptor);

__END_DECLS
#endif