lint_iso3166list.c File Reference

Purpose

The iso3166list linter ensures that the data is a concatenated sequence of ISO 3166 "num-3" country codes.

Remarks

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

Functional Description

gs1_lint_iso3166list()

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

Used to validate that an AI component is a concatenated sequence of ISO 3166 "num-3" country codes.

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 if the data contains a part of the sequence that is not a num-3 country code, or the data is empty.

{
 
        const char *p, *q;
        char c3[4] = {0};
        gs1_lint_err_t ret;
 
        assert(data);
 
        p = data;
        q = p + strlen(data);
 
        /*
         *  Process each group of three characters to check if it is a valid
         *  ISO 3166 num-3 country code.
         *
         */
        while (p <= q - 3) {
 
                strncpy(c3, p, 3);
 
                ret = gs1_lint_iso3166(c3, err_pos, err_len);
                assert(ret == GS1_LINTER_OK || ret == GS1_LINTER_NOT_ISO3166);
 
                if (ret != GS1_LINTER_OK) {
                        if (err_pos) *err_pos = (size_t)(p - data);
                        if (err_len) *err_len = 3;
                        return ret;
                }
 
                p += 3;
 
        }
 
        /*
         *  Any remaining characters or an empty list are invalid.
         *
         */
        if (p != q || q - data == 0) {
                if (err_pos) *err_pos = (size_t)(p - data);
                if (err_len) *err_len = (size_t)(q - p);
                return GS1_LINTER_NOT_ISO3166;
        }
 
        return GS1_LINTER_OK;
 
}