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

# minput\_list(3m17n)

## NAME

minput\_list -

## SYNOPSIS

**MPlist**\* **minput\_list** (MSymbol *language*)

## DESCRIPTION

```
@brief List available input methods.
The minput_list() function returns a list of currently available
input methods whose language is @b language.  If @b language is #Mnil,
all input methods are listed.
@par Return value:
The returned value is a plist of this form:
((LANGUAGE-NAME INPUT-METHOD-NAME SANE) ...)
The third element SANE of each input method is #Mt if it can be
successfully used, or #Mnil if it has some problem (e.g. syntax
error of MIM file, unavailable external module, unavailable
including input method).
```

## Example:

```
#include <stdio.h>
#include <string.h>
#include <m17n.h>
int
main (int argc, char **argv)
{
  MPlist *imlist, *pl;
  M17N_INIT();
  imlist = minput_list ((argc > 1) ? msymbol (argv[1]) : Mnil);
  for (pl = imlist; mplist_key (pl) != Mnil; pl = mplist_next (pl))
    {
      MPlist *p = mplist_value (pl);
      MSymbol lang, name, sane;
      lang = mplist_value (p);
      p = mplist_next (p);
      name = mplist_value (p);
      p = mplist_next (p);
      sane = mplist_value (p);
      printf ("%s %s %s0, msymbol_name (lang), msymbol_name (name),
          sane == Mt ? "ok" : "no");
    }
  m17n_object_unref (imlist);
  M17N_FINI();
  exit (0);
}
```

## 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\>.