Country list atom ('ctry')
An atom that lists items that are suitable for more than one country.
Overview
When one or more items must be identified as being suitable for more than one country, each list of countries is stored in this otherwise optional atom. The country list atom is a full atom with an atom type of ‘ctry’.
Each list starts with a two-byte count of the number of items in the list, and then each ISO 3166 code representing countries in the list.
The atom consists of a count of the number of lists, expressed as a 32-bit integer, and then these lists, appended end-to-end.
Note that:
Indexes into the country list atom are 1-based.
Zero (0) is reserved and never used as an index.
Currently, there is a limit of 255 countries that may be recorded in a country list atom.
An example country list atom consisting of two country lists with two and three countries, respectively, is shown in the following table.
Field size | Field | Field contents | Comment |
|---|---|---|---|
32-bit | atom_size | 26 | Size of this country list atom in bytes. |
32-bit | atom_type |
| |
32-bit | entry_count | 2 | Number of country lists. |
16-bit | country_count | 2 | Number of countries in country list 1. |
16-bit | country | ‘US’ | |
16-bit | country | ‘UK’ | |
16-bit | country_count | 3 | Number of countries in country list 2. |
16-bit | country | ‘JP’ | |
16-bit | country | ‘US’ | |
16-bit | country | ‘FR’ |