GS1 Barcode Syntax Tests reference
A reference to the AI component "linter" routines referred to by the GS1 Barcode Syntax Dictionary. Copyright (c) 2022-2024 GS1 AISBL.
lint_nozeroprefix.c File Reference

Purpose

The nozeroprefix linter ensures that the given data does not start with a zero.

Functional Description

◆ gs1_lint_nozeroprefix()

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

Used to validate that a numeric AI component does not start with zero.

Parameters
[in]dataPointer to the null-terminated data to be linted. Must not be NULL.
[out]err_posTo facilitate error highlighting, the start position of the bad data is written to this pointer, if not NULL.
[out]err_lenThe length of the bad data is written to this pointer, if not NULL.
Returns
GS1_LINTER_OK if okay.
GS1_LINTER_ILLEGAL_ZERO_PREFIX if the data starts with zero.
GS1_LINTER_NON_DIGIT_CHARACTER if the data contains non-digit characters.
49{
50
51 size_t pos;
52
53 assert(data);
54
55 /*
56 * Data must not start with a zero
57 */
58 if (GS1_LINTER_UNLIKELY(*data == '0'))
61 0,
62 1
63 );
64
65 /*
66 * Validate digits using direct range checking
67 */
68 for (pos = 0; data[pos] != '\0'; pos++) {
69 if (GS1_LINTER_UNLIKELY(data[pos] < '0' || data[pos] > '9'))
72 pos,
73 1
74 );
75 }
76
78
79}
#define GS1_LINTER_UNLIKELY(x)
Implemention may provide hint to the compiler that the expression is likely to be false.
Definition gs1syntaxdictionary-utils.h:76
#define GS1_LINTER_RETURN_ERROR(error, position, length)
Return from a linter indicating that a problem was detected with the given data.
Definition gs1syntaxdictionary-utils.h:103
#define GS1_LINTER_RETURN_OK
Return from a linter indicating that no problem was detected with the given data.
Definition gs1syntaxdictionary-utils.h:88
@ GS1_LINTER_ILLEGAL_ZERO_PREFIX
A zero prefix is not permitted.
Definition gs1syntaxdictionary.h:94
@ GS1_LINTER_NON_DIGIT_CHARACTER
A non-digit character was found where a digit is expected.
Definition gs1syntaxdictionary.h:78