Crate iso3166_static 

Static ISO 3166 Data

ISO 3166 Static Data

This crate provides generated enumerations for use as with ISO 3166-1 codes. This crate is both no-std and no-alloc (with no need/desire to enable them), and supports serde via the "serde" feature.

There are three primary objects in this crate:

• Numeric - Numeric country codes.
• Alpha2 - Two-character country codes.
• Alpha3 - Three-character country codes.

Features

By default, this crate compiles with serde enabled, and alloc disabled. If your compilation enables the alloc feature on the serde crate, you should enable it here as well to prevent deserialization failures.

• default: Enables the serde feature by default.
• alloc: Enables the use of the alloc crate.
• serde: Enables implementations of the serde::Deserialize and serde::Serialize traits.

Examples

use iso3166_static::{Alpha2, Alpha3, Numeric};

const USA_ALPHA2: &str = "US";

let alpha2 = Alpha2::try_from(USA_ALPHA2).expect("alpha2");
let alpha3 = Alpha3::try_from(alpha2.clone()).expect("alpha3");
let numeric = Numeric::try_from(alpha3.clone()).expect("numeric");

assert_eq!(USA_ALPHA2, alpha2.as_str());
assert_eq!(alpha2, alpha3);
assert_eq!(alpha2, numeric);
assert_eq!(alpha3, numeric);

use core::str::FromStr;
use iso3166_static::{Alpha2, Alpha3, Numeric};

let USA_ALPHA3: &str = "USA";

let numeric = Numeric::UnitedStatesOfAmerica;
let alpha3 = Alpha3::try_from(numeric.clone()).expect("alpha3");
let alpha2 = Alpha2::try_from(numeric.clone()).expect("alpha2");

assert_eq!(alpha3.as_str(), USA_ALPHA3);
assert_eq!(numeric, alpha3);
assert_eq!(numeric, alpha2);
assert_eq!(alpha3, alpha2);

Enums

Alpha2

ISO 3166-1 Alpha-2 Country Codes.

Alpha3

ISO 3166-1 Alpha-3 Country Codes.

Error

An enumeration of errors related to ISO 3166 codes.

Numeric

ISO 3166-1 Numeric Country Codes.