---
name: "mconv_gets"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mconv_gets"
---

# mconv\_gets(3m17n)

## NAME

mconv\_gets -

## SYNOPSIS

**MText**\* **mconv\_gets** (**MConverter** \* *converter*, **MText** \* *mt*)

## DESCRIPTION

Read a line using a code converter. The **mconv\_gets()** function reads one line from the buffer area or the stream that is currently bound to code converter **converter**. The decoder of **converter** is used for decoding. The decoded character sequence is appended at the end of M-text **mt**. The final newline character in the original byte sequence is not appended. The internal status of **converter** is updated appropriately.

## RETURN VALUE

If the operation was successful, **mconv\_gets()** returns the modified **mt**. If it encounters EOF without reading a single character, it returns **mt** without changing it. If an error is detected, it returns `NULL` and assigns an error code to **merror\_code**. \

## ERRORS

`MERROR_CODING`

## SEE ALSO

**mconv\_getc()**, **mconv\_ungetc()**, **mconv\_putc()**\

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.