# ftostrC#

## Purpose#

Converts a matrix to a string array using a C language format specification.

## Format#

sa = ftostrC(x, fmt)#
Parameters:
• x (NxK matrix) – real or complex.

• fmt (Kx1 or 1xK or 1x1 string array) – format information.

Returns:

sa (NxK string array) – contains the contents of x converted into a string array.

## Examples#

### Example 1#

```grade = 0.937;
print ftostrC(100 * grade, "Your course grade is: %f");
print ftostrC(100 * grade, "Your course grade is: %.1f");
print ftostrC(100 * grade, "Your course grade is: %9.3f");
```

will return:

```Your course grade is: 93.700000
Your course grade is: 93.7
Your course grade is:    93.700
```

### Example 2:#

```declare string fmtr = { "%6.3lf",
"%11.8lf" };

declare string fmtc = { "(%6.3lf, %6.3lf)",
"(%11.8lf, %11.8lf)" };

xr = rndn(4, 2);
xc = sqrt(xr')';

sar = ftostrC(xr, fmtr);
sac = ftostrC(xc, fmtc);

print sar;
print sac;
```

produces:

```-0.166 1.05565441
-1.590 -0.79283296
0.130 -1.84886957
0.789 0.86089687

( 0.000, -0.407) ( 1.02745044, 0.00000000)
( 0.000, -1.261) ( 0.00000000, -0.89041168)
( 0.361, 0.000) ( 0.00000000, -1.35973143)
( 0.888, 0.000) ( 0.92784529, 0.00000000)
```

## Remarks#

If fmt has K elements, each column of sa can be formatted separately. If x is complex, there must be two format specifications in each element of fmt.