Umreikniskeyrslutímaföll í X++

Athugasemd

Samfélagsáhugahópar hafa nú flust frá Yammer yfir í Microsoft Viva Engage. Til að ganga í Viva Engage samfélag og taka þátt í nýjustu umræðunum, fylltu út eyðublaðið Request access to Finance and Operations Viva Engage Community og veldu það samfélag sem þú vilt ganga í.

Þessi grein lýsir umbreytingarkeyrsluföllunum.

any2Date

Breytir anytype gildi í dagsetningargildi .

date any2Date(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að breyta í dagsetningu.

Skilagildi

Dagsetning gildi.

Athugasemdir

Hlutabreytan getur verið flestar gagnategundir, en þú færð gagnlegt úttak þegar það er af str eða int gerð. Óviðeigandi efni veldur keyrsluvillu.

Dæmi

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

Umbreytir anytype gildi í Name eiginleikagildi einingar í markupptölu.

enum any2Enum(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að passa við Value eiginleika einingar í markmálinu.

Skilagildi

Gildi eiginleikans Name fyrir hvaða einingu í markeiningunni hefur Value eiginleika sem passar við inntaksfæribreytuna.

Athugasemdir

Hlutabreytan getur verið flestar gagnategundir, en þú færð gagnleg gögn aðeins þegar þú notar breytu af str- eða int tegundinni. Þessi inntakshlutbreytu vísar til Value eiginleika einstaks þáttar í markupptölunni.

Dæmi

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

Breytir tilgreindum anytype-hlut í GUID-hlut.

guid any2Guid(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að breyta í GUID-hlut.

Skilagildi

GUID-hlutur.

any2Int

Breytir anytype gildi í int gildi.

int any2Int(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að umbreyta.

Skilagildi

Int gildi.

Athugasemdir

Hlutabreytan getur verið flestar gagnategundir, en þú færð gagnleg gögn aðeins þegar þú notar breytur af enum, real eða str gerðinni.

Dæmi

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

Breytir anytype hlut í int64 hlut.

int64 any2Int64(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Anytype hluturinn sem á að umbreyta.

Skilagildi

Int64 hlutur.

any2Real

Breytir anytype gildi í raunverulegt gildi.

real any2Real(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að umbreyta.

Skilagildi

Raunverulegt gildi.

Athugasemdir

Hlutabreytan getur verið flestar gagnategundir, en þú færð gagnlegar útkomur fyrir inntaksþætti af dagsetningu, innsæi, enum og str gerðum.

Dæmi

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

Breytir anytype gildi í str gildi.

str any2Str(anytype object)

Færibreytur

Færibreyta	Lýsing
hlutur	Gildið sem á að umbreyta.

Skilagildi

Str gildi.

Athugasemdir

Hlutabreytan getur verið flestar gagnategundir, en þú færð gagnlegt úttak frá inntaksþáttum af dagsetningu, inn- og enum-gerðum.

Dæmi

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

Sjá any2Date.

anytoenum

Sjá any2Enum.

anytoguid

Sjá any2Guid.

anytoint

Sjá any2Int.

anytoint64

Sjá any2Int64.

anytoreal

Sjá any2Real.

anytostr

Sjá any2Str.

char2Num

Breytir staf í streng í ASCII gildi stafsins.

int char2Num(str text, int position)

Færibreytur

Færibreyta	Lýsing
senda textaskilaboð	Strengurinn sem inniheldur stafinn.
staða	Staða persónunnar í strengnum.

Skilagildi

ASCII gildi stafsins sem int hlutur.

Athugasemdir

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

Breytir dagsetningu í heiltölu sem samsvarar dagafjölda frá 1. janúar 1900.

int date2Num(date _date)

Færibreytur

Færibreyta	Lýsing
_dagsetning	Dagsetningin sem á að umbreyta.

Skilagildi

Fjöldi daga milli 1. janúar 1900 og tilgreindrar dagsetningar.

Dæmi

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

date2Str

Breytir tilgreindri dagsetningu í streng.

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

Færibreytur

Færibreyta	Lýsing
dagsetning	Dagsetningin sem á að umbreyta.
röð	Þriggja stafa tala sem sýnir röð fyrir íhluti dagsetningarinnar: 1 fyrir dag, 2 fyrir mánuð og 3 fyrir ár.
dagur	Upptalningargildi sem tilgreinir snið fyrir daghluta dagsetningarinnar.
aðskilnaður1	Upptalningargildi sem gefur til kynna skiltáknið sem á að nota á milli fyrstu tveggja þátta dagsetningarinnar.
mánuður	Upptalningargildi sem tilgreinir snið fyrir mánaðarþátt dagsetningarinnar.
aðskilnaður2	Talningargildi sem gefur til kynna skiltáknið sem á að nota á milli síðustu tveggja þátta dagsetningarinnar.
ár	Talningargildi sem tilgreinir snið fyrir ársþátt dagsetningarinnar.
Flaggskip	DateFlags upptalningargildi sem tilgreinir hvort nota eigi tungumálastillingar staðbundinnar tölvu til að reikna út rétta röð frá vinstri til hægri eða hægri til vinstri í strengnum sem skilað er.

Skilagildi

Strengur sem táknar tilgreinda dagsetningu.

Athugasemdir

MorphX úthlutar gildum gildum á sniðfæribreytur ef tilgreind gildi eru ekki gild. Til að nota dagsetningarsniðið sem notandinn tilgreindi í Svæðisbundnar stillingar skal nota aðgerðina strFmt eða date2Str og tilgreina -1 í öllum sniðfæribreytum. Þegar svæðisbundnar stillingar stjórna dagsetningarsniðinu geta stillingarnar breyst frá notanda til notanda. Ef -1 er notað fyrir aðra hvora skiltáknabreytuna eru bæði skiltáknin sjálfgefin í Svæðisstillingar. Raðbreytugildin verða að vera hvaða þriggja stafa tala sem inniheldur nákvæmlega eitt tilvik af hverju tölustafi 1, 2 og 3. Tölustafirnir 1, 2 og 3 tákna dag, mánuð og ár, í sömu röð. Til dæmis framleiðir 321 röðina ár, mánuður og dagur. Eða gildið getur verið -1 til að nota svæðisbundnar stillingar. Ekki nota upptalningargerð fyrir þennan breytu, því tölur eins og 321 fara yfir gild gildi fyrir talningargildin, sem er 0 til 250, meðtalið. Sjálfgefið gildi flags færibreytunnar er DateFlags::None upptalningargildið, sem þýðir að engin vinnsla er gerð frá vinstri til hægri eða hægri til vinstri.

Dæmi

Eftirfarandi dæmi sýnir núverandi dagsetningu í röð árs, mánaðar og dags.

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

Breytir utcdatetime gildi í streng.

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

Færibreytur

Færibreyta	Lýsing
datetime	Utcdatetime gildið sem á að umbreyta.
Flaggskip	DateFlags upptalningargildi sem gefur til kynna hvort eigi að nota staðbundnar stillingar fyrir úttak frá hægri til vinstri.

Skilagildi

Strengur sem táknar utcdatetime-gildið sem þú tilgreinir sem datetime-breytu .

Athugasemdir

Núll inntak dagsetningar-tíma

Ef þú tilgreinir lágmarks utcdatetime gildi fyrir datetime breytuna, meðhöndlar datetime2Str fallið það sem null inntaksgildi. Þetta gildi veldur því að fallið skilar tómum streng. DateTimeUtil::minValue aðferðin skilar dagsetningunni 1900-01-01T00:00:00. Fallið meðhöndlar þetta lágmarksgildi sem null.

Staðbundnar stillingar frá hægri til vinstri

Sjálfgefið býr þetta fall til strenginn í vinstri-til-hægri röð, þar sem árhlutinn er vinstra megin. Hins vegar, ef þú stillir flags-breytuna á DateFlags::FormatAll , þá býr fallið til strenginn í hægri til vinstri röð þegar staðbundnar stillingar eru stilltar fyrir hægri til vinstri. Svæðisbundnar stillingar hafa ekki áhrif á uppsetningu toStr aðferðarinnar í DateTimeUtil klasanum.

Dæmi

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

enum2Str

Breytir tilgreindum upptalnum texta í stafaframsetningu.

str enum2Str(enum enum)

Færibreytur

Færibreyta	Lýsing
fasttexti	Upptalinn texti sem á að umbreyta.

Skilagildi

Gildi upptalningarinnar sem strengur.

Dæmi

Eftirfarandi dæmi skilar strengnum "Ekki innifalið." Þessi strengur er merkið fyrir IncludeNot-gildið í ListCode upptalningartegundinni.

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

guid2Str

Umbreytir tilgreindum GUID-hlut í samsvarandi streng.

str guid2String(guid _uuid)

Færibreytur

Færibreyta	Lýsing
_uuid	GUID-hluturinn til að umbreyta.

Skilagildi

Strengjajafngildi tilgreinds GUID-hlutar.

Dæmi

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

Breytir heiltölu í samsvarandi streng.

str int2Str(int integer)

Færibreytur

Færibreyta	Lýsing
heiltala	Heiltalan sem á að umbreyta.

Skilagildi

Strengjaframsetning heiltölunnar.

Dæmi

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

int642Str

Breytir tilgreindri heiltölufæribreytu í samsvarandi textastreng.

str int642Str(int64 integer)

Færibreytur

Færibreyta	Lýsing
heiltala	Int64 til að breyta í streng.

Skilagildi

Samsvarandi textastrengur heiltölufæribreytunnar .

Dæmi

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

num2Char

Umbreytir heiltölu í samsvarandi ASCII-staf.

str num2Char(int figure)

Færibreytur

Færibreyta	Lýsing
tala	Heiltalan til að breyta í staf.

Skilagildi

Stafurinn sem samsvarar tilteknu heiltölunni.

Dæmi

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

num2Date

Sækir dagsetninguna sem samsvarar tilgreindum fjölda daga eftir 1. janúar 1900.

date num2Date(int _days)

Færibreytur

Færibreyta	Lýsing
_Daga	Fjöldi daga eftir 1. janúar 1900 til að skila dagsetningunni fyrir. Nóta: Fyrsta gilda dagsetningin er 1. janúar 1901. Þess vegna skilar num2Date aðgerðin ekki gildri dagsetningu nema _days sé meira en 365.

Skilagildi

Dagsetningin sem er fjöldi daga sem _days breytan skilgreinir eftir 1. janúar 1900.

Athugasemdir

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

num2Str

Breytir rauntölu í streng.

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

Færibreytur

Færibreyta	Lýsing
númer	Raunveruleg tala sem á að breyta í streng.
stafur	Lágmarksfjöldi stafa sem krafist er í textanum.
Aukastöfum	Nauðsynlegur fjöldi aukastafa.
aðskilnaður1	Upptalningargildi DecimalSeparator.
aðskilnaður2	Tölugildi þúsundandSeparator.

Skilagildi

Strengur sem táknar töluna.

Athugasemdir

Fyrir aukastafabreytuna er hámarksgildið 16. Ef þú notar stærri tölu fær aðferðin gildi fyrir aukastafastikuna frá staðbundnu tölvunni í staðinn. Í báðum tilfellum á sér stað námundun. Hér eru möguleg talningargildi fyrir skiltákn1 færibreytuna:

• 99 – Auto (sniðstillingar notandans ákvarða hvaða aukastafaskiltákn er notað), upptalningargildi DecimalSeparator::Auto
• 1 – Punktur (.), upptalningargildi DecimalSeparator::D ot
• 2 – Komma (,), upptalningargildi DecimalSeparator::Comma

Hér eru möguleg gildi fyrir skilleor2 færibreytuna:

• 99 – Auto (sniðstillingar notandans ákvarða hvaða þúsund skiltákn er notað)
• 0 – Ekkert (engin þúsund skiltákn), talningargildi ThousandSeparator::None
• 1 – Punktur (.), upptalningargildi þúsundandSeparator::D ot
• 2 – Komma (,), upptalningargildi ThousandSeparator::Comma
• 3 – Fráhvarf ('), upptalningargildi þúsundandSeparator::Frávik
• 4 – Bil ( ), upptalningargildi ThousandSeparator::Space

Dæmi

Í eftirfarandi kóðadæmi gefur fyrsta kallið í num2str aðferðina 16 fyrir aukastafabreytuna og annað kallið gefur 17.

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
}

Úttak

Skilaboðin eru í eftirfarandi úttaki upplýsingaskrár. Fyrsta talan í úttakinu inniheldur 16 aukastafi en önnur talan inniheldur aðeins tvo aukastafi.

Message (10:18:12)
0.1294567890123457
0.13

str2Date

Breytir tilgreindum streng í dagsetningargildi .

date str2Date(str _text, str _sequence)

Færibreytur

Færibreyta	Lýsing
_Texti	Strengurinn sem á að breyta í dagsetningargildi .
_röð	Þriggja stafa heiltala sem lýsir stöðu dags, mánaðar og árs í strengnum sem á að umbreyta.

Skilagildi

Dagsetning gildi.

Athugasemdir

Notið eftirfarandi gildi til að tilgreina stöður dags, mánaðar og árs í færibreytunni _sequence :

• Dag: 1
• Mánuður: 2
• Útgáfuár: 3

Til dæmis, ef röðin í strengnum er mánuður, ár og síðan dagur, verður færibreytan _sequence að vera 231. 0 (núll) dagsetningu er skilað ef inntaksfæribreyturnar tilgreina ógilda dagsetningu. Eftirfarandi tvö dæmi tilgreina ógilda dagsetningu.

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.

Dæmi

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

str2Datetime

Býr til utcdatetime gildi úr tilgreindum streng með upplýsingum um dagsetningu og tíma.

utcdatetime str2datetime( str text, int sequence )

Færibreytur

Færibreyta	Lýsing
senda textaskilaboð	Strengurinn sem á að breyta í utcdatetime gildi.
röð	Þriggja stafa tala sem lýsir röð dagsetningarþátta í færibreytunni texti .

Skilagildi

Utcdatetime gildi sem táknar tilgreinda dagsetningu og tíma.

Athugasemdir

Setningafræðikröfur fyrir dagsetningarhluta textafæribreytunnar eru sveigjanlegar. Fjölbreytni gildra sniða er sú sama og í date2str fallinu. Hvert af eftirfarandi köllum á str2datetime er gilt og öll framleiða þau sömu úttak.

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 );

Hver hluti dagsetningartímans er táknaður með tölustaf í færibreytunni röð :

• 1 - Dagur
• 2 - Mánuður
• 3 - Ár

Til dæmis er ár, mánuður, dagur pöntun 321. Öll gild gildi innihalda hvern þessara þriggja tölustafa nákvæmlega einu sinni. Ef gildi færibreytunnar er ekki gilt eru svæðisstillingar notaðar til að túlka færibreytuna fyrir innsláttartexta . Ef inntaksfæribreyturnar lýsa ógildri dagsetningu og tíma er tómum streng skilað.

Dæmi

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

Sækir fastmyntareininguna þar sem staðfærða eiginleikagildið Label passar við inntaksstrenginn.

enum str2Enum(enum _type, str _text)

Færibreytur

Færibreyta	Lýsing
_gerð	Breyta sem þú tilgreinir sem enum-tegund .
_Texti	Staðfærður Label eiginleikatexti markeiningarinnar í fasttextanum.

Skilagildi

Þáttur í markupptalinu, sem einnig táknar int.

Athugasemdir

Tengda fallið enum2str skilar gildi Label eiginleika úr einni einingu í fastmyntinni. Gildið sem enum2str-fallið skilar getur verið inntak fyrir _type stiku str2enum-fallsins . Viðeigandi gildi fyrir _text færibreytuna er enum2Str(BankAccountType::SavingsAccount). Hver eining nafngreinar hefur eiginleikann Name og Label eiginleikann. Í nýrri uppsetningu eru nafngildin næstum alltaf ensk orð. Í ensku útgáfunni er Label eiginleikagildið næstum alltaf það sama og Name gildið. Hins vegar, í útgáfum sem ekki eru á ensku, eru Label gildin staðfærð og passa því ekki við Name gildin.

Dæmi

Til að forðast strengjamisræmi sem staðfæring í önnur töluð tungumál veldur, notaðu enum2str-fallið til að búa til inntakið í str2enum-fallið . Eftirfarandi dæmi sýnir viðeigandi leið til að nota str2enum aðgerðina ásamt enum2str fallinu.

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

Breytir streng í GUID-hlut.

Guid str2Guid(str text)

Færibreytur

Færibreyta	Lýsing
Guid	Strengur sem táknar GUID.

Skilagildi

GUID sem inntaksstrengurinn táknar.

Athugasemdir

Til dæmis er gilt gildi fyrir guid færibreytuna {12345678-1234-abCD-3456-123456789012}, annað hvort með eða án axlaböndanna.

str2Int

Breytir streng í samsvarandi heiltölu.

int str2Int(str _text)

Færibreytur

Færibreyta	Lýsing
_Texti	Strengurinn sem á að breyta í heiltölu.

Skilagildi

Heiltölujafngildi tilgreinds strengs.

Dæmi

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

str2Int64

Breytir streng í Int64 gildi.

int str2Int64(str text)

Færibreytur

Færibreyta	Lýsing
senda textaskilaboð	Strengurinn sem á að umbreyta.

Skilagildi

Int64 gildi tilgreinds strengs.

Dæmi

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

Breytir streng í rauntölu.

real str2Num(str _text)

Færibreytur

Færibreyta	Lýsing
_Texti	Strengurinn sem á að breyta í rauntölu.

Skilagildi

Rauntalan ef tilgreindur strengur inniheldur gilda tölu; annars 0 (núll).

Athugasemdir

Eftirfarandi dæmi sýna hvernig á að nota þetta fall.

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

Skönnun á sér stað frá vinstri til hægri og lýkur þegar ekki er hægt að breyta staf í hluta af rauntölu.

Dæmi

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

Umbreytir streng í timeOfDay gildi.

int str2Time(str _text)

Færibreytur

Færibreyta	Lýsing
_Texti	Tíminn sem á að nota til að reikna út fjölda sekúndna frá miðnætti.

Skilagildi

Fjöldi sekúndna milli miðnættis og _text færibreytunnar; annars, -1.

Athugasemdir

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

Dæmi

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

tími2Str

Umbreytir timeOfDay gildi í streng sem inniheldur klukkustundir, mínútur og sekúndur.

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

Færibreytur

Færibreyta	Lýsing
_tími	TimeOfDay gildi.
_Skiltákn	TimeSeparator upptalningargildi sem sýnir stafina á milli klukkustunda, mínútna og sekúndna í úttaksstrengnum.
_timeFormat	TimeFormat upptalningargildi sem gefur til kynna hvort 12 tíma klukka eða 24 tíma klukka er notuð.

Skilagildi

Strengur sem táknar tilgreindan tíma.

Athugasemdir

Gildi _time færibreytunnar er fjöldi sekúndna frá miðnætti.

Dæmi

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

Breytir heiltölu í streng. Þessi fall gerir ráð fyrir að heiltalan sé óundirrituð.

str uint2Str(int integer)

Færibreytur

Færibreyta	Lýsing
heiltala	Heiltalan sem á að umbreyta.

Skilagildi

Strengjajafngildi tiltekinnar óundirritaðrar heiltölu.

Athugasemdir

Notaðu þessa aðgerð í stað int2str aðgerðarinnar fyrir mjög stórar heiltölur, t.d. færslukenni.

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