הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
הערה
קבוצות עניין של קהילה עברו כעת מ- Yammer Microsoft Viva Engage. כדי להצטרף לקהילת Viva Engage ולהשתתף בדיונים האחרונים, מלא את טופס הגישה לקהילת כספים ופעולות Viva Engage ובחר את הקהילה שאליה ברצונך להצטרף.
מאמר זה מתאר את פונקציות זמן הריצה של ההמרה.
תאריך 2
המרת ערך anytype לערך תאריך .
date any2Date(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיש להמיר לתאריך. |
ערך החזרה
ערך תאריך .
הערות
פרמטר האובייקט יכול להיות רוב סוגי הנתונים, אך אתה מקבל פלט שימושי כאשר הוא מסוג str או int. תוכן בלתי הולם יוצר שגיאת זמן ריצה.
דוגמה
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
****/
אוה ת"א
המרת ערך anytype לערך המאפיין Name של רכיב בספירה המשמשת כיעד.
enum any2Enum(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיתאים למאפיין ערך של רכיב בספירה המשמשת כיעד. |
ערך החזרה
הערך של המאפיין Name עבור הרכיב בספירה המשמשת כיעד כולל מאפיין ערך התואם לפרמטר הקלט.
הערות
פרמטר האובייקט יכול להיות רוב סוגי הנתונים, אך אתה מקבל נתונים שימושיים רק בעת שימוש בפרמטר מסוג str או int. פרמטר אובייקט קלט זה מפנה למאפיין ערך של רכיב בודד בספירה המשמשת כיעד.
דוגמה
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.
****/
}
תירי ת"א
המרת אובייקט anytype שצוין לאובייקט GUID.
guid any2Guid(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיש להמיר לאובייקט GUID. |
ערך החזרה
אובייקט GUID.
גוון תות
המרת ערך anytypeלערך int .
int any2Int(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיש להמיר. |
ערך החזרה
ערך int .
הערות
פרמטר האובייקט יכול להיות רוב סוגי הנתונים, אך אתה מקבל נתונים שימושיים רק כאשר אתה משתמש בפרמטרים של סוג enum, real או str.
דוגמה
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.
****/
נתי ת'ך
המרת אובייקט anytype לאובייקט int64 .
int64 any2Int64(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | אובייקט anytype להמרה. |
ערך החזרה
אובייקט int64 .
נאוה ת'ראל
המרת ערך anytypeלערך ממשי.
real any2Real(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיש להמיר. |
ערך החזרה
ערך אמיתי.
הערות
פרמטר האובייקט יכול להיות רוב סוגי הנתונים, אך אתה מקבל פלט שימושי עבור רכיבי קלט של סוגי התאריך,int, enumו- str.
דוגמה
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
****/
מחרוזת כלשהי2
המרת ערך anytype לערך Str .
str any2Str(anytype object)
פרמטרים
| פרמטר | תיאור |
|---|---|
| אובייקט | הערך שיש להמיר. |
ערך החזרה
ערך str .
הערות
פרמטר האובייקט יכול להיות רוב סוגי הנתונים, אך אתה מקבל פלט שימושי מרכיבים קלט של סוגי התאריך, ה- intוהספירה.
דוגמה
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
****/
תאריך כלשהו
ראה any2Date.
ת"א ת"א
ראה any2Enum.
אוה ת.ב.
ראה any2Guid.
גוון כלשהו
ראה any2Int.
נתי ת'ם
ראה any2Int64.
נאוה ת'ראל
ראה any2Real.
מיתוסים משויכת
ראה any2Str.
ערך תו2
המרת תו במחרוזת לערך ASCII של התו.
int char2Num(str text, int position)
פרמטרים
| פרמטר | תיאור |
|---|---|
| הודעת טקסט | המחרוזת המכילה את התו. |
| מיקום | מיקום התו במחרוזת. |
ערך החזרה
הערך ASCII של התו אובייקט int .
הערות
char2Num("ABCDEFG",3); //Returns the numeric value of C, which is 67.
char2Num("ABCDEFG",1); //Returns the numeric value of A, which is 65.
תאריך2 מספר
המרת תאריך למספר שלם התואם למספר הימים מאז 1 בינואר, 1900.
int date2Num(date _date)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _תמר | התאריך להמרה. |
ערך החזרה
מספר הימים בין 1 בינואר, 1900 לתאריך שצוין.
דוגמה
//Returns the value377.
date2Num(1311901);
static void date2NumExample(Args _arg)
{
date d = today();
int i;
i = date2Num(d);
print i;
}
תאריך2 מחרוזת
המרת התאריך שצוין למחרוזת.
str date2Str(date date, int sequence, int day, int separator1, int month, int separator2, int year [, int flags = DateFlags::None])
פרמטרים
| פרמטר | תיאור |
|---|---|
| תאריך | התאריך להמרה. |
| רצף | מספר בן שלוש ספרות המציין את הרצף עבור רכיבי התאריך: 1 עבור יום, 2 עבור חודש ו- 3 עבור שנה. |
| יום | ערך ספירה המציין את התבנית עבור רכיב היום של התאריך. |
| מפריד 1 | ערך ספירה המציין את המפריד לשימוש בין שני הרכיבים הראשונים של התאריך. |
| חודש | ערך ספירה המציין את התבנית עבור רכיב החודש של התאריך. |
| מפריד 2 | ערך ספירה המציין את המפריד לשימוש בין שני הרכיבים האחרונים של התאריך. |
| שנה | ערך ספירה המציין את התבנית עבור רכיב השנה של התאריך. |
| דגלים | ערך ספירה של DateFlags המציין אם יש להשתמש בהגדרות השפה במחשב המקומי כדי לחשב את הרצף המתאים משמאל לימין או מימין לשמאל במחרוזת המוחזרת. |
ערך החזרה
מחרוזת המייצגת את התאריך שצוין.
הערות
MorphX מקצה ערכים חוקיים לפרמטרים של העיצוב אם הערכים שצוינו אינם חוקיים. כדי להשתמש בתבנית התאריך שהמשתמש ציין בהגדרות אזוריות, השתמש בפונקציה strFmt או date2Str וציין -1 בכל הפרמטרים של העיצוב. כאשר ההגדרות האזוריות שולטות בתבנית התאריך, ההגדרות יכולות להשתנות ממשתמש למשתמש. אם -1 משמש עבור פרמטר מפריד , שני המפרידים מוגדרים כברירת מחדל להגדרות אזוריות. ערכי פרמטר הרצף חייבים להיות כל מספר בן שלוש ספרות המכיל מופע אחד בדיוק של כל ספרה 1, 2 ו- 3. הספרות 1, 2 ו- 3 מייצגות יום, חודש ושנה, בהתאמה. לדוגמה, 321 מפיק את שנת הרצף, החודש והיום. לחלופין, הערך יכול להיות -1 כדי להשתמש בהגדרות אזוריות. אל תשתמש בסוג ספירה עבור פרמטר זה, מכיוון שהמספרים, כגון 321, חורגים מטווח הערכים החוקיים עבור ערכי ספירה, שהם 0 עד 250, כולל. ערך ברירת המחדל של פרמטר הדגלים הוא ערך הספירה DateFlags::None, כלומר לא בוצע עיבוד רצף משמאל לימין או מימין לשמאל.
דוגמה
הדוגמה הבאה מציגה את התאריך הנוכחי ברצף השנה, החודש והיום.
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 למחרוזת.
str datetime2Str(utcdatetime datetime [, int flags = DateFlags::None])
פרמטרים
| פרמטר | תיאור |
|---|---|
| תאריך ושעה | ערך utcdatetime שיש להמיר. |
| דגלים | ערך ספירה של DateFlags המציין אם להשתמש בהגדרות מקומיות עבור פלט מימין לשמאל. |
ערך החזרה
מחרוזת המייצגת את ערך utcdatetime שאתה מציין בפרמטר datetime .
הערות
קלט תאריך-שעה Null
אם תציין את ערך utcdatetime המינימלי עבור הפרמטר datetime , הפונקציה datetime2Str מתייחסת אליו כערך קלט Null. ערך זה גורם לפונקציה להחזיר מחרוזת ריקה. פעולת השירות DateTimeUtil::minValue מחזירה את התאריך-שעה 1900-01-01T00:00:00. הפונקציה מתייחסת לערך מינימלי זה כ- Null.
הגדרות מקומיות מימין לשמאל
כברירת מחדל, פונקציה זו יוצרת את המחרוזת ברצף משמאל לימין, כאשר חלק השנה השמאלי ביותר. עם זאת, אם תגדיר את פרמטר הדגלים לערך הספירה DateFlags::FormatAll, הפונקציה תפיק את המחרוזת ברצף מימין לשמאל כאשר הגדרות מקומיות מוגדרות עבור מימין לשמאל. הגדרות אזוריות אינן משפיעות על התבנית של פעולת השירות toStr של המחלקה DateTimeUtil .
דוגמה
static void jobTestDatetime2str( Args _args )
{
utcdatetime utc2 = 1959-06-17T15:44:33;
str s3;
s3 = datetime2Str( utc2 );
info( s3 );
}
enum2Str
המרת הטקסט המונה שצוין לייצוג תווים.
str enum2Str(enum enum)
פרמטרים
| פרמטר | תיאור |
|---|---|
| enum | הטקסט המונה להמרה. |
ערך החזרה
ערך הספירה כמחרוזת.
דוגמה
הדוגמה הבאה מחזירה את המחרוזת "Not included". מחרוזת זו היא התווית עבור הערך IncludeNot של סוג הספירה ListCode .
static void enum2StrExample(Args _arg)
{
ListCode l;
l = ListCode::IncludeNot;
print enum2Str(l);
}
guid2Str
המרת אובייקט ה- GUID שצוין למחרוזת המקבילה.
str guid2String(guid _uuid)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _uuid | אובייקט ה- GUID להמרה. |
ערך החזרה
שווה הערך במחרוזת של אובייקט ה- GUID שצוין.
דוגמה
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
המרת מספר שלם למחרוזת המקבילה.
str int2Str(int integer)
פרמטרים
| פרמטר | תיאור |
|---|---|
| מספר שלם | המספר השלם להמרה. |
ערך החזרה
ייצוג מחרוזת של המספר השלם.
דוגמה
static void int2StrExample(Args _arg)
{
print "This is int2Str, value is " + int2Str(intMax());
print "This is int642Str, value is " + int642Str(int64Max());
}
int642Str
המרת הפרמטר של המספר השלם שצוין למחרוזת הטקסט המקבילה.
str int642Str(int64 integer)
פרמטרים
| פרמטר | תיאור |
|---|---|
| מספר שלם | ה- int64 להמרה למחרוזת. |
ערך החזרה
מחרוזת הטקסט המקבילה של פרמטר המספר השלם .
דוגמה
static void example()
{
print "This is int2Str, value is " + int2Str(intMax());
print "This is int642Str, value is " + int642Str(int64Max());
}
num2Char
המרת מספר שלם לתו ASCII המתאים.
str num2Char(int figure)
פרמטרים
| פרמטר | תיאור |
|---|---|
| איור | המספר השלם להמרה לתו. |
ערך החזרה
התו המתאים למספר השלם שצוין.
דוגמה
static void num2CharExample(Args _arg)
{
str s;
s = num2Char(42);
// Prints an asterisk * -the character represented by 42.
print s;
}
תאריך num2
מאחזר את התאריך המתאים למספר הימים שצוין לאחר 1 בינואר, 1900.
date num2Date(int _days)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _ימים | מספר הימים שלאחר 1 בינואר, 1900 שעבורם יש להחזיר את התאריך. הערה: התאריך החוקי הראשון הוא 1 בינואר, 1901. לכן, הפונקציה num2Date אינה מחזירה תאריך חוקי אלא אם _days גדול מ- 365. |
ערך החזרה
התאריך שהוא מספר הימים שצוינו על-ידי הפרמטר _days לאחר 1 בינואר, 1900.
הערות
num2Date(366); //Returns the date 01/01/1901 (1 January 1901).
num2Str
המרת מספר ממשי למחרוזת.
str num2Str(real number, int character, int decimals, int separator1, int separator2)
פרמטרים
| פרמטר | תיאור |
|---|---|
| מספר | המספר הממשי להמרה למחרוזת. |
| תו | מספר התווים המינימלי הנדרש בטקסט. |
| מקומות עשרוניים | המספר הנדרש של מקומות עשרוניים. |
| מפריד 1 | ערך ספירה של DecimalSeparator . |
| מפריד 2 | ערך ספירה של ThousandSeparator . |
ערך החזרה
מחרוזת המייצגת את המספר.
הערות
עבור הפרמטר decimals , הערך המרבי הוא 16. אם אתה משתמש במספר גדול יותר, פעולת השירות מקבלת ערך עבור הפרמטר decimals מהמחשב המקומי במקום זאת. בשני המקרים, מתרחש עיגול. להלן ערכי הספירה האפשריים עבור הפרמטר separator1 :
- 99 – אוטומטי (הגדרות העיצוב של המשתמש קובעות באיזה מפריד עשרוני יש להשתמש), ערך ספירה DecimalSeparator::Auto
- 1 – נקודה (.), ערך ספירה DecimalSeparator::D ot
- 2 – פסיק (,), ערך ספירה DecimalSeparator::פסיק
להלן הערכים האפשריים עבור הפרמטר separator2 :
- 99 – אוטומטי (הגדרות העיצוב של המשתמש לקבוע איזה מפריד אלפים משמש)
- 0 – None (no thousand separator), enumeration value ThousandSeparator::None
- 1 – Dot (.), ערך ספירה ThousandSeparator::D ot
- 2 – פסיק (,), ערך ספירה ThousandSeparator::פסיק
- 3 – גרש ('), ערך ספירה ThousandSeparator::Apostrophe
- 4 – רווח (), ערך ספירה ThousandSeparator::Space
דוגמה
בדוגמה הבאה של הקוד, השיחות הראשונות לפעולת השירות num2str מספקת 16 עבור הפרמטר decimals , והשיחה השניה מספקת 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
}
פלט
ההודעות נמצאות בפלט Infolog הבא. המספר הראשון בפלט מכיל 16 ספרות מקום עשרוני, בעוד שהמספר השני מכיל רק שתי ספרות מקום עשרוניות.
Message (10:18:12)
0.1294567890123457
0.13
תאריך str2
המרת המחרוזת שצוינה לערך תאריך.
date str2Date(str _text, str _sequence)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _טקסט | המחרוזת שיש להמיר לערך תאריך. |
| _רצף | מספר שלם בן שלוש ספרות המתאר את מיקומי היום, החודש והשנה במחרוזת שיש להמיר. |
ערך החזרה
ערך תאריך .
הערות
השתמש בערךים הבאים כדי לציין את מיקומי היום, החודש והשנה בפרמטר _sequence הבא:
- יום: 1
- חודש: 2
- שנה: 3
לדוגמה, אם הרצף במחרוזת הוא חודש, שנה ולאחר מכן יום, הפרמטר _sequence חייב להיות 231. מוחזר תאריך 0 (אפס) אם פרמטרי הקלט מציינים תאריך לא חוקי. שתי הדוגמאות הבאות מציינות תאריך לא חוקי.
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.
דוגמה
static void str2DateExample(Args _arg)
{
date d;
d = str2Date("22/11/2007", 123);
print d;
}
str2Datetime
יצירת ערך utcdatetime מהמחרוזת שצוינה של פרטי תאריך ושעה.
utcdatetime str2datetime( str text, int sequence )
פרמטרים
| פרמטר | תיאור |
|---|---|
| הודעת טקסט | המחרוזת שיש להמיר לערך utcdatetime . |
| רצף | מספר בן שלוש ספרות המתאר את הרצף של רכיבי התאריך בפרמטר הטקסט. |
ערך החזרה
ערך utcdatetime המייצג את התאריך והשעה שצוינו.
הערות
דרישות התחביר עבור חלק התאריך של פרמטר הטקסט הן גמישות. מגוון התבניות החוקיות זהה לפונקציה date2str . כל אחת מהקריאות הבאות ל- str2datetime חוקית, וכל אחת מהן מפיקה את אותו פלט.
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 );
כל רכיב של תאריך שעה מיוצג על-ידי ספרה בפרמטר הרצף :
- 1 – יום
- 2 – חודש
- 3 – שנה
לדוגמה, שנה, חודש, הזמנת יום היא 321. כל הערכים החוקיים מכילים כל אחת משלוש הספרות הללו פעם אחת בדיוק. אם הערך של פרמטר הרצף אינו חוקי, ההגדרות האזוריות משמשות לפענוח פרמטר טקסט הקלט. אם פרמטרי הקלט מתארים תאריך ושעה לא חוקיים, מוחזרת מחרוזת ריקה.
דוגמה
static void JobTestStr2datetime( Args _args )
{
utcdatetime utc3;
str sTemp;
utc3 = str2datetime( "1985/02/25 23:04:59" ,321 );
sTemp = datetime2str( utc3 );
print( "sTemp == " + sTemp );
}
362000 סטרונום, 1
מאחזר את רכיב enum שעבורו ערך המאפיין Label המותאם לשפות אחרות תואם למחרוזת הקלט.
enum str2Enum(enum _type, str _text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _סוג | משתנה שאתה מצהיר עליו כסוג enum . |
| _טקסט | טקסט המאפיין ' תווית' המותאם לשפות אחרות של רכיב היעד בספירה. |
ערך החזרה
רכיב של enum היעד, המייצג גם ערך int.
הערות
הפונקציה הקשורה enum2str מחזירה את הערך של מאפיין תווית מרכיב אחד ב- enum. הערך שהפונקציה enum2str מחזירה יכול להיות הקלט עבור הפרמטר _type של הפונקציה str2enum . ערך מתאים עבור הפרמטר _text הוא enum2Str(BankAccountType::SavingsAccount). לכל רכיב של enum יש מאפיין Nameומאפיין תווית. בהתקנה חדשה, ערכי Name הם כמעט תמיד מילים באנגלית. במהדורה האנגלית, ערך המאפיין Label זהה כמעט תמיד לערך Name . עם זאת, למהדורות שאינן באנגלית, ערכי התווית מתאימים לשפות אחרות ולכן אינם תואמים לערכים של Name.
דוגמה
כדי למנוע אי-התאמה של מחרוזות שהתאמה לשפות מדוברות אחרות גורמת לשפות מדוברות אחרות, השתמש בפונקציה enum2str כדי ליצור את הקלט בפונקציה str2enum . הדוגמה הבאה מציגה את הדרך המתאימה לשימוש בפונקציה str2enum יחד עם הפונקציה 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
**********/
}
עוגיית תות
המרת מחרוזת לאובייקט GUID.
Guid str2Guid(str text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| GUID | מחרוזת המייצגת GUID. |
ערך החזרה
GUID המייצג את מחרוזת הקלט.
הערות
לדוגמה, ערך חוקי עבור פרמטר ה- GUID הוא {12345678-1234-abCD-3456-123456789012}, עם או בלי המסולסלים.
גוון str2
המרת מחרוזת למספר השלם המקביל.
int str2Int(str _text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _טקסט | המחרוזת להמרה למספר שלם. |
ערך החזרה
המספר השלם המקביל של המחרוזת שצוינה.
דוגמה
static void str2IntExample(Args _arg)
{
int i;
i = str2Int("1234567890");
print "i = " + int2Str(i);
}
גוון 64
המרת מחרוזת לערך Int64 .
int str2Int64(str text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| הודעת טקסט | המחרוזת שיש להמיר. |
ערך החזרה
הערך Int64 של המחרוזת שצוינה.
דוגמה
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);
}
ערך str2
המרת מחרוזת למספר ממשי.
real str2Num(str _text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _טקסט | המחרוזת להמרה למספר ממשי. |
ערך החזרה
המספר הממשי אם המחרוזת שצוינה מכילה מספר חוקי; אחרת, 0 (אפס).
הערות
הדוגמאות הבאות מראים כיצד להשתמש בפונקציה זו.
str2Num("123.45") returns the value 123.45.
str2Num("a123") returns the value 0.0.
str2Num("123a") returns the value 123.00.
הסריקה מתרחשת משמאל לימין ומסתיימת כאשר לא ניתן להמיר תו לחלק ממספר ממשי.
דוגמה
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
המרת מחרוזת לערך timeOfDay .
int str2Time(str _text)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _טקסט | הזמן שבו יש להשתמש לחישוב מספר השניות מאז חצות. |
ערך החזרה
מספר השניות בין חצות והפרמטר _text ; אחרת, -1.
הערות
str2Time("05:01:37") //Returns the value 18097.
str2Time("7 o'clock") //Returns the value -1.
דוגמה
static void str2TimeExample(Args _arg)
{
int i;
i = str2Time("11:30");
print i;
}
time2Str
המרת ערך timeOfDay למחרוזת הכוללת שעות, דקות שניות.
str time2Str(int _time, int _separator, int _timeFormat)
פרמטרים
| פרמטר | תיאור |
|---|---|
| _זמן | ערך timeOfDay . |
| _מפריד | ערך ספירה של TimeSeparator המציין את התווים בין השעות, הדקות וה השניות במחרוזת הפלט. |
| _timeFormat | ערך ספירה של TimeFormat המציין אם שעון של 12 שעות או שעון של 24 שעות נמצא בשימוש. |
ערך החזרה
מחרוזת המייצגת את השעה שצוינה.
הערות
ערך הפרמטר _time הוא מספר השניות מאז חצות.
דוגמה
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
המרת מספר שלם למחרוזת. פונקציה זו מניחה שהמספר השלם אינו צוין.
str uint2Str(int integer)
פרמטרים
| פרמטר | תיאור |
|---|---|
| מספר שלם | המספר השלם להמרה. |
ערך החזרה
שווה הערך למחרוזת של המספר השלם שלא צוין.
הערות
השתמש בפונקציה זו במקום בפונקציה int2str עבור מספרים שלמים גדולים מאוד, כגון זהי רשומות.
info(int2str(3123456789)); //returns -1171510507 as a string.
info(uint2str(3123456789)); //returns 3123456789 as a string.