fn() lexicalCast

Cast from a String-type to a numerical type

/*!
 * @fn lexicalCast
 * 
 * @headerfile <seqan/stream.h>
 * 
 * @brief Cast from a String-type to a numerical type
 * 
 * @signature TTarget lexicalCast<TTarget>(source);
 * 
 * @tparam TTarget Target type to cast to.
 * 
 * @param[in] source The string to be read from. Type: @link SequenceConcept
 *                   @endlink.
 * 
 * @return TTarget Value of Type TTarget with cast contents of source.
 * 
 * Return value undefined if casting fails, see @link lexicalCast2 @endlink for
 * a more robust variant.
 * 
 * This function uses <tt>std::istringstream</tt> internally, so right now
 * "123foobar" will be succesfully cast to an int of 123.
 * 
 * @section Examples
 * 
 * Using <tt>lexicalCast<>()</tt> is easy but not as robust as @link
 * lexicalCast2 @endlink: We cannot detect parsing or conversion errors.
 * 
 * @code{.cpp}
 * unsigned u = 0;
 * int i = 0;
 * double = 0;
 * bool success = false;
 *  
 * u = lexicalCast<unsigned>( "3");   // => u is 3.
 * u = lexicalCast<unsigned>("-3");   // => u is undefined.
 * i = lexicalCast<int>("-3");        // => i is -3.
 * d = lexicalCast<double>("-3.99");  // => d is -3.99.
 * @endcode
 * 
 * 
 * @see lexicalCast2
 */