---
name: "libiconv_iconv_open_into"
section: "3"
platform: "linux"
package: "libiconv"
version: "1.19-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/libiconv_iconv_open_into"
---

# libiconv\_iconv\_open\_into(3)

initialize descriptor for character set conversion

## NAME

iconv\_open\_into - initialize descriptor for character set conversion

## SYNOPSIS

```
#include <iconv.h>

int iconv_open_into (const char* tocode, const char* fromcode,
                     iconv_allocation_t* resultp);
```

## DESCRIPTION

The **iconv\_open\_into** function initializes a conversion descriptor suitable for converting byte sequences from character encoding *fromcode* to character encoding *tocode*.  The conversion descriptor is stored in the memory pointed to by *resultp*.

The values permitted for *fromcode* and *tocode* are the same as for the function **iconv\_open**.

After a successful return from this function, *resultp* can be be used as an **iconv\_t** object with the **iconv** function.

## RETURN VALUE

The **iconv\_open\_into** function fills **\****resultp* and returns 0 if it succeeds. In case of error, it sets **errno** and returns -1.

## ERRORS

The following error can occur, among others:

- **EINVAL**

  The conversion from *fromcode* to *tocode* is not supported by the implementation.

## CONFORMING TO

This function is implemented only in GNU libiconv and not in other **iconv** implementations. It is not backed by a standard. You can test for its presence through **(\_LIBICONV\_VERSION \>= 0x010D)**.

## SEE ALSO

[**iconv\_open**(3)](/iconv_open/3.md) [**iconv**(3)](/iconv/3.md)