lint_hhmm.c File Reference

Purpose

The hhmm linter ensures that the given data is meaningful time as hours and minutes, in HHMM format.

Functional Description

gs1_lint_hhmm()

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

Used to ensure that an AI component conforms to HHMM format.

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

GS1_LINTER_HOUR_WITH_MINUTE_TOO_LONG if the data is too long for HHMM 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.

GS1_LINTER_ILLEGAL_MINUTE if the data contains an invalid minute.

{
 
        size_t len, pos;
 
        assert(data);
 
        len = strlen(data);
 
        /*
         * Data must be four characters.
         *
         */
        if (len != 4) {
                if (err_pos) *err_pos = 0;
                if (err_len) *err_len = len;
                return len < 4 ? GS1_LINTER_HOUR_WITH_MINUTE_TOO_SHORT : GS1_LINTER_HOUR_WITH_MINUTE_TOO_LONG;
        }
 
        /*
         * Data must consist of all digits.
         *
         */
        if ((pos = strspn(data, "0123456789")) != len) {
                if (err_pos) *err_pos = pos;
                if (err_len) *err_len = 1;
                return GS1_LINTER_NON_DIGIT_CHARACTER;
        }
 
        /*
         * Validate the hour.
         *
         */
        if ((data[0] - '0') * 10 + (data[1] - '0') > 23) {
                if (err_pos) *err_pos = 0;
                if (err_len) *err_len = 2;
                return GS1_LINTER_ILLEGAL_HOUR;
        }
 
        /*
         * Validate the minute.
         *
         */
        if ((data[2] - '0') * 10 + (data[3] - '0') > 59) {
                if (err_pos) *err_pos = 2;
                if (err_len) *err_len = 2;
                return GS1_LINTER_ILLEGAL_MINUTE;
        }
 
        return GS1_LINTER_OK;
 
}