lint_iso5218.c File Reference

Purpose

The iso5218 linter ensures that the given data represents a ISO/IEC 5218 biological sex code, either "0" (not known), "1" (male), "2" (female) or "9" (not applicable).

Remarks

The biological sex codes are defined by ISO/IEC 5218: Information technology - Codes for the representation of human sexes.

Functional Description

gs1_lint_iso5218()

GS1_SYNTAX_DICTIONARY_API gs1_lint_err_t gs1_lint_iso5218	(	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 is the string "0", "1", "2" or "9".

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_INVALID_BIOLOGICAL_SEX_CODE if the data is not "0", "1", "2" or "9".

{
 
        assert(data);
 
 
        /*
         * The data must be either "0", "1", "2" or "9".
         *
         */
        if (GS1_LINTER_UNLIKELY(data_len != 1))
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_BIOLOGICAL_SEX_CODE,
                        0,
                        data_len
                );
 
        if (GS1_LINTER_UNLIKELY(
                data[0] != '0' && data[0] != '1' && data[0] != '2' && data[0] != '9'
                               )
           )
                GS1_LINTER_RETURN_ERROR(
                        GS1_LINTER_INVALID_BIOLOGICAL_SEX_CODE,
                        0,
                        1
                );
 
        GS1_LINTER_RETURN_OK;
 
}