![]() |
Safe Numerics |
Using an intrinsic C++ array, it's very easy to exceed array limits. This can fail to be detected when it occurs and create bugs which are hard to find. There are several ways to address this, but one of the simplest would be to use safe_unsigned_range;
#include <stdexcept>
#include <iostream>
#include "../include/safe_range.hpp"
void detected_msg(bool detected){
std::cout << (detected ? "error detected!" : "error NOT detected! ") << std::endl;
}
int main(int argc, const char * argv[]){
// problem: array index values can exceed array bounds
std::cout << "example 5: ";
std::cout << "array index values can exceed array bounds" << std::endl;
std::cout << "Not using safe numerics" << std::endl;
std::array<int, 37> i_array;
// unsigned int i_index = 43;
// the following corrupts memory.
// This may or may not be detected at run time.
// i_array[i_index] = 84; // comment this out so it can be tested!
std::cout << "error NOT detected!" << std::endl;
// solution: replace unsigned array index with safe_unsigned_range
std::cout << "Using safe numerics" << std::endl;
try{
using namespace boost::numeric;
using i_index_t = safe_unsigned_range<0, i_array.size() - 1>;
i_index_t i_index;
i_index = 36; // this works fine
i_array[i_index] = 84;
i_index = 43; // throw exception here!
std::cout << "error NOT detected!" << std::endl; // so we never arrive here
}
catch(std::exception & e){
std::cout << e.what() << std::endl;
std::cout << "error detected!" << std::endl;
}
return 0;
}
Collections
like standard arrays, vectors do array index checking in some function
calls and not in others so this may not be the best example. However it
does illustrate the usage of safe_range<T> for
assigning legal range to variables. This will guarantee that under no
circumstances will the variable contain a value outside of the specified
range.