Skip to content

README.md

Latest commit

 

History

History
95 lines (81 loc) · 5.65 KB

README.md

File metadata and controls

95 lines (81 loc) · 5.65 KB
Raw

CountryCodes

NuGet

All countries and subdivisions based on ISO 3166

Usage

List all countries and subdivisions

foreach (var country in Country.GetAllCountries())
{
    Console.WriteLine(country); // Two-letter code (e.g. "US")
    Console.WriteLine(country.Name);
    Console.WriteLine(country.TwoLetterCode); 
    Console.WriteLine(country.ThreeLetterCode);
    Console.WriteLine(country.NumericCode);

    foreach (var subdivision in country.Subdivisions)
    {
        Console.WriteLine(subdivision); // Subdivision code (e.g. "US-AL" for Alabama)
        Console.WriteLine(subdivision.Name);
        Console.WriteLine(subdivision.Code);
    }
}

Static fields

_ = Country.US.Name;                 // "United States"
_ = Country.US.TwoLetterCode;        // "US"
_ = Country.US.ThreeLetterCode;      // "USA"
_ = Country.US.NumericCode;          // 840

foreach (var item in Country.US.Subdivisions)
{
    _ = item.Code;                   // Code for state (e.g. "US-AL")
    _ = item.Name;                   // State name (e.g. "Alabama")
}

Using the constructors

_ = new Country("US") == Country.US;        // true
_ = new Country(840) == Country.US;         // true
_ = new Country("US") == new Country(840);  // true
_ = new Country("XX")                       // ArgumentException
var alabama = new Subdivision("US-AL");
Console.WriteLine(alabama.Name); // "Alabama"
Console.WriteLine(alabama.Code); // "US-AL"

Benchmarks

BenchmarkDotNet v0.13.12, Windows 11 (10.0.22631.3593/23H2/2023Update/SunValley3)
13th Gen Intel Core i7-13700, 1 CPU, 24 logical and 16 physical cores
.NET SDK 8.0.300
[Host] : .NET 8.0.5 (8.0.524.21615), X64 RyuJIT AVX2
DefaultJob : .NET 8.0.5 (8.0.524.21615), X64 RyuJIT AVX2

Method N Mean Error StdDev Median Allocated
CountryById 1000 2,389.8790 ns 10.4699 ns 8.7428 ns 2,387.9715 ns -
CountryByCode 1000 81,024.7900 ns 271.3211 ns 253.7939 ns 81,044.9463 ns -
CountryStaticFieldAccess 1000 208.0466 ns 0.8205 ns 0.7675 ns 207.8247 ns -
CountryEqualsTrue 1000 0.0005 ns 0.0010 ns 0.0010 ns 0.0000 ns -
CountryEqualsTrueNew 1000 182.6032 ns 0.7119 ns 0.6659 ns 182.7221 ns -
CountryEqualsFalse 1000 0.0065 ns 0.0050 ns 0.0046 ns 0.0054 ns -
CountryEqualsFalseNew 1000 605.2488 ns 8.3654 ns 7.4157 ns 605.9461 ns -
CountryById 10000 24,135.4159 ns 134.2165 ns 125.5462 ns 24,102.3529 ns -
CountryByCode 10000 804,314.0560 ns 4,967.4101 ns 4,646.5185 ns 805,193.8477 ns -
CountryStaticFieldAccess 10000 2,003.0091 ns 12.9029 ns 12.0694 ns 2,003.7109 ns -
CountryEqualsTrue 10000 0.0003 ns 0.0008 ns 0.0008 ns 0.0000 ns -
CountryEqualsTrueNew 10000 183.0074 ns 0.8514 ns 0.7964 ns 183.1840 ns -
CountryEqualsFalse 10000 0.0018 ns 0.0029 ns 0.0026 ns 0.0005 ns -
CountryEqualsFalseNew 10000 615.3867 ns 10.8206 ns 10.1216 ns 613.0751 ns -
CountryById 100000 239,643.2487 ns 1,062.3031 ns 993.6790 ns 239,393.2373 ns -
CountryByCode 100000 8,032,422.8125 ns 49,702.5701 ns 46,491.8149 ns 8,029,992.1875 ns 6 B
CountryStaticFieldAccess 100000 19,872.5524 ns 72.8110 ns 68.1075 ns 19,859.8618 ns -
CountryEqualsTrue 100000 0.0031 ns 0.0042 ns 0.0040 ns 0.0020 ns -
CountryEqualsTrueNew 100000 183.3448 ns 0.7262 ns 0.6792 ns 183.3051 ns -
CountryEqualsFalse 100000 0.0026 ns 0.0034 ns 0.0032 ns 0.0002 ns -
CountryEqualsFalseNew 100000 610.9723 ns 11.9035 ns 14.1703 ns 610.2311 ns -
CountryById 1000000 2,380,388.9323 ns 6,039.4146 ns 5,649.2722 ns 2,380,687.5000 ns 2 B
CountryByCode 1000000 84,550,160.0000 ns 391,468.2112 ns 366,179.6077 ns 84,580,233.3333 ns 67 B
CountryStaticFieldAccess 1000000 199,805.0163 ns 491.5580 ns 459.8036 ns 199,977.6611 ns -
CountryEqualsTrue 1000000 0.0040 ns 0.0051 ns 0.0048 ns 0.0020 ns -
CountryEqualsTrueNew 1000000 183.2498 ns 1.1114 ns 1.0396 ns 183.0645 ns -
CountryEqualsFalse 1000000 0.0044 ns 0.0050 ns 0.0047 ns 0.0026 ns -
CountryEqualsFalseNew 1000000 622.5405 ns 11.0644 ns 10.3496 ns 623.3470 ns -