lint_iso3166999.c File Reference

Purpose

The iso3166999 linter ensures that the data represents an ISO 3166 "num-3" country code, or the value "999".

Remarks

The three-digit country codes are defined by ISO 3166-1:2020: Codes for the representation of names of countries and their subdivisions - Part 1: Country code as the "num-3" codes.

Functional Description

gs1_lint_iso3166999()

GS1_SYNTAX_DICTIONARY_API gs1_lint_err_t gs1_lint_iso3166999	(	const char *const	data,
		size_t	data_len,
		size_t *const	err_pos,
		size_t *const	err_len
	)

Used to validate that an AI component is an ISO 3166 "num-3" country code or the string "999".

Parameters

[in]	data	Pointer to the data to be linted. Must not be NULL.
[in]	data_len	Length of the data to be linted.
[out]	err_pos	To facilitate error highlighting, the start position of the bad data is written to this pointer, if not NULL.
[out]	err_len	The length of the bad data is written to this pointer, if not NULL.

Returns

GS1_LINTER_OK if okay.

GS1_LINTER_NOT_ISO3166_OR_999 if the data is not a num-3 country code or the string "999".

{
 
        gs1_lint_err_t ret;
 
        assert(data);
 
        /*
         * The data may contain the string "999".
         *
         */
        if (data_len == 3 && data[0] == '9' && data[1] == '9' && data[2] == '9')
                GS1_LINTER_RETURN_OK;
 
        /*
         * Validate the data with the iso3166 linter.
         *
         */
        ret = gs1_lint_iso3166(data, data_len, err_pos, err_len);
 
        assert(ret == GS1_LINTER_OK || ret == GS1_LINTER_NOT_ISO3166);
 
        if (GS1_LINTER_LIKELY(ret == GS1_LINTER_OK))
                GS1_LINTER_RETURN_OK;
 
        GS1_LINTER_RETURN_ERROR(
                GS1_LINTER_NOT_ISO3166_OR_999,
                *err_pos,
                *err_len
        );
 
}