lint_yymmddhh.c File Reference

Purpose

The yymmddhh linter ensures that the data represents a meaningful date and hour of day, in YYMMDDHH format.

Functional Description

gs1_lint_yymmddhh()

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

Used to ensure that an AI component conforms to the YYMMDDHH 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_DATE_WITH_HOUR_TOO_SHORT if the data is too short for YYMMDDHH format.

GS1_LINTER_DATE_WITH_HOUR_TOO_LONG if the data is too long for YYMMDDHH format.

GS1_LINTER_NON_DIGIT_CHARACTER if the data contains a non-digit character.

GS1_LINTER_ILLEGAL_MONTH if the data contains an invalid month.

GS1_LINTER_ILLEGAL_DAY if the data contains an invalid day of the month.

GS1_LINTER_ILLEGAL_HOUR if the data contains an illegal hour.

{
 
        char yymmdd[7] = {0};
        size_t pos, len;
        gs1_lint_err_t ret;
 
        assert(data);
 
        len = strlen(data);
 
        /*
         * Data must be eight characters.
         *
         */
        if (len != 8) {
                if (err_pos) *err_pos = 0;
                if (err_len) *err_len = len;
                return len < 8 ?
                        GS1_LINTER_DATE_WITH_HOUR_TOO_SHORT :
                        GS1_LINTER_DATE_WITH_HOUR_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 date component.
         *
         */
        memcpy(yymmdd, data, 6);
        ret = gs1_lint_yymmdd(yymmdd, err_pos, err_len);
 
        assert(ret == GS1_LINTER_OK ||
               ret == GS1_LINTER_DATE_TOO_SHORT ||
               ret == GS1_LINTER_DATE_TOO_LONG ||
               ret == GS1_LINTER_NON_DIGIT_CHARACTER ||
               ret == GS1_LINTER_ILLEGAL_MONTH ||
               ret == GS1_LINTER_ILLEGAL_DAY);
 
        if (ret != GS1_LINTER_OK)
                return ret;
 
        /*
         * Validate the hour component.
         *
         */
        if ((data[6] - '0') * 10 + (data[7] - '0') > 23) {
                if (err_pos) *err_pos = 6;
                if (err_len) *err_len = 2;
                return GS1_LINTER_ILLEGAL_HOUR;
        }
 
        return GS1_LINTER_OK;
 
}