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_latitude.c File Reference

Purpose

The latitude linter ensures that the given data represents the latitude component of a WGS84 coordinate expressed as a 10-digit number.

Functional Description

◆ gs1_lint_latitude()

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

Used to validate that an AI component represents the latitude component of a WGS84 coordinate expressed as a 10-digit number.

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_LATITUDE_INVALID_LENGTH if the latitude does not have length 10.
GS1_LINTER_INVALID_LATITUDE if the latitude is outside the range 0000000000 - 1800000000.
52{
53
54 size_t pos;
55
56 assert(data);
57
58 /*
59 * Data must consist of all digits.
60 *
61 */
62 for (pos = 0; pos < 10 && data[pos]; pos++)
63 if (GS1_LINTER_UNLIKELY(data[pos] < '0' || data[pos] > '9'))
66 pos,
67 1
68 );
69
70 /*
71 * Data must be 10 characters.
72 *
73 */
74 if (GS1_LINTER_UNLIKELY(pos != 10 || data[10]))
77 0,
78 pos + (data[pos] ? 1 : 0)
79 );
80
81 /*
82 * The latitude must be within the range 0000000000 to 1800000000.
83 *
84 */
85 if (GS1_LINTER_UNLIKELY(strtoul(data, NULL, 10) > 1800000000))
88 0,
89 10
90 );
91
93
94}
#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_LATITUDE_INVALID_LENGTH
The latitude value must be 10 digits.
Definition gs1syntaxdictionary.h:183
@ GS1_LINTER_INVALID_LATITUDE
The latitude is outside of the range "0000000000" to "1800000000".
Definition gs1syntaxdictionary.h:180
@ GS1_LINTER_NON_DIGIT_CHARACTER
A non-digit character was found where a digit is expected.
Definition gs1syntaxdictionary.h:78