CAPLfunctiongcvt

Open topic with navigation

CAPL Functions » General » Function Overview » _gcvt

_gcvt

Valid for: CANoe DE • CANoe:lite DE • CANoe4SW DE • CANoe4SW:lite DE

Function Syntax

void  _gcvt(double val, int digits, char s[]);

Description

The number val is converted to a string s containing a decimal point and a possible sign byte.

Parameters

• val: Number to be converted.
• digits: Number of significant digits.
• s: String, which contains the converted number. If the string size is too small, the string stays unchanged.

Return Values

—

Example

char s[15];

float val1 = 3.1415926535;
float val2 = 271828.18284;
_gcvt(val1, 10, s);
writeToLogEx("val1: %f: s: %s", val1, s);
_gcvt(val2, 9, s);
writeToLogEx("val2: %f: s: %s", val2, s);
_gcvt(val2, 5, s);
writeToLogEx("val2: %f: s: %s", val2, s);
_gcvt(val2, 20, s); // String size too small, string stays unchanged
writeToLogEx("val2: %f: s: %s", val2, s);
...

Result:

val1: 3.141593: s: 3.141592654
val2: 271828.182840: s: 271828.182
val2: 271828.182840: s: 2.7183e+005
val2: 271828.182840: s: 2.7183e+005

atol • ltoa