/** @file conv.c * @brief Functions to convert from string to integer. */ #include #include #include #include "faux/conv.h" /** @brief Converts string to long int * * Converts string to long int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atol(const char *str, long int *val, int base) { char *endptr = NULL; long int res = 0; errno = 0; // man recommends to do so res = strtol(str, &endptr, base); // Check for overflow if (((LONG_MIN == res) || (LONG_MAX == res)) && (ERANGE == errno)) return -1; // No valid digits at all if ((0 == res) && ((endptr == str) || (errno != 0))) return -1; *val = res; return 0; } /** @brief Converts string to unsigned long int * * Converts string to unsigned long int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoul(const char *str, unsigned long int *val, int base) { char *endptr = NULL; unsigned long int res = 0; errno = 0; // man recommends to do so res = strtoul(str, &endptr, base); // Check for overflow if ((ULONG_MAX == res) && (ERANGE == errno)) return -1; // No valid digits at all if ((0 == res) && ((endptr == str) || (errno != 0))) return -1; *val = res; return 0; } /** @brief Converts string to long long int * * Converts string to long long int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoll(const char *str, long long int *val, int base) { char *endptr = NULL; long long int res = 0; errno = 0; // man recommends to do so res = strtoll(str, &endptr, base); // Check for overflow if (((LLONG_MIN == res) || (LLONG_MAX == res)) && (ERANGE == errno)) return -1; // No valid digits at all if ((0 == res) && ((endptr == str) || (errno != 0))) return -1; *val = res; return 0; } /** @brief Converts string to unsigned long long int * * Converts string to unsigned long long int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoull(const char *str, unsigned long long int *val, int base) { char *endptr = NULL; unsigned long long int res = 0; errno = 0; // man recommends to do so res = strtoull(str, &endptr, base); // Check for overflow if ((ULLONG_MAX == res) && (ERANGE == errno)) return -1; // No valid digits at all if ((0 == res) && ((endptr == str) || (errno != 0))) return -1; *val = res; return 0; } /** @brief Converts string to int * * Converts string to int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoi(const char *str, int *val, int base) { long int tmp = 0; // Use existent func. The long int is longer or equal to int. if (faux_conv_atol(str, &tmp, base) < 0) return -1; if ((tmp < INT_MIN) || (tmp > INT_MAX)) // Overflow return -1; *val = tmp; return 0; } /** @brief Converts string to unsigned int * * Converts string to unsigned int and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoui(const char *str, unsigned int *val, int base) { unsigned long int tmp = 0; // Use existent func. The long int is longer or equal to int. if (faux_conv_atoul(str, &tmp, base) < 0) return -1; if (tmp > UINT_MAX) // Overflow return -1; *val = tmp; return 0; } /** @brief Converts string to short * * Converts string to short and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atos(const char *str, short *val, int base) { long int tmp = 0; if (faux_conv_atol(str, &tmp, base) < 0) return -1; if ((tmp < SHRT_MIN) || (tmp > SHRT_MAX)) // Overflow return -1; *val = tmp; return 0; } /** @brief Converts string to unsigned short * * Converts string to unsigned short and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atous(const char *str, unsigned short *val, int base) { unsigned long int tmp = 0; if (faux_conv_atoul(str, &tmp, base) < 0) return -1; if (tmp > USHRT_MAX) // Overflow return -1; *val = tmp; return 0; } /** @brief Converts string to char * * Converts string to char and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atoc(const char *str, char *val, int base) { long int tmp = 0; if (faux_conv_atol(str, &tmp, base) < 0) return -1; if ((tmp < CHAR_MIN) || (tmp > CHAR_MAX)) // Overflow return -1; *val = tmp; return 0; } /** @brief Converts string to unsigned char * * Converts string to unsigned char and check for overflow and valid * input values. Function indicates error by return value. It * returns the convertion result by second argument. * * @param [in] str Input string to convert. * @param [out] val Pointer to result value. * @param [in] base Base to convert. * @return 0 - success, < 0 - error */ int faux_conv_atouc(const char *str, unsigned char *val, int base) { unsigned long int tmp = 0; if (faux_conv_atoul(str, &tmp, base) < 0) return -1; if (tmp > UCHAR_MAX) // Overflow return -1; *val = tmp; return 0; }