X++ bihurketa-denboraren exekuzio-funtzioak

Oharra

Komunitatearen interes taldeak Yammer-etik Microsoft Viva Engage-ra mugitu dira. Viva Engage komunitate batean sartzeko eta azken eztabaidetan parte hartzeko, bete Request access to Finance and Operations Viva Engage Community formularioa eta aukeratu sartu nahi duzun komunitatean.

Artikulu honetan bihurketa exekuzio-denboraren funtzioak azaltzen dira.

any2Date

Anytype balio bat data-balio bihurtzen du.

date any2Date(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Data bihurtzeko balioa.

Itzuli balioa

Dataren balioa.

Oharrak

Objektuaren parametroa datu mota gehienak izan daitezke, baina irteera erabilgarria lortzen duzu str edo int motakoa denean. Eduki desegokiak exekuzio-denboraren errorea sortzen du.

Adibidea

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

Helburuko enumerazioko elementu baten Izen propietatearen balio bihurtzen du anytype-ren balioa.

enum any2Enum(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Helburuko enum-eko elementu baten Value propietatearekin bat datorren balioa.

Itzuli balioa

Izen propietatearen balioa helburuko enum-eko edozein elementuren Balioa propietatea du, sarrerako parametroarekin bat datorrena.

Oharrak

Objektuaren parametroa datu mota gehienak izan daitezke, baina str edo int motako parametro bat erabiltzen duzunean soilik lortzen dituzu datu erabilgarriak. Sarrerako objektuaren parametro honek helburuko enum-eko elementu indibidual baten Value propietateari egiten dio erreferentzia.

Adibidea

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

Zehaztutako anytype objektua GUID objektu bihurtzen du.

guid any2Guid(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	GUID objektu bihurtzeko balioa.

Itzuli balioa

GUID objektua.

any2Int

Anytype balio bat int balio bihurtzen du.

int any2Int(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Bihurtu beharreko balioa.

Itzuli balioa

Int balioa.

Oharrak

Objektuaren parametroa datu mota gehienak izan daitezke, baina datu erabilgarriak enum, real edo str motako parametroak erabiltzen dituzunean soilik lortzen dituzu.

Adibidea

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

Anytype objektu bat int64 objektu bihurtzen du.

int64 any2Int64(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Bihurtu beharreko edozein motatako objektua.

Itzuli balioa

Int64 objektua.

any2Real

Edozein motatako balio bat balio erreal bihurtzen du.

real any2Real(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Bihurtu beharreko balioa.

Itzuli balioa

Benetako balioa.

Oharrak

Objektuaren parametroa datu mota gehienak izan daitezke, baina data, int, enum eta str motetako sarrerako elementuetarako irteera erabilgarria lortzen duzu.

Adibidea

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

Anytype balio bat str balio bihurtzen du.

str any2Str(anytype object)

Parametroak

Parametroa	Deskribapenak
objektua	Bihurtu beharreko balioa.

Itzuli balioa

Str balioa.

Oharrak

Objektuaren parametroa datu mota gehienak izan daitezke, baina data, int eta enum moten sarrerako elementuetatik irteera erabilgarria lortzen duzu.

Adibidea

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

Ikusi any2Date.

anytoenum

Ikus any2Enum.

anytoguid

Ikus any2Guid.

Anytoint

Ikus any2Int.

anytoint64color

Ikus any2Int64.

Anytoreal

Ikus any2Real.

anytostr

Ikus any2Str.

char2Num

Kate bateko karaktere bat karakterearen ASCII baliora bihurtzen du.

int char2Num(str text, int position)

Parametroak

Parametroa	Deskribapenak
testu-mezu	Karakterea daukan katea.
posizioa	Karakterearen posizioa katean.

Itzuli balioa

Karakterearen ASCII balioa int objektu gisa.

Oharrak

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

Data bat 1900eko urtarrilaren 1etik geroztik egun kopuruari dagokion zenbaki osoko zenbaki batera bihurtzen du.

int date2Num(date _date)

Parametroak

Parametroa	Deskribapenak
_date	Bihurtu beharreko data.

Itzuli balioa

1900eko urtarrilaren 1etik zehaztutako datara arteko egun kopurua.

Adibidea

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

date2Str

Zehaztutako data kate bihurtzen du.

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

Parametroak

Parametroa	Deskribapenak
data	Bihurtu beharreko data.
sekuentzia	Dataren osagaien sekuentzia adierazten duen hiru digituko zenbakia: 1 egunerako, 2 hilabeterako eta 3 urterako.
egunetan	Dataren egunaren osagaiaren formatua adierazten duen enumerazio-balioa.
1. bereizlea	Dataren lehenengo bi osagaien artean erabili beharreko bereizlea adierazten duen zenbaketa balioa.
hilabetea	Dataren hileko osagaiaren formatua adierazten duen enumerazio-balioa.
2. bereizlea	Dataren azken bi osagaien artean erabili beharreko bereizlea adierazten duen enumerazio-balioa.
urtea	Dataren urtearen osagaiaren formatua adierazten duen enumerazio-balioa.
banderak	DateFlags enumerazio-balioa, ordenagailu lokaleko hizkuntza-ezarpenak erabili behar diren adierazten duena itzulitako katean ezkerretik eskuinera edo eskuinetik ezkerrera sekuentzia egokia kalkulatzeko.

Itzuli balioa

Zehaztutako data adierazten duen katea.

Oharrak

MorphX-ek baliozko balioak esleitzen dizkie formatu-parametroei, zehaztutako balioak baliozkoak ez badira. Erabiltzaileak Eskualdeko ezarpenetan zehaztutako data-formatua erabiltzeko, erabili strFmt edo date2Str funtzioa, eta zehaztu -1 formatu-parametro guztietan. Eskualdeko ezarpenek data formatua kontrolatzen dutenean, ezarpenak erabiltzaile batetik bestera alda daitezke. -1 balioa erabiltzen bada bereizle-parametroetako batean, bi bereizleek lehenespenez Eskualdeko ezarpenak izango dituzte. Sekuentzia-parametroen balioak hiru digituko edozein zenbaki izan behar dute, 1, 2 eta 3 digitu bakoitzaren agerraldi bat zehatz-mehatz. 1, 2 eta 3 digituek eguna, hilabetea eta urtea adierazten dituzte, hurrenez hurren. Adibidez, 321-ek urtea, hilabetea eta eguna sekuentzia sortzen ditu. Edo balioa -1 izan daiteke eskualdeko ezarpenak erabiltzeko. Ez erabili enumerazio mota parametro honetarako, 321 bezalako zenbakiek balio baliozkoen barrutia gainditzen baitute, hau da, 0tik 250era, biak barne. Flags parametroaren balio lehenetsia DateFlags::None enumerazio-balioa da, hau da, ez da ezkerretik eskuinera edo eskuinetik ezkerrera sekuentzia prozesamendurik egin.

Adibidea

Ondorengo adibidean uneko data bistaratzen da urte, hilabete eta egunaren sekuentzian.

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

utcdatetime balio bat kate bihurtzen du.

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

Parametroak

Parametroa	Deskribapenak
data eta ordua	Bihurtu beharreko utcdatetime balioa.
banderak	DateFlags enumerazio-balioa, eskuinetik ezkerrera irteeran ezarpen lokalak erabili behar diren ala ez adierazten duena.

Itzuli balioa

Datetime parametro gisa zehazten duzun utcdatetime balioa adierazten duen katea.

Oharrak

Data-orduaren sarrera nulua

datetime parametroaren gutxieneko utcdatetime balioa zehazten baduzu, datetime2Str funtzioak sarrerako balio nulutzat hartuko du. Balio honek funtzioak kate huts bat itzultzen du. DateTimeUtil::minValue metodoak 1900-01-01T00:00:00 data-ordua itzultzen du. Funtzioak gutxieneko balio hau nulutzat hartzen du.

Eskuinetik ezkerrera ezarpen lokalak

Lehenespenez, funtzio honek katea sortzen du ezkerretik eskuinera sekuentzian, non urtearen zatia ezkerrean dagoen. Hala ere, flags parametroa DateFlags::FormatAll enumerazio-balioa ezartzen baduzu, funtzioak katea eskuinetik ezkerrera sekuentzian sortzen du ezarpen lokalak eskuinetik ezkerrera konfiguratzen direnean. Eskualdeko ezarpenek ez diote eraginik DateTimeUtil klasearen toStr metodoaren formatuari.

Adibidea

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

enum2Str

Zehaztutako zerrendatutako testua karaktere-adierazpen bihurtzen du.

str enum2Str(enum enum)

Parametroak

Parametroa	Deskribapenak
Enumerazioa	Bihurtu beharreko testu zerrendatua.

Itzuli balioa

Enumerazioaren balioa kate gisa.

Adibidea

Ondorengo adibideak "Not included" katea itzultzen du. Kate hau ListCode enumerazio motaren IncludeNot balioaren etiketa da.

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

guid2Str

Zehaztutako GUID objektua kate baliokide bihurtzen du.

str guid2String(guid _uuid)

Parametroak

Parametroa	Deskribapenak
_uuid	Bihurtu beharreko GUID objektua.

Itzuli balioa

Zehaztutako GUID objektuaren katearen baliokidea.

Adibidea

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

Zenbaki osoko bat kate baliokide bihurtzen du.

str int2Str(int integer)

Parametroak

Parametroa	Deskribapenak
osoko zenbakia	Bihurtu beharreko osoko zenbakia.

Itzuli balioa

Zenbaki osoaren kate-irudikapena.

Adibidea

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

int642Str

Zehaztutako osoko parametroa testu-kate baliokide bihurtzen du.

str int642Str(int64 integer)

Parametroak

Parametroa	Deskribapenak
osoko zenbakia	int64 kate bihurtzeko.

Itzuli balioa

Osoko parametroaren testu-kate baliokidea.

Adibidea

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

zenbaki2karaktereak

Osoko zenbaki bat dagokion ASCII karaktere bihurtzen du.

str num2Char(int figure)

Parametroak

Parametroa	Deskribapenak
Irudia	Karaktere bihurtzeko osoko zenbakia.

Itzuli balioa

Zehaztutako osoko zenbakiari dagokion karaktere.

Adibidea

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

num2Data

1900eko urtarrilaren 1etik aurrera zehaztutako egun kopuruari dagokion data eskuratzen du.

date num2Date(int _days)

Parametroak

Parametroa	Deskribapenak
_days	1900eko urtarrilaren 1etik aurrera data itzultzeko egun kopurua. Oharra: Lehenengo data 1901eko urtarrilaren 1a da. Beraz, num2Date funtzioak ez du baliozko data itzultzen, _days 365 baino handiagoa ez bada.

Itzuli balioa

1900eko urtarrilaren 1etik aurrera _days parametroak zehaztutako egun kopurua.

Oharrak

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

num2Str

Zenbaki erreal bat kate bihurtzen du.

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

Parametroak

Parametroa	Deskribapenak
zenbakia	Kate bihurtzeko zenbaki erreala.
karaktere	Testuan eskatzen diren gutxieneko karaktere kopurua.
hamartarrak	Beharrezko hamartarren kopurua.
1. bereizlea	DecimalSeparator enumerazioaren balioa.
2. bereizlea	ThousandSeparator enumerazio-balioa.

Itzuli balioa

Zenbakia adierazten duen katea.

Oharrak

Hamartarren parametroari dagokionez, gehienezko balioa 16 da. Zenbaki handiagoa erabiltzen baduzu, metodoak hamartarren parametroaren balioa lortuko du ordenagailu lokaletik. Bi kasuetan, biribilketa gertatzen da. Hona hemen separator1 parametroaren enumerazio-balio posibleak:

• 99 – Auto (erabiltzailearen formatu-ezarpenek zehazten dute zein bereizle hamartar erabiltzen den), enumerazio-balioa DecimalSeparator::Auto
• 1 – Puntua (.), enumerazio-balioa DecimalSeparator::D ot
• 2 – Koma (,), enumerazio-balioa DecimalSeparator::Comma

Hona hemen separator2 parametroaren balio erabilgarriak:

• 99 - Automatikoa (erabiltzailearen formatu-ezarpenek zehazten dute zein mila bereizgailu erabiltzen den)
• 0 – Bat ere ez (mila bereizlerik ez), enumerazio-balioa ThousandSeparator::None
• 1 – Puntua (.), enumerazio-balioa ThousandSeparator::D ot
• 2 – Koma (,), enumerazio-balioa ThousandSeparator::Comma
• 3 – Apostrofoa ('), enumerazio-balioa ThousandSeparator::Apostrophe
• 4 – Espazioa ( ), enumerazio-balioa ThousandSeparator::Space

Adibidea

Ondorengo kode-adibidean, num2str metodoari egindako lehenengo deiak 16 ematen du hamartarren parametrorako, eta bigarrenak 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
}

Irteerako elementua

Mezuak Infolog-en irteeran daude. Irteerako lehenengo zenbakiak 16 digitu hamartar ditu, eta bigarrenak, berriz, bi digitu hamartar besterik ez ditu.

Message (10:18:12)
0.1294567890123457
0.13

str2Data

Zehaztutako katea data-balio bihurtzen du.

date str2Date(str _text, str _sequence)

Parametroak

Parametroa	Deskribapenak
_text	Data-balio bihurtzeko katea.
_sequence	Bihurtu beharreko katean egunaren, hilabetearen eta urtearen posizioak deskribatzen dituen hiru digituko osoko zenbakia.

Itzuli balioa

Dataren balioa.

Oharrak

Erabili balio hauek egunaren, hilabetearen eta urtearen posizioak zehazteko _sequence parametroan:

• Eguna: 1
• Hilabetea: 2
• Urtea: 3

Adibidez, katearen sekuentzia hilabetea, urtea eta gero eguna bada, _sequence parametroak 231 izan behar du. 0 (zero) data itzultzen da sarrerako parametroek data baliogabea zehazten badute. Ondorengo bi adibideek data baliogabea zehazten dute.

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.

Adibidea

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

str2Datetime

utcdatetime balioa sortzen du zehaztutako data eta orduaren informazioaren katearen arabera.

utcdatetime str2datetime( str text, int sequence )

Parametroak

Parametroa	Deskribapenak
testu-mezu	utcdatetime balio bihurtzeko katea.
sekuentzia	Testu-parametroko data-osagaien sekuentzia deskribatzen duen hiru digituko zenbakia.

Itzuli balioa

Zehaztutako data eta ordua adierazten duen utcdatetime balioa.

Oharrak

Testu parametroaren data zatiaren sintaxi-eskakizunak malguak dira. Baliozko formatuen barietatea date2str funtzioaren berdina da. str2datetime-rako dei hauetako bakoitza baliozkoa da, eta guztiek irteera bera sortzen dute.

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

Data-orduaren osagai bakoitza digitu batez adierazten da sekuentzia-parametroan :

• 1 - Eguna
• 2 – Hilabetea
• 3 - Urtea

Adibidez, urtea, hilabetea, eguna, ordena 321 da. Baliozko balio guztiek hiru digitu horietako bakoitza behin zehazki dute. Sekuentzia parametroaren balioa baliozkoa ez bada, eskualdeko ezarpenak erabiliko dira sarrerako testuaren parametroa interpretatzeko. Sarrerako parametroek data eta ordu baliogabeak deskribatzen badituzte, kate huts bat itzuliko da.

Adibidea

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

Lokalizatutako Etiketa propietatearen balioa sarrerako katearekin bat datorren enum elementua eskuratzen du.

enum str2Enum(enum _type, str _text)

Parametroak

Parametroa	Deskribapenak
_type	Enum mota gisa deklaratzen duzun aldagaia.
_text	Helburuko elementuaren Etiketa propietatearen testua lokalizatua.

Itzuli balioa

Helburuko enum-aren elementu bat, int bat ere adierazten duena.

Oharrak

Erlazionatutako enum2str funtzioak enum-eko elementu bateko Label propietatearen balioa itzultzen du. enum2str funtzioak itzultzen duen balioa str2enum funtzioaren _type parametroaren sarrera izan daiteke. _text parametroaren balio egokia enum2Str(BankAccountType::SavingsAccount) da. Enum baten elementu bakoitzak Name propietatea eta Label propietatea ditu. Instalazio berri batean, izenaren balioak ia beti ingelesezko hitzak dira. Ingelesezko edizioan, Label propietatearen balioa ia beti Name balioaren berdina da. Hala ere, ingelesez ez diren edizioetan, Label balioak lokalizatuta daude eta, beraz, ez datoz bat Izenaren balioekin.

Adibidea

Beste hizkuntza batzuetan lokalizatzeak eragiten dituen kateen desadostasunak saihesteko, erabili enum2str funtzioa str2enum funtzioan sarrera sortzeko. Ondorengo adibideak str2enum funtzioa enum2str funtzioarekin batera erabiltzeko modu egokia erakusten du.

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

Kate bat GUID objektu bihurtzen du.

Guid str2Guid(str text)

Parametroak

Parametroa	Deskribapenak
Guid	GUID bat irudikatzen duen katea.

Itzuli balioa

Sarrerako kateak adierazten duen GUID.

Oharrak

Adibidez, guid parametroaren balio baliozkoa {12345678-1234-abCD-3456-123456789012} da, parentesiekin edo gabe.

str2Int

Kate bat osoko zenbaki baliokide bihurtzen du.

int str2Int(str _text)

Parametroak

Parametroa	Deskribapenak
_text	Zenbaki osoko bihurtzeko katea.

Itzuli balioa

Zehaztutako katearen osoko baliokidea.

Adibidea

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

str2Int64

Kate bat Int64 balio bihurtzen du.

int str2Int64(str text)

Parametroak

Parametroa	Deskribapenak
testu-mezu	Bihurtzeko katea.

Itzuli balioa

Zehaztutako katearen Int64 balioa.

Adibidea

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

Kate bat zenbaki erreal bihurtzen du.

real str2Num(str _text)

Parametroak

Parametroa	Deskribapenak
_text	Zenbaki erreal bihurtzeko katea.

Itzuli balioa

Zenbaki erreala, zehaztutako kateak baliozko zenbaki bat badu; bestela, 0 (zero).

Oharrak

Ondorengo adibideek funtzio hau nola erabili erakusten dute.

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

Eskaneatzea ezkerretik eskuinera egiten da, eta karaktere bat zenbaki erreal baten zati bihurtu ezin denean amaitzen da.

Adibidea

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

Kate bat timeOfDay balio bihurtzen du.

int str2Time(str _text)

Parametroak

Parametroa	Deskribapenak
_text	Gauerditik segundo kopurua kalkulatzeko erabili beharreko denbora.

Itzuli balioa

Gauerdiaren eta _text parametroaren arteko segundo kopurua; Bestela, -1.

Oharrak

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

Adibidea

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

time2Str

TimeOfDay balioa orduak, minutuak eta segundoak barne hartzen dituen kate bihurtzen du.

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

Parametroak

Parametroa	Deskribapenak
_time	TimeOfDay balioa.
_separator	TimeSeparator enumerazio-balioa, irteerako katearen ordu, minutu eta segundoen arteko karaktereak adierazten dituena.
_timeFormat	12 orduko erlojua edo 24 orduko erlojua erabiliko den adierazten duen TimeFormat enumerazio-balioa.

Itzuli balioa

Zehaztutako ordua adierazten duen katea.

Oharrak

_time parametroaren balioa gauerditik gertatutako segundo kopurua da.

Adibidea

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

Zenbaki osoko bat kate bihurtzen du. Funtzio honek osoko zenbakia zeinurik gabekoa dela suposatzen du.

str uint2Str(int integer)

Parametroak

Parametroa	Deskribapenak
osoko zenbakia	Bihurtu beharreko osoko zenbakia.

Itzuli balioa

Zeinurik gabeko zenbaki osoaren baliokidea.

Oharrak

Erabili funtzio hau int2str funtzioaren ordez osoko zenbaki oso handietarako, hala nola erregistroen IDetarako.

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