<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/cknatstr.c">
<Name>LQU_cknatstr</Name>
<Class>Utilities/Strings
<Purpose>
Checks whether the given string argument represents a natural
number; that is, an optional plus or minus sign followed by
one or more decimal digits.
Leading whitespace, as reported by the isspace macro, is ignored,
but no trailing whitespace is allowed.
<Returns>
Zero if the match fails, and one if it succeeds.
<Bugs>
<LIST>
<LI>Should return a pointer to the first implausible character.</LI>
  <LI>Should probably allow trailing whitespace.</LI>
  <LI>Does not check its argument for a NULL pointer.</LI>
</LIST>
</Function>
<Decl>
API int
LQU_cknatstr(str)
    CONST char *str;
</Decl>
</Entry>
