CodeCogs

Format a number with grouped thousands.

You're viewing an older version of this page (#269). View the current version.

Interface

#include <codecogs/computing/io/format/number_format.h>

using namespace Computing::Io::Format;

std::string number_format( double value, int dp=0, char dec_point= '.' , char thousand_sep= ',' )

Overview

Format a number, by inserting a separator between every 3 digits of the main number and by rounding the result to the specified number of decimal places. The function is modelled on the PHP equivalent of the same name.

Example:

#include <stdio.h>
#include <codecogs/computing/io/format/number_format.h>

int main ()
{
  char* a=IO::Format::number_format_c(234.38645,2);
  printf("\n%s", a);
	delete[](a);
}

Output:

234.39

This function create a dynamic array, ensure you release this memory with delete[]

Parameters

value

The number to be converted into a text string.

The number of decimal places to truncate the number to. dp has a range from 0 to 19. (default =0)

dec_point

is the character to be used as a decimal point. (default='.')

thousand_sep

Character to be inserted after every 3 digits. (default=',')

Returns

A character string of the formatted number.

The routine does not work with very very large numbers.

FUNCTION

number_format

This function only differs from that above in that it returns a standard string object, which is automatically released from memory when the object goes out of scrope. Thereby avoiding any possible memory leaks.