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	data_len,
		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 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_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.

{
 
        /*
         * Importer index characters: -0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz
         *
         */
        static const uint64_t importeridx_bitfield[] = {
                0x000000000004ffc0,             // "-", 0-9
                0x7fffffe17fffffe0,             // A-Z, "_", a-z
                0x0000000000000000,
                0x0000000000000000
        };
 
        int valid;
 
        assert(data);
 
 
        /*
         * Data must be a single character.
         *
         */
        if (GS1_LINTER_UNLIKELY(data_len != 1))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_IMPORTER_IDX_MUST_BE_ONE_CHARACTER,
                        0,
                        data_len
                );
 
        /*
         * Validate character using bitfield lookup
         *
         */
        GS1_LINTER_BITFIELD_LOOKUP((unsigned char)data[0], importeridx_bitfield, valid);
        if (GS1_LINTER_UNLIKELY(!valid))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_IMPORT_IDX_CHARACTER,
                        0,
                        1
                );
 
        GS1_LINTER_RETURN_OK;
 
}