fifa - the world's football countries and codes (incl. non-member countries and irregular codes)
- home :: github.com/sportdb/football.db
- bugs :: github.com/sportdb/football.db/issues
- gem :: rubygems.org/gems/fifa
- rdoc :: rubydoc.info/gems/fifa
- forum :: opensport
Get and pretty print (pp) all countries
require 'fifa' pp Fifa.countries
[#<Country @code="AFG", @key="af", @name="Afghanistan">, #<Country @code="ALB", @key="al", @name="Albania">, #<Country @code="ALG", @key="dz", @name="Algeria">, #<Country @code="ASA", @key="as", @name="American Samoa">, #<Country @code="AND", @key="ad", @name="Andorra">, #<Country @code="ANG", @key="ao", @name="Angola">, #<Country @code="AIA", @key="ai", @name="Anguilla">, #<Country @code="ATG", @key="ag", @name="Antigua and Barbuda">, #<Country @code="ARG", @key="ar", @name="Argentina">, #<Country @code="ARM", @key="am", @name="Armenia">, #<Country @code="ARU", @key="aw", @name="Aruba">, #<Country @code="AUS", @key="au", @name="Australia">, #<Country @code="AUT", @key="at", @name="Austria">, #<Country @code="AZE", @key="az", @name="Azerbaijan">, ... ]
Note: If you prefer you can use the all-upcase
FIFA name as an alias for
Let's lookup some countries by the fifa (three-letter) code:
eng = Fifa['ENG'] # -or- eng = Fifa['eng'] eng = Fifa[:eng] eng.key #=> "eng" eng.name #=> "England" eng.code #=> "ENG" aut = Fifa['AUT'] # -or- aut = Fifa['aut'] aut = Fifa[:aut] aut.key #=> "at" aut.name #=> "Austria" aut.code #=> "AUT" ...
Or get all countries / members by continental confederation:
- Asian Football Confederation (AFC; 47 members) (a)
- Confederation of African Football (CAF; 56 members)
- Confederation of North, Central American and Caribbean Association Football (CONCACAF; 41 members) (b)
- Confederación Sudamericana de Fútbol (CONMEBOL; 10 members)
- Oceania Football Confederation (OFC; 14 members) (a)
- Union of European Football Associations (UEFA; 55 members) (c)
(a) Australia has been a member of the AFC since 2006.
(b) French Guiana, Guyana and Suriname are CONCACAF members although they are in South America. The French Guiana team is a member of CONCACAF but not of FIFA.
(c) Teams representing the nations of Armenia, Azerbaijan, Cyprus, Georgia, Israel, Kazakhstan, Russia and Turkey are UEFA members, although the majority or entirety of their territory is outside of continental Europe. Monaco is not member of UEFA or FIFA.
Fifa.members( 'FIFA' ).size #=> 211 members -or- Fifa.members( 'World' ).size #=> 211 members Fifa.members( 'AFC' ).size #=> 47 members -or- Fifa.members( 'Asia' ).size #=> 47 members Fifa.members( 'CAF').size #=> 56 members -or- Fifa.members( 'Africa' ).size #=> 56 members Fifa.members( 'CONCACAF').size #=> 41 members -or- Fifa.members( 'North, Central America and Caribbean').size #=> 41 members Fifa.members( 'CONMEBOL' ).size #=> 10 members -or- Fifa.members( 'South America' ).size #=> 10 members Fifa.members( 'OFC' ).size #=> 14 members -or- Fifa.members( 'Oceania' ).size #=> 14 members Fifa.members( 'UEFA' ).size #=> 55 members -or- Fifa.members( 'Europe' ).size #=> 55 members ...
The World's Football Association / Governing Body
uses its own country list and (three-letter²) codes - see
the List of FIFA country codes @ Wikipedia
countries.txt list shipping with this library.
Trivia - The FIFA member list includes 211 countries (in 2019) while the United Nations (UN) member list only includes 193 countries. For example, for historic reasons the FIFA includes:
- England › UK (ENG)
- Wales › UK (WAL)
- Scotland › UK (SCO)
- Northern Ireland › UK (NIR)
but doesn't include the United Kingdom (UK) itself. Or the FIFA includes (non-sovereign) dependent territories or autonomous regions that have their own national team or leagues, for example:
- Gibraltar › UK (GIB)
- Faroe Islands › DK (FRO)
- Hong Kong › CN (HKG)
- Bermuda › UK (BER)
- Puerto Rico › US (PUR)
- and others
Note: This library includes non-FIFA member codes and irregular codes from countries in use by regional confederations too, for example:
- Vatican City (VAT)
- Monaco (MCO)
- Micronesia (FSM)
- Palau (PLW)
- Réunion › FR (REU)
- Zanzibar › TZ (ZAN)
- Saint Martin › FR (SMN)
- Sint Maarten › NL (SMA)
- and others
¹: Fédération Internationale de Football Association (FIFA) @ Wikipedia
²: Northern Cyprus (TRNC) has a four-letter FIFA country code
fifa scripts are dedicated to the public domain.
Use it as you please with no restrictions whatsoever.
Send them along to the Open Sports & Friends Forum/Mailing List. Thanks!