<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/range.c">
<Name>LQU_LargerThanRangeTop</Name>
<Class>Utilities/Numeric Range
<Purpose>
Use for efficiency, to determine whether a given number is larger
than the largest value accepted by the given range.
Passing a range that ended with a hyphen (for example, 1,2,5-7,12-)
will always produce a zero result, even if n falls within a `hole'
in the range, as for 4, 8, 9, 10 and 11 in the example here.
<Returns>
<LIST>
<LI>0 if the number is not entirely beyond the given range
<LI>1 otherwise
</LIST>
<SeeAlso>
LQU_StringToRange
LQU_NumberWithinRange
</Function>
<Decl>
API int
LQU_LargerThanRangeTop(n, Range)
    CONST int n;
    CONST t_Range *Range;
</Decl>
</Entry>
