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 *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 null-terminated data to be linted. Must not be NULL.
[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 (strcmp(data, "999") == 0)
                GS1_LINTER_RETURN_OK;
 
        /*
         * Validate the data with the iso3166 linter.
         *
         */
        ret = gs1_lint_iso3166(data, err_pos, err_len);
 
        assert(ret == GS1_LINTER_OK || ret == GS1_LINTER_NOT_ISO3166);
 
        GS1_LINTER_RETURN_ERROR(
                ret == GS1_LINTER_NOT_ISO3166 ? GS1_LINTER_NOT_ISO3166_OR_999 : ret,
                *err_pos,
                *err_len
        );
 
}