/*------------------------------------------------------------------ * strisalphanumeric_s.c * * November 2008, Bo Berry * * Copyright (c) 2008-2011, 2013 by Cisco Systems, Inc * All rights reserved. * * Permission is hereby granted, free of charge, to any person * obtaining a copy of this software and associated documentation * files (the "Software"), to deal in the Software without * restriction, including without limitation the rights to use, * copy, modify, merge, publish, distribute, sublicense, and/or * sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following * conditions: * * The above copyright notice and this permission notice shall be * included in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR * OTHER DEALINGS IN THE SOFTWARE. *------------------------------------------------------------------ */ #ifdef FOR_DOXYGEN #include "safe_str_lib.h" #else #include "safeclib_private.h" #endif /** * @def strisalphanumeric_s(dest,smax) * @brief * This function checks if the entire string contains * alphanumerics. The scanning stops at the first null * or after smax characters. * * @remark EXTENSION TO * ISO/IEC TR 24731, Programming languages, environments * and system software interfaces, Extensions to the C Library, * Part I: Bounds-checking interfaces * * @param dest pointer to string * @param dmax maximum length of string * * @pre dest shall not be a null pointer. * @pre dmax shall not equal zero. * @pre dmax shall not be greater than RSIZE_MAX_STR and size of dest * * @return true when all chars in dest are alphanumeric * @return false when dest is not alphanumeric or an error occurred * * @see * strisascii_s(), strisdigit_s(), strishex_s(), strislowercase_s(), * strismixedcase_s(), strisuppercase_s() * */ #ifdef FOR_DOXYGEN bool strisalphanumeric_s(const char *dest, rsize_t dmax) #else EXPORT bool _strisalphanumeric_s_chk(const char *dest, rsize_t dmax, const size_t destbos) #endif { CHK_DEST_DMAX_BOOL("strisalphanumeric_s", RSIZE_MAX_STR) if (unlikely(*dest == '\0')) { return (false); } while (*dest && dmax) { if (((*dest >= '0') && (*dest <= '9')) || ((*dest >= 'a') && (*dest <= 'z')) || ((*dest >= 'A') && (*dest <= 'Z'))) { dest++; dmax--; } else { return (false); } } return (true); }