X++ konverzió futásidejű funkciók

Bankjegy

A közösségi érdekcsoportok mostantól a Yammerből a Microsoft Viva Engagebe költöztek. Ha csatlakozni szeretne egy Viva Engage-közösséghez, és részt szeretne venni a legutóbbi megbeszéléseken, töltse ki a Pénzügyi és üzemeltetési Hozzáférés kérése Viva Engage Community űrlapot, és válassza ki a közösséget, amelyhez csatlakozni szeretne.

Ez a cikk a konvertálási futtatókörnyezeti függvényeket ismerteti.

any2Date

Bármely típusú értéket dátumértékké alakít át.

date any2Date(anytype object)

Paraméterek

Paraméter	Leírás
objektum	A dátummá konvertálandó érték.

Visszaadott érték

Dátumérték.

Megjegyzések

Az objektumparaméter lehet a legtöbb adattípus, de hasznos kimenetet kaphat, ha str vagy int típusú. A nem megfelelő tartalom futásidejű hibát okoz.

Példa

static void any2DateExample(Args _args)
{
    date myDate;
    str s;
    int i;
    s = "2010 6 17"; // A string object, of yyyy mm dd.
    myDate = any2Date(s);
    Global::info(strFmt("%1  is output, from input of "2010 6 17"", myDate));
    i = 40361; // An int object, which represents the number of days from 1900/01/01.
    myDate = any2Date(i);
    Global::info(strFmt("%1  is output, from input of 40361", myDate));
}
/**** Infolog display.
Message (04:44:15 pm)
6/17/2010 is output, from input of "2010 6 17"
7/4/2010 is output, from input of 40361
****/

any2Enum

Bármilyen típusú értéket konvertál a célszám egyik elemének Név tulajdonságértékére.

enum any2Enum(anytype object)

Paraméterek

Paraméter	Leírás
objektum	A célnumerálás egyik elemének Érték tulajdonságával egyező érték.

Visszaadott érték

A Név tulajdonság értéke a cél enumerálás bármelyik eleméhez tartozik egy Olyan Érték tulajdonság, amely megfelel a bemeneti paraméternek.

Megjegyzések

Az objektumparaméter lehet a legtöbb adattípus, de csak akkor kap hasznos adatokat, ha str vagyint típusú paramétert használ. Ez a bemeneti objektumparaméter a célszám egy elemének Érték tulajdonságára hivatkozik.

Példa

static void any2EnumExample(Args _args)
{
    NoYes myNoYes;  // NoYes is an enum.
    int i;
    str s;
    i = 0;  // An int that will be converted.
    myNoYes = any2Enum(i);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as int.", myNoYes, i));
    s = "1";  // A str that will be converted.
    myNoYes = any2Enum(s);
    Global::info(strfmt("'%1' - is the output, from input of the %2 as str.", myNoYes, s));
    /**** Infolog display.
    Message (01:05:32 pm)
    'No' - is the output, from input of the 0 as int.
    'Yes' - is the output, from input of the 1 as str.
    ****/
}

any2Guid

A megadott bármely típusú objektumot GUID-objektummá alakítja.

guid any2Guid(anytype object)

Paraméterek

Paraméter	Leírás
objektum	A GUID-objektummá konvertálandó érték.

Visszaadott érték

GUID-objektum.

any2Int

Bármely típusú értéket int értékké alakít át.

int any2Int(anytype object)

Paraméterek

Paraméter	Leírás
objektum	Az átalakítandó érték.

Visszaadott érték

Egy int érték.

Megjegyzések

Az objektumparaméter lehet a legtöbb adattípus, de csak akkor kap hasznos adatokat, ha enumerálási, valós vagy str típusú paramétereket használ.

Példa

static void any2IntExample(Args _args)
{
    int myInt;
    str s;
    NoYes a;
    real r;
    s = "31";
    myInt = any2Int(s);
    Global::info(strfmt("%1 is the output, from input of 31 as a str value.", myInt));
    a = NoYes::No;
    myInt = any2Int(a);
    Global::info(strfmt("%1 is the output, from input of NoYes::No as an enum value.", myInt));
    r = 5.34e2;
    myInt = any2Int(r);
    Global::info(strfmt("%1 is the output, from the input of 5.34e2 as a real value.", myInt));
}
/**** Infolog display.
Message (02:23:59 pm)
31 is the output, from input of 31 as a str value.
0 is the output, from input of NoYes::No as an enum value.
534 is the output, from the input of 5.34e2 as a real value.
****/

any2Int64

Bármely típusú objektumot int64-objektummá alakít át.

int64 any2Int64(anytype object)

Paraméterek

Paraméter	Leírás
objektum	Az átalakítandó anytype objektum.

Visszaadott érték

Int64-objektum.

any2Real

Bármely típusú értéket valós értékké alakít át.

real any2Real(anytype object)

Paraméterek

Paraméter	Leírás
objektum	Az átalakítandó érték.

Visszaadott érték

Egy valós érték.

Megjegyzések

Az objektumparaméter lehet a legtöbb adattípus, de hasznos kimenetet kaphat a dátum- és int, enum és str típusú bemeneti elemekhez.

Példa

static void any2RealExample(Args _args)
{
    real myReal;
    str s;
    int i;
    NoYes a;
    s = "5.12";
    myReal = any2Real(s);
    Global::info(strfmt("%1 is the output from the input of 5.12 as a str object", myReal));
    i = 64;
    myReal = any2Real(i);
    Global::info(strfmt("%1 is the output from the input of 64 as an int object", myReal));
    a = NoYes::Yes;
    myReal = any2Real(a);
    Global::info(strfmt("%1 is the output from the input of NoYes::Yes as an enum object", myReal));
}
/****Infolog display.
Message (02:43:57 pm)
5.12 is the output from the input of 5.12 as a str object
64.00 is the output from the input of 64 as an int object
1.00 is the output from the input of NoYes::Yes as an enum object
****/

any2Str

Bármely típusú értéket str értékké alakít át.

str any2Str(anytype object)

Paraméterek

Paraméter	Leírás
objektum	Az átalakítandó érték.

Visszaadott érték

Str érték.

Megjegyzések

Az objektumparaméter lehet a legtöbb adattípus, de hasznos kimenetet kaphat a dátum- ésa számtípus bemeneti elemeiből.

Példa

static void any2StrExample(Args _args)
{
    str myStr;
    anytype a;
    a = "Any to string";
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of Any to string as a str value", myStr));
    a = NoYes::Yes;
    myStr = any2Str(a);
    Global::info(strFmt("%1 is output, from input of NoYes::Yes as an enumeration", myStr));
}
/****Infolog Display
Message (09:08:46 am)
Any to string is output, from input of Any to string as a str value
1 is output, from input of NoYes::Yes as an enumeration
****/

anytodate

Lásd : any2Date.

anytoenum

Lásd : any2Enum.

anytoguid

Lásd : any2Guid.

anytoint

Lásd : any2Int.

anytoint64

Lásd : any2Int64.

bármelytoreal

Lásd : any2Real.

anytostr

Lásd : any2Str.

char2Num

Egy sztringben lévő karaktert a karakter ASCII-értékére konvertál.

int char2Num(str text, int position)

Paraméterek

Paraméter	Leírás
SMS	A karaktert tartalmazó sztring.
pozíció	A karakter pozíciója a sztringben.

Visszaadott érték

A karakter ASCII-értéke int objektumként.

Megjegyzések

char2Num("ABCDEFG",3); //Returns the numeric value of C, which is 67.
char2Num("ABCDEFG",1); //Returns the numeric value of A, which is 65.

date2Num

A dátumot egész számmá alakítja, amely az 1900. január 1-jei napok számának felel meg.

int date2Num(date _date)

Paraméterek

Paraméter	Leírás
_dátum	Az átalakítandó dátum.

Visszaadott érték

Az 1900. január 1. és a megadott dátum közötti napok száma.

Példa

//Returns the value377.
date2Num(1311901);
static void date2NumExample(Args _arg)
{
    date d = today();
    int i;
    i = date2Num(d);
    print i;
}

date2Str

A megadott dátumot sztringgé alakítja.

str date2Str(date date, int sequence, int day, int separator1, int month, int separator2, int year [, int flags = DateFlags::None])

Paraméterek

Paraméter	Leírás
date	Az átalakítandó dátum.
szekvencia	Háromjegyű szám, amely a dátum összetevőinek sorrendjét jelzi: 1 a naphoz, 2 a hónaphoz és 3 az évhez.
day	Enumerálási érték, amely a dátum nap összetevőjének formátumát jelzi.
elválasztó1	Enumerálási érték, amely azt jelzi, hogy a dátum első két összetevője között használandó elválasztó.
month	Enumerálási érték, amely a dátum hónap összetevőjének formátumát jelzi.
elválasztó 2	Enumerálási érték, amely azt jelzi, hogy az elválasztó a dátum utolsó két összetevője között használható.
év	Enumerálási érték, amely a dátum év összetevőjének formátumát jelzi.
flags	DateFlags enumerálási érték, amely azt jelzi, hogy a helyi számítógépen a nyelvi beállításokat kell-e használni a megfelelő balról jobbra vagy jobbról balra sorozat kiszámításához a visszaadott sztringben.

Visszaadott érték

A megadott dátumot jelképező sztring.

Megjegyzések

A MorphX érvényes értékeket rendel a formázási paraméterekhez, ha a megadott értékek érvénytelenek. A felhasználó által a Területi beállításokban megadott dátumformátum használatához használja az strFmt vagy date2Str függvényt, és adja meg a -1 értéket az összes formázási paraméterben. Amikor a területi beállítások szabályozzák a dátumformátumot, a beállítások felhasználóról felhasználóra változhatnak. Ha a -1 értéket használja bármelyik elválasztó paraméterhez, akkor mindkét elválasztó alapértelmezés szerint a területi beállításokat használja. A szekvenciaparaméter értékeinek minden olyan háromjegyű számnak kell lenniük, amely az 1, 2 és 3 számjegyek pontosan egy előfordulását tartalmazza. Az 1, 2 és 3 számjegyek a napot, a hónapot és az évet jelölik. A 321 például az év, a hónap és a nap sorrendjét állítja elő. Vagy az érték -1 lehet a területi beállítások használatához. Ne használjon enumerálási típust ehhez a paraméterhez, mert az olyan számok, mint a 321, túllépik a 0 és 250 közötti számértékek érvényes értékeinek tartományát. A jelölőparaméter alapértelmezett értéke a DateFlags::None enumeration value, ami azt jelenti, hogy nincs balról jobbra vagy jobbról balra sorozatfeldolgozás.

Példa

Az alábbi példa az aktuális dátumot jeleníti meg az év, a hónap és a nap sorrendjében.

static void Job2(Args _args)
{
    date currentDate = today();
    str s;
    int iEnum;
    s = date2Str
    (currentDate, 
        321,
        DateDay::Digits2,
        DateSeparator::Hyphen, // separator1
        DateMonth::Digits2,
        DateSeparator::Hyphen, // separator2
        DateYear::Digits4
    );
    info("Today is:  " + s);
}
/** Example Infolog output
Message (12:36:21 pm)
Today is:  2009-01-13
**/

datetime2Str

Az utcdatetime értéket sztringgé alakítja.

str datetime2Str(utcdatetime datetime [, int flags = DateFlags::None])

Paraméterek

Paraméter	Leírás
datetime	Az átalakítandó utcdatetime érték.
flags	DateFlags enumerálási érték, amely jelzi, hogy a helyi beállításokat a jobbról balra kimenethez kell-e használni.

Visszaadott érték

Egy sztring, amely a datetime paraméterként megadott utcdatetime értéket jelöli.

Megjegyzések

Null dátum-idő bemenet

Ha megadja a datetime paraméter minimális utcdatetime értékét, a datetime2Str függvény null bemeneti értékként kezeli. Ez az érték azt eredményezi, hogy a függvény üres sztringet ad vissza. A DateTimeUtil::minValue metódus az 1900-01-01T00:00:00 dátumidőt adja vissza. A függvény ezt a minimális értéket null értékként kezeli.

Helyi beállítások jobbról balra

Ez a függvény alapértelmezés szerint balról jobbra sorozatban hozza létre a sztringet, ahol az év része a bal szélső. Ha azonban a jelölőparaméterta DateFlags::FormatAll enumerálási értékre állítja, a függvény a sztringet jobbról balra sorrendben hozza létre, amikor a helyi beállítások a jobbról balra vannak konfigurálva. A területi beállítások nem befolyásolják a DateTimeUtil osztály toStr metódusának formátumát.

Példa

static void jobTestDatetime2str( Args _args )
{
    utcdatetime utc2 = 1959-06-17T15:44:33;
    str s3;
    s3 = datetime2Str( utc2 );
    info( s3 );
}

enum2Str

A megadott számbavételi szöveget karakterábrázolássá alakítja át.

str enum2Str(enum enum)

Paraméterek

Paraméter	Leírás
felsorolás	A konvertálandó enumerált szöveg.

Visszaadott érték

Az enumerálás értéke sztringként.

Példa

Az alábbi példa a "Nem szerepel" sztringet adja vissza. Ez a sztring a ListCode enumerálási típus IncludeNot értékének címkéje.

static void enum2StrExample(Args _arg)
{
    ListCode l;
    l =  ListCode::IncludeNot;
    print enum2Str(l);
}

guid2Str

A megadott GUID-objektumot a megfelelő sztringgé alakítja át.

str guid2String(guid _uuid)

Paraméterek

Paraméter	Leírás
_uuid	Az átalakítandó GUID-objektum.

Visszaadott érték

A megadott GUID-objektum karakterlánc-megfelelője.

Példa

static void guid2StrExample()
{
    guid _guid;
    str stringGuid;
    _guid = Global::guidFromString("{12345678-1234-1234-1234-123456789abc}");
    print strfmt("GUID is %1", _guid);
    stringGuid = guid2str(_guid);
    info("String GUID is " + stringGuid);
}
/**** Output to Infolog
String GUID is {12345678-1234-1234-1234-123456789ABC}
****/

int2Str

Egész szám konvertálása ezzel egyenértékű sztringgé.

str int2Str(int integer)

Paraméterek

Paraméter	Leírás
egész szám	Az átalakítandó egész szám.

Visszaadott érték

Az egész szám sztring-ábrázolása.

Példa

static void int2StrExample(Args _arg)
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

int642Str

A megadott egész szám paramétert a megfelelő szöveges sztringgé alakítja.

str int642Str(int64 integer)

Paraméterek

Paraméter	Leírás
egész szám	A sztringgé alakítandó int64.

Visszaadott érték

Az egész szám paraméter megfelelő szöveges sztringje.

Példa

static void example()
{
    print "This is int2Str, value is " + int2Str(intMax());
    print "This is int642Str, value is " + int642Str(int64Max());
}

num2Char

Egész szám konvertálása a megfelelő ASCII-karakterre.

str num2Char(int figure)

Paraméterek

Paraméter	Leírás
szám	A karaktergé alakítandó egész szám.

Visszaadott érték

A megadott egész számnak megfelelő karakter.

Példa

static void num2CharExample(Args _arg)
{
    str s;
    s = num2Char(42);
    // Prints an asterisk * -the character represented by 42.
    print s;
}

num2Date

Lekéri az 1900. január 1-jei dátumnak megfelelő dátumot.

date num2Date(int _days)

Paraméterek

Paraméter	Leírás
_Napok	Az 1900. január 1-ét követő napok száma a dátum visszaadásához. Jegyzet: Az első érvényes dátum 1901. január 1. Ezért a num2Date függvény csak akkor ad vissza érvényes dátumot, ha _daysnagyobb, mint 365.

Visszaadott érték

A _days paraméter által 1900. január 1. után megadott napok száma.

Megjegyzések

num2Date(366); //Returns the date 01/01/1901 (1 January 1901).

num2Str

Valós számot sztringgé alakít át.

str num2Str(real number, int character, int decimals, int separator1, int separator2)

Paraméterek

Paraméter	Leírás
Szám	A sztringgé konvertálandó valós szám.
karakter	A szövegben kötelező karakterek minimális száma.
Tizedesjegyek	A tizedesjegyek szükséges száma.
elválasztó1	DecimalSeparator enumerálási érték.
elválasztó 2	Ez az Ezreseparator enumerálási értéke.

Visszaadott érték

A számot jelképező sztring.

Megjegyzések

A decimális paraméter esetében a maximális érték 16. Ha nagyobb számot használ, a metódus ehelyett a helyi számítógépről szerzi be a decimális paraméter értékét. Mindkét esetben kerekítés történik. Az elválasztó1 paraméter lehetséges enumerálási értékei a következők:

• 99 – Automatikus (a felhasználó formázási beállításai határozzák meg, hogy milyen tizedeselválasztót használ), számbavételi érték DecimalSeparator::Auto
• 1 – Pont (.), számbavételi érték DecimalSeparator::D ot
• 2 – Vessző (,), számbavételi érték DecimalSeparator::Vessző

Az elválasztó2 paraméter lehetséges értékei a következők:

• 99 – Automatikus (a felhasználó formázási beállításai határozzák meg, hogy milyen ezer elválasztót használ)
• 0 – Nincs (nincs ezer elválasztó), enumerálási érték Ezredérték::Nincs
• 1 – Pont (.), enumerálási érték ThousandSeparator::D ot
• 2 – Vessző (,), enumerálási érték ThousandSeparator::Vessző
• 3 – Aposztróf ('), enumerálási érték ThousandSeparator::Apostrophe
• 4 – Szóköz ( ), enumerálási érték Ezredérték::Szóköz

Példa

A következő kód példában a num2str metódus első hívása 16-ot biztosít a tizedesjel paraméterhez , a második hívás pedig 17-et.

static void Job_Num2Str(Args _args)
{
    real realNum = 0.1294567890123456777; // 19 decimals places.
    info(Num2Str(realNum, 0, 16, DecimalSeparator::Dot, ThousandSeparator::Space)); // 16 decimal places
    info(Num2Str(realNum, 0, 17, DecimalSeparator::Dot, ThousandSeparator::Space)); // 17 decimal places
}

Output

Az üzenetek az alábbi Infolog-kimenetben találhatók. A kimenet első száma 16 tizedesjegyet tartalmaz, míg a második szám csak két tizedesjegyet tartalmaz.

Message (10:18:12)
0.1294567890123457
0.13

str2Date

A megadott sztringet dátumértékké alakítja.

date str2Date(str _text, str _sequence)

Paraméterek

Paraméter	Leírás
_SMS	A dátumértékké konvertálandó sztring.
_következés	Háromjegyű egész szám, amely az átalakítandó sztringben a nap, a hónap és az év pozícióját írja le.

Visszaadott érték

Dátumérték.

Megjegyzések

A következő értékekkel adhatja meg a nap, hónap és év pozícióit a _sequence paraméterben:

• Nap: 1
• Hónap: 2
• Év: 3

Ha például a sztringben a sorrend hónap, év, majd nap, akkor a _sequence paraméternek 231-nek kell lennie. A rendszer 0 (nulla) dátumot ad vissza, ha a bemeneti paraméterek érvénytelen dátumot adnak meg. Az alábbi két példa érvénytelen dátumot ad meg.

str2Date("31/12/44", 123) // Year must be four digits to reach the minimum of January 1 1901.
str2Date("31/12/2044", 213) // 213 means the month occurs first in the string, but 31 cannot be a month.

Példa

static void str2DateExample(Args _arg)
{
    date d;
    d = str2Date("22/11/2007", 123);
    print d;
}

str2Datetime

Utcdatetime értéket hoz létre a megadott dátum- és időinformációs sztringből.

utcdatetime str2datetime( str text, int sequence )

Paraméterek

Paraméter	Leírás
SMS	Az utcdatetime értékké konvertálandó sztring.
szekvencia	A szövegparaméter dátumösszetevőinek sorrendjét leíró háromjegyű szám.

Visszaadott érték

Egy utcdatetime érték, amely a megadott dátumot és időt jelöli.

Megjegyzések

A szöveges paraméter dátum részének szintaxiskövetelményei rugalmasak. Az érvényes formátumok sokfélesége megegyezik a date2str függvényével. Az str2datetime felé irányuló alábbi hívások mindegyike érvényes, és mindegyik ugyanazt a kimenetet eredményezi.

utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
utc3 = str2datetime( "Feb-1985-25 11:04:59 pm" ,231 );
utc3 = str2datetime( "2 25 1985 11:04:59 pm" ,123 );

A dátumidő minden összetevőjét egy számjegy jelöli a sorrendi paraméterben:

• 1 – Nap
• 2 – Hónap
• 3 – Év

Például az év, a hónap és a nap sorrendje 321. Az összes érvényes érték pontosan egy-egy számjegyet tartalmaz. Ha a szekvenciaparaméter értéke nem érvényes, a rendszer a területi beállításokat használja a bemeneti szöveges paraméter értelmezéséhez. Ha a bemeneti paraméterek érvénytelen dátumot és időt írnak le, a rendszer üres sztringet ad vissza.

Példa

static void JobTestStr2datetime( Args _args )
{
    utcdatetime utc3;
    str sTemp;
    utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
    sTemp = datetime2str( utc3 );
    print( "sTemp == " + sTemp );
}

str2Enum

Lekéri azt az enumerálási elemet, amelynek honosított címketulajdonság-értéke megegyezik a bemeneti sztringgel.

enum str2Enum(enum _type, str _text)

Paraméterek

Paraméter	Leírás
_típus	Egy számtípusként deklarált változó.
_SMS	Az enumerálás célelemének honosított Címke tulajdonságszövege.

Visszaadott érték

A célszám egy eleme, amely egy intet is jelöl.

Megjegyzések

A kapcsolódó enum2str függvény egy Címke tulajdonság értékét adja vissza az enumerálás egyik eleméből. Az enum2str függvény által visszaadott érték lehet az str2enum függvény _type paraméterének bemenete. A _text paraméter megfelelő értéke az enum2Str(BankAccountType::SavingsAccount). Az enum minden eleme rendelkezik névtulajdonságokkal és címketulajdonságokkal . Egy friss telepítésben a Név értékek szinte mindig angol szavak. Az angol kiadásban a Label tulajdonság értéke szinte mindig megegyezik a Név értékkel. A nem angol nyelvű kiadásokban azonban a Címke értékek honosítva vannak, ezért nem egyeznek a Név értékekkel.

Példa

A más beszélt nyelvekhez való honosítás során előforduló sztringeltérések elkerülése érdekében az enum2str függvénnyel hozza létre a bemenetet az str2enum függvénybe. Az alábbi példa az str2enum függvény és az enum2str függvény együttes használatát mutatja be.

static void str2Enum_AcrossLangs(Args _arg)
{
    BankAccountType bat;
    str sEnumValueLabelLocalized;
    int nInt;
    // enum2str.
    sEnumValueLabelLocalized = enum2str(BankAccountType::SavingsAccount);
    info("Localized friendly string: "
        + sEnumValueLabelLocalized);
    // str2enum.
    bat = str2Enum(bat, sEnumValueLabelLocalized);
    nInt = bat;
    info("nInt = " + int2str(nInt));
    /********** Actual output:
    Message (04:32:12 pm)
    Localized friendly string: Savings account
    nInt = 1
    **********/
}

str2Guid

Egy sztringet GUID-objektummá alakít át.

Guid str2Guid(str text)

Paraméterek

Paraméter	Leírás
guid	Guid azonosítót jelképező sztring.

Visszaadott érték

A bemeneti sztring által képviselt GUID.

Megjegyzések

A guid paraméter érvényes értéke például {12345678-1234-abCD-3456-123456789012}, kapcsos zárójelekkel vagy anélkül.

str2Int

Egy sztringet ezzel egyenértékű egész számmá alakít át.

int str2Int(str _text)

Paraméterek

Paraméter	Leírás
_SMS	Az egész számmá konvertálandó sztring.

Visszaadott érték

A megadott sztring egész számának megfelelője.

Példa

static void str2IntExample(Args _arg)
{
    int i;
    i = str2Int("1234567890");
    print "i = " + int2Str(i);
}

str2Int64

Egy sztringet Int64-értékké alakít át.

int str2Int64(str text)

Paraméterek

Paraméter	Leírás
SMS	Az átalakítandó sztring.

Visszaadott érték

A megadott sztring Int64 értéke.

Példa

static void str2Int64Example(Args _args)
{
    str myStr;
    str tooBig;
    Int64 myInt64;
    myStr = "1234567890";
    tooBig = int642str(int64Max()+1);
    myInt64 = str2Int64(mystr);
    print strfmt ("int64: %1",myInt64);
    myInt64 = str2Int64(tooBig);
    print strfmt ("Too big int64: %1",myInt64);
}

str2Num

Egy sztringet valós számmá alakít át.

real str2Num(str _text)

Paraméterek

Paraméter	Leírás
_SMS	A valós számmá konvertálandó sztring.

Visszaadott érték

A valós szám, ha a megadott sztring érvényes számot tartalmaz; ellenkező esetben 0 (nulla).

Megjegyzések

Az alábbi példák bemutatják a függvény használatát.

str2Num("123.45") returns the value 123.45.
str2Num("a123") returns the value 0.0.
str2Num("123a") returns the value 123.00.

A vizsgálat balról jobbra történik, és akkor fejeződik be, ha egy karakter nem konvertálható valós szám részévé.

Példa

static void str2NumToReal(Args _arg)
{
    real r;
    str s;
    r = str2Num("3.15");
    s = strFmt("r = %1", r);
    info(s);
}
/*** Infolog output.
Message_@SYS14327 (02:36:12 pm)
r = 3.15
***/

static void str2NumExponentialSyntax(Args _args)
{
    Qty qty1, qty2, qty3;
    qty1 = str2num('1e-3'); // Bad syntax by the user.
    qty2 = str2num('1.e-3');
    qty3 = str2num('1.0e-3');
    info(strfmt('Result: %1; Expected: %2', num2str(qty1, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty2, 0,3,2,0), '0.001'));
    info(strfmt('Result: %1; Expected: %2', num2str(qty3, 0,3,2,0), '0.001'));
}
/*** Infolog output. The first result differs from expectations.
Message_@SYS14327 (02:20:55 pm)
Result: 1,000; Expected: 0.001
Result: 0,001; Expected: 0.001
Result: 0,001; Expected: 0.001
***/

str2Time

Egy sztringet időOfDay értékké alakít át.

int str2Time(str _text)

Paraméterek

Paraméter	Leírás
_SMS	Az éjfél óta eltelt másodpercek számának kiszámításához használt idő.

Visszaadott érték

Az éjfél és a _text paraméter közötti másodpercek száma; ellenkező esetben -1.

Megjegyzések

str2Time("05:01:37") //Returns the value 18097.
str2Time("7 o'clock") //Returns the value -1.

Példa

static void str2TimeExample(Args _arg)
{
    int i;
    i = str2Time("11:30");
    print i;
}

time2Str

A timeOfDay értéket órákat, perceket és másodperceket tartalmazó sztringgé alakítja.

str time2Str(int _time, int _separator, int _timeFormat)

Paraméterek

Paraméter	Leírás
_Idő	TimeOfDay érték.
_elválasztó	TimeSeparator enumerálási érték, amely a kimeneti sztringben szereplő órák, percek és másodpercek közötti karaktereket jelzi.
_timeFormat	TimeFormat enumerálási érték, amely azt jelzi, hogy 12 órás vagy 24 órás óra van-e használatban.

Visszaadott érték

Egy sztring, amely a megadott időt jelöli.

Megjegyzések

A _time paraméter értéke az éjfél óta eltelt másodpercek száma.

Példa

static void TimeJob4(Args _args)
{
    timeOfDay theTime = timeNow();
    info( time2Str(theTime, TimeSeparator::Colon, TimeFormat::AMPM) );
}
/**
Message (04:33:56 pm)
04:33:56 pm
**/

uint2Str

Egész számot sztringgé alakít át. Ez a függvény feltételezi, hogy az egész szám nincs aláírva.

str uint2Str(int integer)

Paraméterek

Paraméter	Leírás
egész szám	Az átalakítandó egész szám.

Visszaadott érték

A megadott aláíratlan egész szám karakterlánc-megfelelője.

Megjegyzések

Ezt a függvényt használja az int2str függvény helyett nagyon nagy egész számokhoz, például rekordazonosítókhoz.

info(int2str(3123456789)); //returns -1171510507 as a string.
info(uint2str(3123456789)); //returns 3123456789 as a string.