lint_winding.c File Reference

Purpose

The winding linter ensures that the given data represents a meaningful Winding Direction on a roll, either "0" (face out), "1" (face in) or "9" (undefined).

Remarks

The Winding Direction is defined in the GS1 General Specifications section "Roll products - width, length, core diameter, direction, splices: AI (8001)".

Functional Description

gs1_lint_winding()

GS1_SYNTAX_DICTIONARY_API gs1_lint_err_t gs1_lint_winding	(	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 the string "0", "1" or "9".

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_WINDING_DIRECTION if the data is not "0", "1" or "9".

{
 
        assert(data);
 
 
        /*
         * The data must be either "0", "1" or "9".
         *
         */
        if (GS1_LINTER_UNLIKELY(data_len != 1))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_WINDING_DIRECTION,
                        0,
                        data_len
                );
 
        if (GS1_LINTER_UNLIKELY(data[0] != '0' && data[0] != '1' && data[0] != '9'))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_WINDING_DIRECTION,
                        0,
                        1
                );
 
        GS1_LINTER_RETURN_OK;
 
}