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	data_len,
		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]	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_LATITUDE_INVALID_LENGTH if the latitude does not have length 10.

GS1_LINTER_INVALID_LATITUDE if the latitude is outside the range 0000000000 - 1800000000.

{
 
        size_t pos;
        unsigned long value;
 
        assert(data);
 
        /*
         * Data must be 10 characters.
         *
         */
        if (GS1_LINTER_UNLIKELY(data_len != 10))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_LATITUDE_INVALID_LENGTH,
                        0,
                        data_len
                );
 
        /*
         * Data must consist of all digits and latitude must be within
         * 0000000000 to 1800000000.
         *
         */
        for (pos = 0, value = 0; pos < data_len; pos++) {
                if (GS1_LINTER_UNLIKELY(data[pos] < '0' || data[pos] > '9'))
                        GS1_LINTER_RETURN_ERROR(
                                GS1_LINTER_NON_DIGIT_CHARACTER,
                                pos,
                                1
                        );
                value = value * 10 + (unsigned long)(data[pos] - '0');
        }
 
        if (GS1_LINTER_UNLIKELY(value > 1800000000))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_LATITUDE,
                        0,
                        10
                );
 
        GS1_LINTER_RETURN_OK;
 
}