X++-runtimefuncties conversie

Opmerking

Community-belangengroepen zijn nu verplaatst van Yammer naar Microsoft Viva Engage. Als u wilt deelnemen aan een Viva Engage-community en deel wilt nemen aan de meest recente discussies, vult u het formulier Toegang aanvragen tot Finance and Operations Viva Engage Community in en kiest u de community waaraan u wilt deelnemen.

In dit artikel worden de runtimefuncties voor conversies beschreven.

any2Date

Converteert een anytype-waarde naar een datumwaarde .

date any2Date(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die moet worden geconverteerd naar een datum.

Retourwaarde

Een datumwaarde .

Opmerkingen

De objectparameter kan van de meeste gegevenstypen zijn, maar nuttige uitvoer wordt verkregen wanneer deze van het type str of int is. Ongepaste inhoud genereert een runtimefout.

Example

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

Converteert een anytype-waarde naar de waarde van de eigenschap Name van een element in de doel-enum.

enum any2Enum(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die overeenkomt met de eigenschap Waarde van een element in de doel-enum.

Retourwaarde

De waarde van de eigenschap Name voor het element in de doel-enum heeft een waarde-eigenschap die overeenkomt met de invoerparameter.

Opmerkingen

De objectparameter kan van de meeste gegevenstypen zijn, maar nuttige gegevens worden alleen verkregen wanneer u een parameter van het str - of int-type gebruikt. Deze parameter voor het invoerobject verwijst naar de eigenschap Waarde van een afzonderlijk element in de doel-enum.

Example

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

Converteert het opgegeven anytype-object naar een GUID-object.

guid any2Guid(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die moet worden geconverteerd naar een GUID-object.

Retourwaarde

Een GUID-object.

any2Int

Converteert een anytype-waarde naar een int-waarde .

int any2Int(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die moet worden geconverteerd.

Retourwaarde

Een int-waarde .

Opmerkingen

De objectparameter kan van de meeste gegevenstypen zijn, maar nuttige gegevens worden alleen verkregen wanneer u parameters van het enum-, real- of str-type gebruikt.

Example

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

Converteert een anytype-object naar een int64-object .

int64 any2Int64(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	Het anytype-object dat moet worden geconverteerd.

Retourwaarde

Een int64-object .

any2Real

Converteert een anytype-waarde naar een echte waarde.

real any2Real(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die moet worden geconverteerd.

Retourwaarde

Een echte waarde.

Opmerkingen

De objectparameter kan van de meeste gegevenstypen zijn, maar nuttige uitvoer wordt verkregen voor invoerelementen van de typen datum, int, enum en str .

Example

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

Converteert een anytype-waarde naar een str-waarde .

str any2Str(anytype object)

Parameterwaarden

Kenmerk	Description
Voorwerp	De waarde die moet worden geconverteerd.

Retourwaarde

Een str-waarde .

Opmerkingen

De objectparameter kan van de meeste gegevenstypen zijn, maar nuttige uitvoer wordt verkregen uit invoerelementen van de datum-, int- en opsommingstypen .

Example

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

Zie any2Date.

anytoenum

Zie any2Enum.

anytoguid

Zie any2Guid.

anytoint

Zie any2Int.

anytoint64

Zie any2Int64.

anytoreal

Zie any2Real.

anytostr

Zie any2Str.

char2Num

Converteert een teken in een tekenreeks naar de ASCII-waarde van het teken.

int char2Num(str text, int position)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks die het teken bevat.
positie	De positie van het teken in de tekenreeks.

Retourwaarde

De ASCII-waarde van het teken als een int-object .

Opmerkingen

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

datum2Num

Converteert een datum naar een geheel getal dat overeenkomt met het aantal dagen sinds 1 januari 1900.

int date2Num(date _date)

Parameterwaarden

Kenmerk	Description
_datum	De datum die moet worden geconverteerd.

Retourwaarde

Het aantal dagen tussen 1 januari 1900 en de opgegeven datum.

Example

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

date2Str

Converteert de opgegeven datum naar een tekenreeks.

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

Parameterwaarden

Kenmerk	Description
date	De datum die moet worden geconverteerd.
volgorde	Een getal van drie cijfers dat de volgorde aangeeft voor de onderdelen van de datum: 1 voor dag, 2 voor maand en 3 voor jaar.
day	Een opsommingswaarde die de notatie aangeeft voor het dagonderdeel van de datum.
scheidingsteken1	Een opsommingswaarde die het scheidingsteken aangeeft dat moet worden gebruikt tussen de eerste twee onderdelen van de datum.
maand	Een opsommingswaarde die de notatie aangeeft voor het maandonderdeel van de datum.
scheidingsteken2	Een opsommingswaarde die het scheidingsteken aangeeft dat moet worden gebruikt tussen de laatste twee onderdelen van de datum.
jaar	Een opsommingswaarde die de notatie aangeeft voor het jaaronderdeel van de datum.
flags	Een DatumFlags-opsommingswaarde die aangeeft of de taalinstellingen op de lokale computer moeten worden gebruikt om de juiste volgorde van links naar rechts of van rechts naar links te berekenen in de geretourneerde tekenreeks.

Retourwaarde

Een tekenreeks die de opgegeven datum vertegenwoordigt.

Opmerkingen

MorphX wijst geldige waarden toe aan de opmaakparameters als de opgegeven waarden niet geldig zijn. Als u de datumnotatie wilt gebruiken die de gebruiker heeft opgegeven in landinstellingen, gebruikt u de functie strFmt of date2Str en geeft u -1 op in alle opmaakparameters. Wanneer de landinstellingen de datumnotatie bepalen, kunnen de instellingen worden gewijzigd van gebruiker in gebruiker. Als -1 wordt gebruikt voor een van beide scheidingstekens , worden beide scheidingstekens standaard ingesteld op Landinstellingen. De waarden van de reeksparameter moeten een getal van drie cijfers zijn dat precies één exemplaar van elk getal 1, 2 en 3 bevat. De cijfers 1, 2 en 3 vertegenwoordigen respectievelijk dag, maand en jaar. 321 produceert bijvoorbeeld het reeksjaar, de maand en de dag. Of de waarde kan -1 zijn om landinstellingen te gebruiken. Er mag geen opsommingstype worden gebruikt voor deze parameter, omdat getallen zoals 321 het bereik met geldige waarden voor opsommingswaarden, die 0 tot en met 250 zijn, overschrijden. De standaardwaarde van de parameter vlaggen is de DatumFlags::Geen opsommingswaarde, wat betekent dat er geen verwerking van links-naar-rechts of van rechts naar links wordt verwerkt.

Example

In het volgende voorbeeld wordt de huidige datum weergegeven in de reeks jaar, maand en dag.

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

Converteert een utcdatetime-waarde naar een tekenreeks.

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

Parameterwaarden

Kenmerk	Description
datetime	De utcdatetime-waarde die moet worden geconverteerd.
flags	Een DatumFlags-opsommingswaarde die aangeeft of lokale instellingen moeten worden gebruikt voor uitvoer van rechts naar links.

Retourwaarde

Een tekenreeks die de utcdatetime-waarde vertegenwoordigt die is opgegeven als de parameter datetime .

Opmerkingen

Null-datum/tijd-invoer

Als de minimale utcdatetime-waarde is opgegeven voor de parameter datetime , wordt deze door de functie datetime2Str als een null-invoerwaarde behandeld. Dit zorgt ervoor dat de functie een lege tekenreeks retourneert. De datum/tijd 1900-01-01T00:00:00 wordt geretourneerd door de methode DateTimeUtil::minValue . Deze minimumwaarde wordt behandeld als null.

Lokale instellingen van rechts naar links

Het standaardgedrag van deze functie is het genereren van de tekenreeks in de reeks van links naar rechts, waarbij het jaargedeelte het meest links is. De parameterwaarde van de markeringen van de datumflags::FormatAll-opsommingswaarde leidt de functie echter om de tekenreeks te genereren in volgorde van rechts naar links als de lokale instellingen zijn geconfigureerd voor van rechts naar links. De indeling van de toStr-methode van de klasse DateTimeUtil wordt niet beïnvloed door regionale instellingen.

Example

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

enum2Str

Converteert de opgegeven geïnventariseerd tekst naar een tekenweergave.

str enum2Str(enum enum)

Parameterwaarden

Kenmerk	Description
enum	De opgesomde tekst die moet worden geconverteerd.

Retourwaarde

De waarde van de opsomming als een tekenreeks.

Example

In het volgende voorbeeld wordt de tekenreeks 'Niet opgenomen' geretourneerd. Dit is het label voor de IncludeNot-waarde van het opsommingstype ListCode .

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

guid2Str

Converteert het opgegeven GUID-object naar de equivalente tekenreeks.

str guid2String(guid _uuid)

Parameterwaarden

Kenmerk	Description
_uuid	Het GUID-object dat moet worden geconverteerd.

Retourwaarde

Het tekenreeksequivalent van het opgegeven GUID-object.

Example

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

Converteert een geheel getal naar de equivalente tekenreeks.

str int2Str(int integer)

Parameterwaarden

Kenmerk	Description
integer	Het gehele getal dat moet worden geconverteerd.

Retourwaarde

Een tekenreeksweergave van het gehele getal.

Example

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

int642Str

Converteert de opgegeven parameter geheel getal naar de equivalente tekenreeks.

str int642Str(int64 integer)

Parameterwaarden

Kenmerk	Description
integer	De int64 die moet worden geconverteerd naar een tekenreeks.

Retourwaarde

De equivalente tekenreeks van de parameter geheel getal .

Example

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

num2Char

Converteert een geheel getal naar het bijbehorende ASCII-teken.

str num2Char(int figure)

Parameterwaarden

Kenmerk	Description
cijfer	Het gehele getal dat moet worden geconverteerd naar een teken.

Retourwaarde

Het teken dat wordt vertegenwoordigd door het opgegeven gehele getal.

Example

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

num2Date

Haalt de datum op die overeenkomt met het opgegeven aantal dagen na 1 januari 1900.

date num2Date(int _days)

Parameterwaarden

Kenmerk	Description
_Dagen	Het aantal dagen na 1 januari 1900 om de datum voor te retourneren. Notitie: De eerste geldige datum is 1 januari 1901. De functie num2Date retourneert daarom geen geldige datum, tenzij _days meer dan 365 is.

Retourwaarde

De datum die het aantal dagen is dat is opgegeven door de parameter _days na 1 januari 1900.

Opmerkingen

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

getal2Str

Converteert een reëel getal naar een tekenreeks.

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

Parameterwaarden

Kenmerk	Description
nummer	Het reële getal dat moet worden geconverteerd naar een tekenreeks.
karakter	Het minimum aantal tekens dat vereist is in de tekst.
Decimalen	Het vereiste aantal decimalen.
scheidingsteken1	Een decimaaltekeningswaarde .
scheidingsteken2	De opsommingswaarde ThousandSeparator .

Retourwaarde

Een tekenreeks die het getal vertegenwoordigt.

Opmerkingen

Voor de parameter decimalen is de maximumwaarde 16. Als een groter getal wordt gebruikt, haalt deze methode in plaats daarvan een waarde op voor de parameter decimalen van de lokale computer. In beide gevallen vindt afronding plaats. Hier volgen de mogelijke opsommingswaarden voor de parameter scheidingsteken1 :

• 99 – Automatisch (de opmaakinstellingen van de gebruiker bepalen welk decimaalteken wordt gebruikt), opsommingswaarde DecimalSeparator::Auto
• 1 – Punt (.), opsommingswaarde DecimalSeparator::D ot
• 2 – Komma (,), opsommingswaarde DecimalSeparator::Komma

Hier volgen de mogelijke waarden voor de parameter scheidingsteken2 :

• 99 – Automatisch (de opmaakinstellingen van de gebruiker bepalen welk scheidingsteken voor duizendtallen wordt gebruikt)
• 0 – Geen (scheidingsteken voor duizendtallen), opsommingswaarde ThousandSeparator::Geen
• 1 – Punt (.), opsommingswaarde ThousandSeparator::D ot
• 2 – Komma (,), opsommingswaarde ThousandSeparator::Komma
• 3 – Apostrof ('), opsommingswaarde ThousandSeparator::Apostrof
• 4 – Spatie ( ), opsommingswaarde ThousandSeparator::Spatie

Example

In het volgende codevoorbeeld biedt de eerste aanroep van de methode num2str16 voor de parameter decimalen en de tweede aanroep 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
}

Uitvoer

De berichten bevinden zich in de volgende Infolog-uitvoer. Het eerste getal in de uitvoer bevat 16 decimale cijfers, terwijl het tweede getal slechts twee decimale cijfers bevat.

Message (10:18:12)
0.1294567890123457
0.13

str2Date

Converteert de opgegeven tekenreeks naar een datumwaarde .

date str2Date(str _text, str _sequence)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden geconverteerd naar een datumwaarde .
_volgorde	Een geheel getal van drie cijfers dat de posities van de dag, maand en het jaar in de tekenreeks beschrijft die moeten worden geconverteerd.

Retourwaarde

Een datumwaarde .

Opmerkingen

Gebruik de volgende waarden om de posities van de dag, maand en het jaar op te geven in de parameter _sequence :

• Dag: 1
• Maand: 2
• Jaar: 3

Als de reeks in de tekenreeks bijvoorbeeld maand, jaar en dag is, moet de parameter _sequence231 zijn. Er wordt een datum van 0 (nul) geretourneerd als de invoerparameters een ongeldige datum opgeven. In de volgende twee voorbeelden wordt een ongeldige datum opgegeven.

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.

Example

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

str2Datetime

Hiermee wordt een utcdatetime-waarde gegenereerd op basis van de opgegeven tekenreeks met datum- en tijdgegevens.

utcdatetime str2datetime( str text, int sequence )

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks die moet worden geconverteerd naar een utcdatetime-waarde .
volgorde	Een getal van drie cijfers waarmee de volgorde van de datumonderdelen in de tekstparameter wordt beschreven.

Retourwaarde

Een utcdatetime-waarde die de opgegeven datum en tijd vertegenwoordigt.

Opmerkingen

De syntaxisvereisten voor het datumgedeelte van de tekstparameter zijn flexibel. De verscheidenheid aan geldige notaties is hetzelfde als in de functie date2str . Elk van de volgende aanroepen naar str2datetime is geldig en ze produceren allemaal dezelfde uitvoer.

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

Elk onderdeel van de datumtijd wordt vertegenwoordigd door een cijfer in de reeksparameter :

• 1 – Dag
• 2 – Maand
• 3 – Jaar

Bijvoorbeeld, jaar, maand, dagvolgorde is 321. Alle geldige waarden bevatten elk van deze drie cijfers precies één keer. Als de waarde van de reeksparameter niet geldig is, worden de landinstellingen gebruikt om de invoertekstparameter te interpreteren. Als de invoerparameters een ongeldige datum en tijd beschrijven, wordt er een lege tekenreeks geretourneerd.

Example

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

Hiermee wordt het enum-element opgehaald waarvoor de gelokaliseerde waarde van de eigenschap Label overeenkomt met de invoertekenreeks.

enum str2Enum(enum _type, str _text)

Parameterwaarden

Kenmerk	Description
_type	Een variabele die is gedeclareerd van het enum-type .
_Sms	De gelokaliseerde labeleigenschapstekst van het doelelement in de opsomming.

Retourwaarde

Een element van de doel-enum, dat ook een int vertegenwoordigt.

Opmerkingen

De gerelateerde functie enum2str retourneert de waarde van een labeleigenschap van één element in de enum. De waarde die wordt geretourneerd door de enum2str-functie kan de invoer zijn voor de parameter _type van de str2enum-functie . Een geschikte waarde voor de parameter _text is enum2Str(BankAccountType::SavingsAccount). Elk element van een enum heeft een eigenschap Name en een Label-eigenschap . In een nieuwe installatie zijn de naamwaarden bijna altijd Engelse woorden. In de Engelse editie is de waarde van de eigenschap Label bijna altijd hetzelfde als de naamwaarde . In niet-Engelse edities worden de labelwaarden echter gelokaliseerd en komen ze daarom niet overeen met de naamwaarden .

Example

Om te voorkomen dat tekenreeksen niet overeenkomen die worden veroorzaakt door lokalisatie naar andere gesproken talen, raden we u aan de enum2str-functie te gebruiken om de invoer te genereren in de str2enum-functie . In het volgende voorbeeld ziet u de juiste manier om de str2enum-functie samen met de enum2str-functie te gebruiken.

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

Converteert een tekenreeks naar een GUID-object.

Guid str2Guid(str text)

Parameterwaarden

Kenmerk	Description
Richtlijn	Een tekenreeks die een GUID vertegenwoordigt.

Retourwaarde

Een GUID die wordt vertegenwoordigd door de invoertekenreeks.

Opmerkingen

Een geldige waarde voor de guid-parameter is bijvoorbeeld {12345678-1234-abCD-3456-123456789012}, met of zonder accolades.

str2Int

Converteert een tekenreeks naar het equivalente gehele getal.

int str2Int(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden geconverteerd naar een geheel getal.

Retourwaarde

Het equivalent van het gehele getal van de opgegeven tekenreeks.

Example

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

str2Int64

Converteert een tekenreeks naar een Int64-waarde .

int str2Int64(str text)

Parameterwaarden

Kenmerk	Description
Tekst	De tekenreeks die moet worden geconverteerd.

Retourwaarde

De int64-waarde van de opgegeven tekenreeks.

Example

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

Converteert een tekenreeks naar een reëel getal.

real str2Num(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tekenreeks die moet worden geconverteerd naar een reëel getal.

Retourwaarde

Het reële getal als de opgegeven tekenreeks een geldig getal bevat; anders , 0 (nul).

Opmerkingen

In de volgende voorbeelden ziet u hoe deze functie wordt gebruikt.

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

Scannen vindt plaats van links naar rechts en eindigt wanneer een teken niet kan worden geconverteerd naar een deel van een reëel getal.

Example

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

Converteert een tekenreeks naar een timeOfDay-waarde .

int str2Time(str _text)

Parameterwaarden

Kenmerk	Description
_Sms	De tijd die moet worden gebruikt om het aantal seconden sinds middernacht te berekenen.

Retourwaarde

Het aantal seconden tussen middernacht en de parameter _text ; anders, -1.

Opmerkingen

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

Example

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

time2Str

Converteert een timeOfDay-waarde naar een tekenreeks met uren, minuten en seconden.

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

Parameterwaarden

Kenmerk	Description
_Tijd	Een timeOfDay-waarde .
_afscheider	Een Tijdseparator-opsommingswaarde die de tekens tussen de uren, minuten en seconden in de uitvoertekenreeks aangeeft.
_timeFormat	Een tijdnotatiewaarde die aangeeft of een 12-uurs klok of een 24-uurs klok wordt gebruikt.

Retourwaarde

Een tekenreeks die de opgegeven tijd aangeeft.

Opmerkingen

De waarde van de parameter _time is het aantal seconden sinds middernacht.

Example

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

Converteert een geheel getal naar een tekenreeks. De veronderstelling is dat het gehele getal niet is ondertekend.

str uint2Str(int integer)

Parameterwaarden

Kenmerk	Description
integer	Het gehele getal dat moet worden geconverteerd.

Retourwaarde

De tekenreeks die gelijk is aan het opgegeven niet-ondertekende gehele getal.

Opmerkingen

Gebruik deze functie in plaats van de functie int2str voor zeer grote gehele getallen, zoals record-id's.

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