lint_cset39.c File Reference

Purpose

The cset39 linter ensures that the given data contains only characters within GS1 AI encodable character set 39 ("CSET 39").

Remarks

CSET 39 is defined in the GS1 General Specifications table "GS1 AI encodable character set 39".

Functional Description

gs1_lint_cset39()

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

Used to validate that an AI component conforms to C..99 syntax.

Note: The length of the component is validated by the framework that calls this function.

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_INVALID_CSET39_CHARACTER if the data contains a non-CSET 39 character.

{
 
        /*
         * All characters in "CSET 39", the 39 character alphabet.
         *
         */
        static const char* const cset39 =
                "#-/0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
 
        size_t pos;
 
        assert(data);
 
        /*
         * Any character outside of CSET 39 is illegal.
         *
         */
        if ((pos = strspn(data, cset39)) != strlen(data))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_CSET39_CHARACTER,
                        pos,
                        1
                );
 
        GS1_LINTER_RETURN_OK;
 
}