Main Content

cur2str

Bank-formatted text

collapse all in page

Syntax

BankText = cur2str(Value,Digits)

Description

BankText = cur2str(Value,Digits) returns the given value in bank format.

The output format for BankText is a numerical format with dollar sign prefix, two decimal places, and negative numbers in parentheses; for example, ($123.45) and $6789.01. The standard MATLAB® bank format uses two decimal places, no dollar sign, and a minus sign for negative numbers; for example, −123.45 and 6789.01.

example

Examples

collapse all

Open Live Script

Return bank formatted text for a negative numeric value. 

BankText = cur2str(-826444.4456,3)   
BankText = 
'($826444.446)'

% Negative numbers are displayed in parentheses.

Input Arguments

collapse all

Value to be formatted, specified as a numeric value.

Data Types: double

Number of significant digits, specified as an integer. For example, when rounding off the value of 1 significant digit, on the right of the decimal point, .1921212 is rounded of to .2:

cur2str(9990.1921212,1)
ans =

    '$9990.2'

A negative Digits rounds the value to the left of the decimal point.

Data Types: double

Output Arguments

collapse all

Bank-formatted text (BankText) is returned as a character vector with a leading dollar sign ($). Negative numbers are displayed in parentheses.

Version History

Introduced before R2006a

See Also

|