lint_hh.c File Reference

Purpose

The hh linter ensures that the given data is a meaningful hour number in a day.

Functional Description

gs1_lint_hh()

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

Used to ensure that an AI component conforms to HH format for hours within a day.

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_HOUR_TOO_SHORT if the data is too short for HH format.

GS1_LINTER_HOUR_TOO_LONG if the data is too long for HH format.

GS1_LINTER_NON_DIGIT_CHARACTER if the data contains a non-digit character.

GS1_LINTER_ILLEGAL_HOUR if the data contains an invalid hour.

{
 
        int pos;
 
        assert(data);
 
        /*
         * Data must be exactly two characters.
         *
         */
        if (GS1_LINTER_UNLIKELY(data_len != 2))
                GS1_LINTER_RETURN_ERROR(
                        data_len < 2 ? GS1_LINTER_HOUR_TOO_SHORT : GS1_LINTER_HOUR_TOO_LONG,
                        0,
                        data_len
                );
 
        /*
         * Data must consist of all digits.
         */
        for (pos = 0; pos < 2; pos++)
                if (GS1_LINTER_UNLIKELY(data[pos] < '0' || data[pos] > '9'))
                        GS1_LINTER_RETURN_ERROR(
                                GS1_LINTER_NON_DIGIT_CHARACTER,
                                (size_t)pos,
                                1
                        );
 
        /*
         * Validate the hour (00-23).
         */
        if (GS1_LINTER_UNLIKELY((data[0] - '0') * 10 + (data[1] - '0') > 23))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_ILLEGAL_HOUR,
                        0,
                        2
                );
 
        GS1_LINTER_RETURN_OK;
 
}