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

Purpose

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

Functional Description

◆ gs1_lint_longitude()

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

Used to validate that an AI component represents the longitude 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_LONGITUDE_INVALID_LENGTH if the longitude does not have length 10.
GS1_LINTER_INVALID_LONGITUDE if the longitude is outside the range 0000000000 - 3600000000.
52{
53
54 size_t len, pos;
55
56 assert(data);
57
58 len = strlen(data);
59
60 /*
61 * Data must be 10 characters.
62 *
63 */
64 if (len != 10)
67 0,
68 len
69 );
70
71 /*
72 * Data must consist of all digits.
73 *
74 */
75 if ((pos = strspn(data, "0123456789")) != len)
78 pos,
79 1
80 );
81
82 /*
83 * The longitude must be within the range 0000000000 to 3600000000.
84 *
85 */
86 if (strtoul(data, NULL, 10) > 3600000000)
89 0,
90 10
91 );
92
94
95}
#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:77
#define GS1_LINTER_RETURN_OK
Return from a linter indicating that no problem was detected with the given data.
Definition gs1syntaxdictionary-utils.h:62
@ GS1_LINTER_INVALID_LONGITUDE
The longitude is outside of the range "0000000000" to "3600000000".
Definition gs1syntaxdictionary.h:181
@ GS1_LINTER_LONGITUDE_INVALID_LENGTH
The longitude value must be 10 digits.
Definition gs1syntaxdictionary.h:184
@ GS1_LINTER_NON_DIGIT_CHARACTER
A non-digit character was found where a digit is expected.
Definition gs1syntaxdictionary.h:78