ISOQUERY(1)															       ISOQUERY(1)

NAME

       isoquery - Search and display various ISO codes (country, language, ...)

SYNOPSIS

       isoquery [options] [file] [ISO codes]

DESCRIPTION

       This manual page documents briefly the isoquery command.  It can be used to generate a tabular output of the ISO standard codes provided by
       the package iso-codes.  It parses the XML files and shows all included ISO codes or just matching entries,  if  specified  on  the  command
       line.  Moreover, it's possible to get all available translations for the ISO standard.

OPTIONS

       This  program  follows the usual GNU command line syntax, with long options starting with two dashes ('-'). isoquery supports the following
       options:

       -i standard, --iso=standard
	      The ISO standard to use. Possible values: 639, 639-3, 3166, 3166-2, 4217, 15924 (default: 3166).

       -x file, --xmlfile=file
	      Use another XML file with ISO data (default: /usr/share/xml/iso-codes/iso_3166.xml).

       -l locale, --locale=locale
	      Use this locale for output.

       -n, --name
	      Name for the supplied codes (default).

       -o, --official_name
	      Official name for the supplied codes. This may be the same as --name (only applies to ISO 3166).

       -c, --common_name
	      Common name for the supplied codes. This may be the same as --name (only applies to ISO 3166).

       -0, --null
	      Separate entries with a NULL character instead of newline.

       -h, --help
	      Show summary of options.

       -v, --version
	      Show program version and copyright.

EXAMPLES

       If called without any command line options, isoquery will put out a table of all ISO 3166  codes.  The  first  three  columns  contain  the
       alpha-2 code, the alpha-3 code, and the numerical code assigned to the country listed in the fourth column.

       $ isoquery
       AF      AFG     004     Afghanistan
       [...]
       ZW      ZWE     716     Zimbabwe

       If you need only some countries, you can specify any of the codes in the first three columns to cut down the output.

       $ isoquery so nor 484
       SO      SOM     706     Somalia
       NO      NOR     578     Norway
       MX      MEX     484     Mexico

       Should  you need the translations of the countries' names, just specify in which locale you'd like to see the output.  Please note that the
       original English name will be shown if there is no translation available for the specified locale.

       $ isoquery --locale=nl fr de es
       FR      FRA     250     Frankrijk
       DE      DEU     276     Duitsland
       ES      ESP     724     Spanje

       All of the above works for different ISO standards as well, so you can switch to the more extensive standard ISO 3166-2 by using the  --iso
       command	line option. The columns are country code, subset type (e.g. State, Province, etc.), ISO 3166-2 code, parent, and name. The fourth
       column (parent) may be empty.

       $ isoquery --iso=3166-2
       AD      Parish	       AD-07	       Andorra la Vella
       [...]
       ZW      Province        ZW-MI	       Midlands

       For ISO 639, the first three columns are the ISO 639 2B code, the ISO 639 2T code and the ISO 639-1 code. The third column may be empty.

       $ isoquery --iso=639
       aar     aar     aa      Afar
       abk     abk     ab      Abkhazian
       ace     ace	       Achinese
       [...]
       zun     zun	       Zuni
       zxx     zxx	       No linguistic content; Not applicable
       zza     zza	       Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki

       You can trim down the results by specifying only some codes. Moreover, the option to get translated names is also available.

       $ isoquery --iso=639 --locale=pt vi bo kl
       vie     vie     vi      Vietnamita
       tib     bod     bo      tibetano
       kal     kal     kl      Kalaallisut; Greenlandic

       If you want to use ISO 639-3, the displayed columns are id, scope, type, part 1 code, part 2 code, and the language name. Both part  1  and
       part 2 may be empty.

       $ isoquery -i 639-3 aal new spa guc
       aal     I       L		       Afade
       new     I       L	       new     Bhasa, Nepal
       spa     I       L       es      spa     Spanish
       guc     I       L		       Wayuu

       You  can  get  selected translations of currency names from the ISO 4217 standard by using the following command. The first two columns are
       the alpha-3 code and the numerical code assigned to the currency.

       $ isoquery --iso=4217 --locale=da cad 392
       CAD     124     Canadisk dollar
       JPY     392     Yen

       If you need to get script names, you can use the ISO 15924 table.  The first two columns are  the  alpha-4  code  and  the  numerical  code
       assigned to the script.

       $ isoquery --iso=15924 jpan latn 280
       Jpan    413     Japanese (alias for Han + Hiragana + Katakana)
       Latn    215     Latin
       Visp    280     Visible Speech

FILES

       By default, the XML files provided by the iso-codes package will be used.
       /usr/share/xml/iso-codes/iso_639.xml
       /usr/share/xml/iso-codes/iso_639_3.xml
       /usr/share/xml/iso-codes/iso_3166.xml
       /usr/share/xml/iso-codes/iso_3166_2.xml
       /usr/share/xml/iso-codes/iso_4217.xml
       /usr/share/xml/iso-codes/iso_15924.xml

AUTHOR

       Tobias Quathamer <toddy@debian.org>

1.7								    2012-01-23							       ISOQUERY(1)