lint_importeridx.c File Reference

Purpose

The importeridx linter ensures that the given data is a valid Importer Index, as included in a Facility ID or Machine ID used in the EU 2018/574 system.

Remarks

The Facility ID and Machine ID data elements used in the EU 2018/574 system are described in the GS1 General Specification section "European Regulation 2018/574, traceability of tobacco products".

Functional Description

gs1_lint_importeridx()

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

Used to validate that an AI component is a valid Importer Index.

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_INVALID_IMPORT_IDX_CHARACTER if the data is not a valid Importer Index character.

GS1_LINTER_IMPORTER_IDX_MUST_BE_ONE_CHARACTER if the data isn't a single character.

{
 
        size_t len;
 
        /*
         * All valid Importer Index characters.
         *
         */
        static const char* const importeridx =
                "-0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz";
 
        assert(data);
 
        len = strlen(data);
 
        /*
         * Data must be a single character.
         *
         */
        if (len != 1)
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_IMPORTER_IDX_MUST_BE_ONE_CHARACTER,
                        0,
                        len
                );
 
        /*
         * Any character outside of the valid Importer Index character list is
         * illegal.
         *
         */
        if (strspn(data, importeridx) != len)
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_IMPORT_IDX_CHARACTER,
                        0,
                        1
                );
 
        GS1_LINTER_RETURN_OK;
 
}