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 *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 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_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.

{
 
        size_t len, pos;
 
        assert(data);
 
        len = strlen(data);
 
        /*
         * Data must be two characters.
         *
         */
        if (len != 2)
                GS1_LINTER_RETURN_ERROR(
                        len < 2 ? GS1_LINTER_HOUR_TOO_SHORT : GS1_LINTER_HOUR_TOO_LONG,
                        0,
                        len
                );
 
        /*
         * Data must consist of all digits.
         *
         */
        if ((pos = strspn(data, "0123456789")) != len)
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_NON_DIGIT_CHARACTER,
                        pos,
                        1
                );
 
        /*
         * Validate the minute.
         *
         */
        if ((data[0] - '0') * 10 + (data[1] - '0') > 23)
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_ILLEGAL_HOUR,
                        0,
                        2
                );
 
        GS1_LINTER_RETURN_OK;
 
}