A konvertáló utasításokat a SysUtils unitban találjuk.
A legegyszerűbb függvény az StrToFloat. Ha használata során, a bementi sztring nem megfelelő formátumú, akkor az EConvertError hibát eredményez.
StrToFloat
function StrToFloat(
const S: string
): Extended;
Szöveget valós számmá konvertál.
Paraméterek
const S: string
Sztring, amely szöveges formában tartalmazza a valós számot.
Visszatérési érték
Valós szám.
A következő lehetőség, hogy a konvertálást úgy végezzük el, hogy hiba esetén egy alap érték legyen az eredmény. Így már elkerülhető a futási hiba.
StrToFloatDef
function StrToFloatDef(
const S: string;
const Default: Extended
): Extended;
Egy sztringet valós számmá konvertál. Ha a konvertálás során hiba történne, akkor eredményül a Default paraméterben megadott alapértéket adja.
Paraméterek
const S: string
A konvertálandó sztring.
const Default: Extended
Az alap érték, amely hiba esetén a függvény visszatérési értéke lesz.
Visszatérési érték
Ha a konverzió sikeres volt, akkor az S megfelelője valós számként. Ha hiba lépett fel, akkor visszatérési értékként a Default paraméterben megadott számot kapjuk.
Egy újabb lehetőség, hogy egy sztringet valós számmá konvertálunk, a konverzió sikerességét pedig egy logikai érték segítségével lekérdezhetjük. Erre szolgál a TryStrToFloat függvény, amelynek 3 fajtája van, attól függően, hogy a konvertálás eredménye Extended, Double, vagy Single.
function TryStrToFloat(const S: string; out Value: Extended): Boolean;
function TryStrToFloat(const S: string; out Value: Double): Boolean;
function TryStrToFloat(const S: string; out Value: Single):
Az S paraméterben a konvertálandó sztringet kell megadnunk. A Value paraméterben megadott változóba kerül a konvertálás eredménye, ha az sikeres volt. A függvények visszatérési értéke akkor igaz, ha a konverzió sikeresen megtörtént, egyébként hamis.
Ha a konvertálás során hiba történik, nem kapunk hibaüzenetet, csak a függvény hamis visszatérési értékéből értesülhetünk róla.
A fent említett függvények mindegyike az operációs rendszer formázási beállításait használja. Ez meghatározza például azt, hogy tizedes vesszőt vagy tizedes pontot használunk.
A Delphi 7-ben, a SysUtils unitot újabb függvénnyekkel bővítették, amelyek lehetővé teszik az operációs rendszer beállításaitól független konverziók használatát.
Egy TFormatSettings típusú változó segítségével mi adhatjuk meg a formázási beállításokat, a különböző függvényekben. A struktúra megfelelő tagjait be kell állítanunk, még a függvények meghívása előtt.
A függvények így a következő alakokban is léteznek.
function StrToFloat(const S: string; const FormatSettings: TFormatSettings): Extended;
function StrToFloatDef(const S: string; const Default: Extended; const FormatSettings: TFormatSettings): Extended;
function TryStrToFloat(const S: string; out Value: Extended; const FormatSettings: TFormatSettings): Boolean;
function TryStrToFloat(const S: string; out Value: Double; const FormatSettings: TFormatSettings): Boolean;
function TryStrToFloat(const S: string; out Value: Single; const FormatSettings: TFormatSettings): Boolean;