# `Language`

A language (ISO 639-1), written as its code, `en`; `form: CodeForm.alpha3` writes ISO 639-2's `eng`. `Language.or_` is Odia.

[Places](types.md#places); not ordered; since Jadpo 0.1.0.

## Make one

Pick one of its variants, `Language.aa`.

`text.parse(raw, as: Language)` reads one from its text; text that isn't one at all fails `malformed`, such as `eng`, `en-GB` or `english`.

## Variants

188 variants, each with the code its text is written in. `aa` (`aa`), `ab` (`ab`), `ae` (`ae`), `af` (`af`), `ak` (`ak`), `am` (`am`), `an` (`an`), `ar` (`ar`), `as` (`as`), `av` (`av`), `ay` (`ay`), `az` (`az`), `ba` (`ba`), `be` (`be`), `bg` (`bg`), `bi` (`bi`), `bm` (`bm`), `bn` (`bn`), `bo` (`bo`), `br` (`br`), `bs` (`bs`), `ca` (`ca`), `ce` (`ce`), `ch` (`ch`), `co` (`co`), `cr` (`cr`), `cs` (`cs`), `cu` (`cu`), `cv` (`cv`), `cy` (`cy`), `da` (`da`), `de` (`de`), `dv` (`dv`), `dz` (`dz`), `ee` (`ee`), `el` (`el`), `en` (`en`), `eo` (`eo`), `es` (`es`), `et` (`et`), `eu` (`eu`), `fa` (`fa`), `ff` (`ff`), `fi` (`fi`), `fj` (`fj`), `fo` (`fo`), `fr` (`fr`), `fy` (`fy`), `ga` (`ga`), `gd` (`gd`), `gl` (`gl`), `gn` (`gn`), `gu` (`gu`), `gv` (`gv`), `ha` (`ha`), `he` (`he`), `hi` (`hi`), `ho` (`ho`), `hr` (`hr`), `ht` (`ht`), `hu` (`hu`), `hy` (`hy`), `hz` (`hz`), `ia` (`ia`), `id` (`id`), `ie` (`ie`), `ig` (`ig`), `ii` (`ii`), `ik` (`ik`), `in_` (`in`), `io` (`io`), `is` (`is`), `it` (`it`), `iu` (`iu`), `iw` (`iw`), `ja` (`ja`), `ji` (`ji`), `jv` (`jv`), `jw` (`jw`), `ka` (`ka`), `kg` (`kg`), `ki` (`ki`), `kj` (`kj`), `kk` (`kk`), `kl` (`kl`), `km` (`km`), `kn` (`kn`), `ko` (`ko`), `kr` (`kr`), `ks` (`ks`), `ku` (`ku`), `kv` (`kv`), `kw` (`kw`), `ky` (`ky`), `la` (`la`), `lb` (`lb`), `lg` (`lg`), `li` (`li`), `ln` (`ln`), `lo` (`lo`), `lt` (`lt`), `lu` (`lu`), `lv` (`lv`), `mg` (`mg`), `mh` (`mh`), `mi` (`mi`), `mk` (`mk`), `ml` (`ml`), `mn` (`mn`), `mo` (`mo`), `mr` (`mr`), `ms` (`ms`), `mt` (`mt`), `my` (`my`), `na` (`na`), `nb` (`nb`), `nd` (`nd`), `ne` (`ne`), `ng` (`ng`), `nl` (`nl`), `nn` (`nn`), `no` (`no`), `nr` (`nr`), `nv` (`nv`), `ny` (`ny`), `oc` (`oc`), `oj` (`oj`), `om` (`om`), `or_` (`or`), `os` (`os`), `pa` (`pa`), `pi` (`pi`), `pl` (`pl`), `ps` (`ps`), `pt` (`pt`), `qu` (`qu`), `rm` (`rm`), `rn` (`rn`), `ro` (`ro`), `ru` (`ru`), `rw` (`rw`), `sa` (`sa`), `sc` (`sc`), `sd` (`sd`), `se` (`se`), `sg` (`sg`), `si` (`si`), `sk` (`sk`), `sl` (`sl`), `sm` (`sm`), `sn` (`sn`), `so` (`so`), `sq` (`sq`), `sr` (`sr`), `ss` (`ss`), `st` (`st`), `su` (`su`), `sv` (`sv`), `sw` (`sw`), `ta` (`ta`), `te` (`te`), `tg` (`tg`), `th` (`th`), `ti` (`ti`), `tk` (`tk`), `tl` (`tl`), `tn` (`tn`), `to` (`to`), `tr` (`tr`), `ts` (`ts`), `tt` (`tt`), `tw` (`tw`), `ty` (`ty`), `ug` (`ug`), `uk` (`uk`), `ur` (`ur`), `uz` (`uz`), `ve` (`ve`), `vi` (`vi`), `vo` (`vo`), `wa` (`wa`), `wo` (`wo`), `xh` (`xh`), `yi` (`yi`), `yo` (`yo`), `za` (`za`), `zh` (`zh`), `zu` (`zu`).

## Text, JSON and storage

`text.from` writes its canonical text, the one form `text.parse` reads back. JSON sends its canonical text as a string.

| Text | JSON |
|---|---|
| `en` | `"en"` |
| `iw` | `"iw"` |
| `ja` | `"ja"` |
| `or` | `"or"` |

It is stored in one column named for the field, of type `text`. `ja` is stored as `'ja'`.

## Shown to people

`text.format(value, locale:)` shows it to people in their locale.

With `locale: Locale.en_gb`:

| Value | Shown |
|---|---|
| `en` | `English` |
| `iw` | `Hebrew` |
| `ja` | `Japanese` |
| `or` | `Odia` |

## Operations

It has the contract's own operations: `text.parse`, `text.from`, `text.format`, `json.read`, `json.write` and `==`. It isn't ordered, so `<` and sorting don't take it. [Every standard type meets one contract](../topics/every-standard-type-meets-one-contract.md) says how they work.