X++ konversijas izpildlaika funkcijas

Piezīmes

Kopienas interešu grupas tagad ir pārvietotas no Yammer uz Microsoft Viva Engage. Lai pievienotos Viva Engage kopienai un piedalītos jaunākajās diskusijās, aizpildiet veidlapu Pieprasīt piekļuvi Finance and Operations Viva Engage Community un izvēlieties kopienu, kurai vēlaties pievienoties.

Šajā rakstā ir aprakstītas konvertēšanas izpildlaika funkcijas.

jebkurš2Datums

Pārvērš jebkura tipa vērtību par datuma vērtību.

date any2Date(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Vērtība, kas jāpārvērš par datumu.

Atgrieztā vērtība

Datuma vērtība.

Atzīmes

Objekta parametrs var būt lielākā daļa datu tipu, bet jūs saņemat noderīgu izvadi, ja tas ir str vai int tipa. Nepiemērots saturs rada izpildlaika kļūdu.

Piemērs

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

Pārvērš jebkura tipa vērtību par mērķa uzskaites elementa rekvizīta Nosaukums vērtību.

enum any2Enum(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Vērtība, kas atbilst mērķa uzskaites elementa rekvizītam Value .

Atgrieztā vērtība

Rekvizīta Name vērtībai jebkuram mērķa uzskaitījuma elementam ir rekvizīts Value , kas atbilst ievades parametram.

Atzīmes

Objekta parametrs var būt lielākā daļa datu tipu, bet jūs iegūstat noderīgus datus tikai tad, ja izmantojat str vai int tipa parametru. Šis ievades objekta parametrs attiecas uz atsevišķa mērķa uzskaites elementa rekvizītu Value .

Piemērs

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

Pārvērš norādīto anytype objektu par GUID objektu.

guid any2Guid(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Vērtība, kas jāpārvērš par GUID objektu.

Atgrieztā vērtība

GUID objekts.

any2Int

Pārvērš jebkura tipa vērtību par int vērtību.

int any2Int(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Konvertējamā vērtība.

Atgrieztā vērtība

int vērtība.

Atzīmes

Objekta parametrs var būt lielākā daļa datu tipu, bet noderīgus datus iegūst tikai tad, ja izmantojat enum, real vai str tipa parametrus.

Piemērs

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.
****/

jebkurš2Int64

Pārvērš jebkura tipa objektu par int64 objektu.

int64 any2Int64(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Konvertējamais jebkurš objekts.

Atgrieztā vērtība

int64 objekts.

any2Real

Pārvērš jebkura tipa vērtību par reālu vērtību.

real any2Real(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Konvertējamā vērtība.

Atgrieztā vērtība

Reāla vērtība.

Atzīmes

Objekta parametrs var būt lielākā daļa datu tipu, bet jūs saņemat noderīgu izvadi datuma, int, enum un str tipu ievades elementiem.

Piemērs

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

Pārvērš jebkura tipa vērtību par str vērtību.

str any2Str(anytype object)

Parametri

Parametrs	Apraksts
Objektu	Konvertējamā vērtība.

Atgrieztā vērtība

Str vērtība.

Atzīmes

Objekta parametrs var būt lielākā daļa datu tipu, bet jūs saņemat noderīgu izvadi no datuma, int un uzskaitījuma tipu ievades elementiem.

Piemērs

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
****/

jebkurš datums

Skatīt any2Date.

anytoenum

Skatīt jebkuru2Enum.

anytoguid

Skatīt any2Guid.

anytoint

Skatīt any2Int.

anytoint64

Skatīt any2Int64.

anytoreal

Skatīt any2Real.

Anytostr

Skatīt any2Str.

char2Num

Pārvērš rakstzīmi virknē par rakstzīmes ASCII vērtību.

int char2Num(str text, int position)

Parametri

Parametrs	Apraksts
īsziņa	Virkne, kas satur rakstzīmi.
pozīcija	Rakstzīmes novietojums virknē.

Atgrieztā vērtība

Rakstzīmes kā int objekta ASCII vērtība.

Atzīmes

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

datums2Num

Pārvērš datumu par veselu skaitli, kas atbilst dienu skaitam kopš 1900. gada 1. janvāra.

int date2Num(date _date)

Parametri

Parametrs	Apraksts
_datums	Konvertēšanas datums.

Atgrieztā vērtība

Dienu skaits no 1900. gada 1. janvāra līdz norādītajam datumam.

Piemērs

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

datums2Str

Pārvērš norādīto datumu par virkni.

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

Parametri

Parametrs	Apraksts
date	Konvertēšanas datums.
secība	Trīsciparu skaitlis, kas norāda datuma komponentu secību: 1 – diena, 2 – mēnesis un 3 – gads.
diena	Uzskaitījuma vērtība, kas norāda datuma dienas komponenta formātu.
atdalītājs1	Uzskaitījuma vērtība, kas norāda atdalītāju, kas jāizmanto starp pirmajiem diviem datuma komponentiem.
mēnesis	Uzskaitījuma vērtība, kas norāda datuma mēneša komponenta formātu.
atdalītājs2	Uzskaitījuma vērtība, kas norāda atdalītāju, kas jāizmanto starp pēdējiem diviem datuma komponentiem.
gads	Uzskaitījuma vērtība, kas norāda datuma gada komponenta formātu.
Karodziņus	DateFlags uzskaitījuma vērtība, kas norāda, vai valodas iestatījumi lokālajā datorā ir jāizmanto, lai aprēķinātu pareizo secību no kreisās uz labo vai no labās uz kreiso atgrieztajā virknē.

Atgrieztā vērtība

Virkne, kas apzīmē norādīto datumu.

Atzīmes

MorphX formatēšanas parametriem piešķir derīgas vērtības, ja norādītās vērtības nav derīgas. Lai izmantotu datuma formātu, ko lietotājs norādījis reģionālajos iestatījumos, izmantojiet funkciju strFmt vai date2Str un norādiet -1 visos formatēšanas parametros. Kad reģionālie iestatījumi kontrolē datuma formātu, iestatījumi var mainīties no lietotāja uz lietotāju. Ja kādam no atdalītāja parametriem tiek izmantots -1, abu atdalītāju noklusējuma vērtība ir Reģionālie iestatījumi. Secības parametru vērtībām jābūt jebkuram trīsciparu skaitlim, kas satur tieši vienu no katra cipara 1, 2 un 3. Cipari 1, 2 un 3 attiecīgi apzīmē dienu, mēnesi un gadu. Piemēram, 321 izveido secības gadu, mēnesi un dienu. Vai arī vērtība var būt -1 , lai izmantotu reģionālos iestatījumus. Šim parametram neizmantojiet uzskaitījuma tipu, jo skaitļi, piemēram, 321, pārsniedz uzskaitījuma vērtību derīgo vērtību diapazonu, kas ir no 0 līdz 250 ieskaitot. Parametra karodziņi noklusējuma vērtība ir uzskaitījuma vērtība DateFlags::None, kas nozīmē, ka secības apstrāde netiek veikta no kreisās uz labo vai no labās uz kreiso.

Piemērs

Tālāk sniegtajā piemērā tiek parādīts pašreizējais datums gada, mēneša un dienas secībā.

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

Pārvērš utcdatetime vērtību virknē.

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

Parametri

Parametrs	Apraksts
datetime	Konvertējamā utcdatetime vērtība.
Karodziņus	DateFlags uzskaitījuma vērtība, kas norāda, vai izmantot lokālos iestatījumus izvadei no labās uz kreiso.

Atgrieztā vērtība

Virkne, kas apzīmē utcdatetime vērtību, ko norādāt kā parametru datetime .

Atzīmes

Nulles datuma un laika ievade

Ja parametram datetime norādāt minimālo utcdatetime vērtību, funkcija datetime2Str to apstrādā kā nulles ievades vērtību. Šī vērtība liek funkcijai atgriezt tukšu virkni. Metode DateTimeUtil::minValue atgriež datumu-laiku 1900-01-01T00:00:00. Funkcija šo minimālo vērtību uzskata par nulli.

Vietējie iestatījumi no labās uz kreiso pusi

Pēc noklusējuma šī funkcija ģenerē virkni secībā no kreisās uz labo, kur gada daļa ir vistālāk pa kreisi. Tomēr, ja iestatāt karodziņu parametru uz uzskaitījuma vērtību DateFlags::FormatAll , funkcija ģenerē virkni secībā no labās uz kreiso, kad lokālie iestatījumi ir konfigurēti no labās uz kreiso. Reģionālie iestatījumi neietekmē klases DateTimeUtil metodes toStr formātu.

Piemērs

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

enum2Str

Pārvērš norādīto uzskaitīto tekstu par rakstzīmju attēlojumu.

str enum2Str(enum enum)

Parametri

Parametrs	Apraksts
uzskaitījums	Uzskaitītais konvertējamais teksts.

Atgrieztā vērtība

Uzskaitījuma vērtība kā virkne.

Piemērs

Šajā piemērā tiek atgriezta virkne "Nav iekļauts". Šī virkne ir uzskaitījuma tipa ListCode vērtības IncludeNot etiķete.

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

guid2Str

Pārvērš norādīto GUID objektu par ekvivalentu virkni.

str guid2String(guid _uuid)

Parametri

Parametrs	Apraksts
_uuid	Konvertējamais GUID objekts.

Atgrieztā vērtība

Norādītā GUID objekta virknes ekvivalents.

Piemērs

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

Pārvērš veselu skaitli par ekvivalentu virkni.

str int2Str(int integer)

Parametri

Parametrs	Apraksts
vesels skaitlis	Vesels skaitlis, kas jākonvertē.

Atgrieztā vērtība

Vesela skaitļa virknes attēlojums.

Piemērs

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

int642Str

Pārvērš norādīto vesela skaitļa parametru par ekvivalentu teksta virkni.

str int642Str(int64 integer)

Parametri

Parametrs	Apraksts
vesels skaitlis	int64, lai pārvērstu par virkni.

Atgrieztā vērtība

Vesela skaitļa parametra ekvivalenta teksta virkne.

Piemērs

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

num2Char

Pārvērš veselu skaitli par atbilstošo ASCII rakstzīmi.

str num2Char(int figure)

Parametri

Parametrs	Apraksts
skaitlis	Vesels skaitlis, kas jāpārvērš par rakstzīmi.

Atgrieztā vērtība

Rakstzīme, kas atbilst norādītajam veselajam skaitlim.

Piemērs

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

num2Datums

Izgūst datumu, kas atbilst norādītajam dienu skaitam pēc 1900. gada 1. janvāra.

date num2Date(int _days)

Parametri

Parametrs	Apraksts
_Dienas	Dienu skaits pēc 1900. gada 1. janvāra, lai atgrieztu datumu. Piezīme: Pirmais derīgais datums ir 1901. gada 1. janvāris. Tādēļ funkcija num2Date neatgriež derīgu datumu, ja vien _days nav lielāks par 365.

Atgrieztā vērtība

Datums, kas ir dienu skaits, ko parametrs _days norāda pēc 1900. gada 1. janvāra.

Atzīmes

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

num2Str

Pārvērš reālu skaitli virknē.

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

Parametri

Parametrs	Apraksts
skaitlis	Reāls skaitlis, kas jāpārvērš virknē.
rakstzīme	Minimālais rakstzīmju skaits, kas nepieciešams tekstā.
Decimāldaļas	Nepieciešamais decimāldaļu skaits.
atdalītājs1	Decimāldaļas atdalītāja uzskaitījuma vērtība.
atdalītājs2	Tūkstoša atdalītāja uzskaitījuma vērtība.

Atgrieztā vērtība

Virkne, kas apzīmē skaitli.

Atzīmes

Decimāldaļas parametram maksimālā vērtība ir 16. Ja izmantojat lielāku skaitli, metode iegūst decimāldaļu parametra vērtību no lokālā datora. Abos gadījumos notiek noapaļošana. Tālāk ir norādītas iespējamās parametra separator1 uzskaitījuma vērtības.

• 99 - Automātiski (lietotāja formatēšanas iestatījumi nosaka, kāds decimāldaļas atdalītājs tiek izmantots), uzskaitījuma vērtība DecimalSeparator::Auto
• 1 – Punkts (.), uzskaitījuma vērtība DecimalSeparator::D ot
• 2 — komats (,), uzskaitījuma vērtība DecimalSeparator::Comma

Tālāk ir norādītas iespējamās parametra separator2 vērtības.

• 99 - Automātiski (lietotāja formatēšanas iestatījumi nosaka, kāds tūkstoš atdalītājs tiek izmantots)
• 0 – Nav (bez tūkstoš atdalītāja), uzskaitījuma vērtība Tūkstošu atdalītājs::Nav
• 1 – Punkts (.), uzskaitījuma vērtība Tūkstošu atdalītājs::D ot
• 2 — komats (,), uzskaitījuma vērtība Tūkstošu atdalītājs::komats
• 3 – Apostrofs ('), uzskaitījuma vērtība ThousandSeparator::Apostrofs
• 4 – Atstarpe ( ), uzskaitījuma vērtība ThousandSeparator::Space

Piemērs

Nākamajā koda piemērā pirmais izsaukums uz num2str metodi nodrošina 16decimāldaļu parametru, bet otrais izsaukums nodrošina 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
}

Izvade

Ziņojumi ir šajā informācijas žurnāla izvadē. Pirmais skaitlis izvadē satur 16 ciparus aiz komata, bet otrais skaitlis satur tikai divus ciparus aiz komata.

Message (10:18:12)
0.1294567890123457
0.13

str2Datums

Pārvērš norādīto virkni par datuma vērtību.

date str2Date(str _text, str _sequence)

Parametri

Parametrs	Apraksts
_Teksts	Virkne, kas jāpārvērš par datuma vērtību.
_secība	Trīsciparu vesels skaitlis, kas apraksta dienas, mēneša un gada pozīcijas konvertējamajā virknē.

Atgrieztā vērtība

Datuma vērtība.

Atzīmes

Izmantojiet tālāk norādītās vērtības, lai norādītu dienas, mēneša un gada pozīcijas parametrā _sequence :

• Diena: 1
• Mēnesis: 2
• Gads: 3

Piemēram, ja virknes secība ir mēnesis, gads un pēc tam diena, parametram _sequence jābūt 231. 0 (nulles) datums tiek atgriezts, ja ievades parametros ir norādīts nederīgs datums. Tālāk minētajos divos piemēros ir norādīts nederīgs datums.

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.

Piemērs

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

str2Datums un laiks

Ģenerē utcdatetime vērtību no norādītās datuma un laika informācijas virknes.

utcdatetime str2datetime( str text, int sequence )

Parametri

Parametrs	Apraksts
īsziņa	Virkne, kas jāpārvērš par utcdatetime vērtību.
secība	Trīsciparu skaitlis, kas apraksta datuma komponentu secību teksta parametrā.

Atgrieztā vērtība

utcdatetime vērtība, kas norāda norādīto datumu un laiku.

Atzīmes

Teksta parametra datuma daļas sintakses prasības ir elastīgas. Derīgo formātu daudzveidība ir tāda pati kā funkcijā date2str . Katrs no šiem str2datetime izsaukumiem ir derīgs, un visi tie rada vienādu izvadi.

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

Katru datuma laika komponentu secības parametrā attēlo cipars:

• 1 – diena
• 2 – Mēnesis
• 3 – gads

Piemēram, gads, mēnesis, dienas pasūtījums ir 321. Visas derīgās vērtības satur katru no šiem trim cipariem tieši vienu reizi. Ja secības parametra vērtība nav derīga, ievades teksta parametra interpretācijai tiek izmantoti reģionālie iestatījumi. Ja ievades parametri apraksta nederīgu datumu un laiku, tiek atgriezta tukša virkne.

Piemērs

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

Izgūst uzskaitījuma elementu, kura lokalizētā rekvizīta Label vērtība atbilst ievades virknei.

enum str2Enum(enum _type, str _text)

Parametri

Parametrs	Apraksts
_tips	Mainīgais, ko deklarējat kā uzskaitījuma tipu.
_Teksts	Mērķa elementa lokalizētais rekvizīta Etiķete teksts uzskaitījumā.

Atgrieztā vērtība

Mērķa uzskaites elements, kas apzīmē arī int.

Atzīmes

Saistītā funkcija enum2str atgriež rekvizīta Label vērtību no viena uzskaites elementa. Vērtība, ko atgriež funkcija enum2str, var būt funkcijas str2enum parametra _type ievade. Atbilstoša parametra _text vērtība ir enum2Str(BankAccountType::SavingsAccount). Katram uzskaitījuma elementam ir rekvizīts Name un Label rekvizīts. Jaunā instalācijā Name vērtības gandrīz vienmēr ir angļu valodas vārdi. Angļu valodas izdevumā rekvizīta Label vērtība gandrīz vienmēr ir tāda pati kā vērtība Name . Tomēr izdevumos, kas nav angļu valoda, etiķetes vērtības ir lokalizētas, tāpēc tās neatbilst nosaukuma vērtībām.

Piemērs

Lai izvairītos no virkņu neatbilstības, ko izraisa lokalizācija citās runātajās valodās, izmantojiet funkciju enum2str , lai ģenerētu ievadi funkcijā str2enum . Šajā piemērā ir parādīts pareizais veids, kā izmantot funkciju str2enum kopā ar funkciju enum2str .

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

Pārvērš virkni par GUID objektu.

Guid str2Guid(str text)

Parametri

Parametrs	Apraksts
Guid	Virkne, kas apzīmē GUID.

Atgrieztā vērtība

GUID, ko attēlo ievades virkne.

Atzīmes

Piemēram, derīga parametra guid vērtība ir {12345678-1234-abCD-3456-123456789012} ar iekavām vai bez tām.

str2Int

Pārvērš virkni par ekvivalentu veselu skaitli.

int str2Int(str _text)

Parametri

Parametrs	Apraksts
_Teksts	Virkne, kas jāpārvērš par veselu skaitli.

Atgrieztā vērtība

Norādītās virknes vesela skaitļa ekvivalents.

Piemērs

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

str2Int64

Pārvērš virkni par Int64 vērtību.

int str2Int64(str text)

Parametri

Parametrs	Apraksts
īsziņa	Pārveidojamā virkne.

Atgrieztā vērtība

Norādītās virknes Int64 vērtība.

Piemērs

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

Pārvērš virkni par reālu skaitli.

real str2Num(str _text)

Parametri

Parametrs	Apraksts
_Teksts	Virkne, kas jāpārvērš par reālu skaitli.

Atgrieztā vērtība

Reālais skaitlis, ja norādītajā virknē ir derīgs skaitlis; pretējā gadījumā 0 (nulle).

Atzīmes

Tālāk sniegtajos piemēros ir parādīts, kā izmantot šo funkciju.

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

Skenēšana notiek no kreisās uz labo pusi un beidzas, kad rakstzīmi nevar pārvērst par reāla skaitļa daļu.

Piemērs

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
***/

str2Laiks

Pārvērš virkni par timeOfDay vērtību.

int str2Time(str _text)

Parametri

Parametrs	Apraksts
_Teksts	Laiks, kas jāizmanto, lai aprēķinātu sekunžu skaitu kopš pusnakts.

Atgrieztā vērtība

Sekunžu skaits starp pusnakti un _text parametru; pretējā gadījumā -1.

Atzīmes

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

Piemērs

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

laiks2Str

Pārvērš timeOfDay vērtību par virkni, kas ietver stundas, minūtes un sekundes.

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

Parametri

Parametrs	Apraksts
_Laiks	TimeOfDay vērtība.
_Atdalītāju	TimeSeparator uzskaitījuma vērtība, kas norāda rakstzīmes starp stundām, minūtēm un sekundēm izvades virknē.
_timeFormat	TimeFormat uzskaitījuma vērtība, kas norāda, vai tiek izmantots 12 stundu vai 24 stundu pulkstenis.

Atgrieztā vērtība

Virkne, kas apzīmē norādīto laiku.

Atzīmes

Parametra _time vērtība ir sekunžu skaits kopš pusnakts.

Piemērs

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

Pārvērš veselu skaitli par virkni. Šī funkcija pieņem, ka vesels skaitlis nav parakstīts.

str uint2Str(int integer)

Parametri

Parametrs	Apraksts
vesels skaitlis	Vesels skaitlis, kas jākonvertē.

Atgrieztā vērtība

Norādītā veselā skaitļa bez paraksta virknes ekvivalents.

Atzīmes

Izmantojiet šo funkciju funkcijas int2str vietā ļoti lieliem veseliem skaitļiem, piemēram, ierakstu ID.

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