ฟังก์ชันเวลาที่รันสตริงของ X++

Note

กลุ่มที่น่าสนใจของชุมชนได้ย้ายจาก Yammer ไปยัง Microsoft Viva Engage แล้ว หากต้องการเข้าร่วมชุมชน Viva Engage และเข้าร่วมในการสนทนาล่าสุด ให้กรอก แบบฟอร์ม คําขอการเข้าถึงการเงินและการดําเนินงาน Viva Engage Community และเลือกชุมชนที่คุณต้องการเข้าร่วม

บทความนี้อธิบายฟังก์ชันรันไทม์สตริง

ไม้ขีดไฟ

ค้นหาสตริงหรือนิพจน์ในสตริงอื่น

int match(str pattern, str text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
รูปแบบ	สตริงหรือนิพจน์ที่จะค้นหา
SMS	สตริงสําหรับค้นหา

ค่าที่ส่งกลับ

1 ถ้ารูปแบบอยู่ในสตริง มิฉะนั้น 0 (ศูนย์)

หมายเหตุ

การค้นหาต้องตรงตามตัวพิมพ์ใหญ่-เล็ก คุณสามารถใช้อักขระพิเศษต่อไปนี้เพื่อสร้างรูปแบบสําหรับพารามิเตอร์ รูปแบบ ได้

\: เครื่องหมายแบคสแลช (\) ทําเป็น null หรือหลีก การปฏิบัติพิเศษของอักขระพิเศษเพื่อให้สามารถจับคู่อักขระพิเศษได้เหมือนตัวอักษรปกติ เครื่องหมายทับขวาหนึ่งคู่จะถูกแปลเป็นเครื่องหมายทับขวาหนึ่งเครื่องหมาย ตัวอย่าง:
- match("ab$cd","ab$cd"); ส่งกลับ 0
- match("ab\$cd","ab$cd"); ส่งกลับ 0 เครื่องหมายทับขวาไม่หลีก
- match("ab\\$cd","ab$cd"); ส่งกลับ 1 เครื่องหมายแบคสแลชและดอลลาร์หลบหนีได้
< หรือ ^: วงเล็บมุมซ้าย (<) หรือเครื่องหมาย circumflex (^) ที่จุดเริ่มต้นของนิพจน์จะถูกใช้เพื่อให้ตรงกับจุดเริ่มต้นของบรรทัด ตัวอย่าง:
- match("<abc","abcdef"); ส่งกลับ 1
- match("<abc","defabc"); ให้ผลลัพธ์เป็น 0
- match("^abc","abcdef"); ส่งกลับ 1
- match("^abc","defabc"); ส่งกลับ 0
> หรือ $: วงเล็บมุมขวา (>) หรือเครื่องหมายดอลลาร์ ($) ที่ส่วนท้ายของนิพจน์จะถูกใช้เพื่อให้ตรงกับจุดสิ้นสุดของบรรทัด ตัวอย่าง:
- match("abc>","abcdef"); ให้ผลลัพธ์เป็น 0
- match("abc>","defabc"); ให้ผลลัพธ์เป็น 1
? หรือ : เครื่องหมายคําถาม (?) หรือมหัพภาค (.) ตรงกับอักขระใดอักขระหนึ่งในตําแหน่งเดียวกัน ตัวอย่าง:
- match("abc.def","abc#def"); ส่งกลับ 1
- match("colou?r","colouXr"); ส่งกลับ 1
:x: เครื่องหมายทวิภาค (:) ระบุกลุ่มของอักขระที่จะจับคู่ ตามที่ระบุโดยอักขระต่อไปนี้ทันที
:a: ตั้งค่าการจับคู่เป็นตัวอักษร ตัวอย่าง:
- match("ab:acd","ab#cd"); ส่งกลับ 0
- match("ab:acd", "abxyzcd"); ส่งกลับ 0
- match("ab:acd","abxcd"); ส่งกลับ 1
:d: ตั้งค่าจับคู่กับอักขระตัวเลข ตัวอย่าง:
- match("ab:dcd","ab3cd"); ส่งกลับ 1
- match("ab:dcd","ab123cd"); ส่งกลับ 0
- match("ab:dcd","abcd"); ส่งกลับ 0
:n: ตั้งค่าการจับคู่เป็นอักขระพยัญชนะผสมตัวเลข ตัวอย่าง:
- match("ab:ncd","ab%cd"); ส่งกลับ 0
- match("ab:ncd","ab9cd"); ส่งกลับ 1
- match("ab:ncd","abXcd"); ส่งกลับ 1
:SPACE: SPACE เป็นอักขระเว้นวรรค (" ") ตั้งค่าการจับคู่ให้ตรงกับช่องว่าง การเรียงแท็บ และอักขระตัวควบคุม เช่น Enter (บรรทัดใหม่) ตัวอย่าง:
- match("ab: cd", "ab cd"); ส่งกลับ 1
- match("ab: cd","ab\ncd") ส่งกลับ 1
- match("ab: cd","ab\tcd"); ส่งกลับ 1
- match("ab: cd", "ab cd"); ส่งกลับ 0 เฉพาะช่องว่างแรกเท่านั้นที่จะถูกจับคู่
*: นิพจน์ที่ตามด้วยเครื่องหมายดอกจัน ("*") จําเป็นต้องมีการจับคู่สําหรับศูนย์ การปรากฏอย่างน้อยหนึ่งครั้งของนิพจน์ก่อนหน้า ตัวอย่าง:
- match("abc*d","abd"); ส่งกลับ 1
- match("abc*d","abcd"); ส่งกลับ 1
- match("abc*d","abcccd"); ส่งกลับ 1
- match("abc*d","abxd"); ส่งกลับ 0
+: นิพจน์ที่ตามด้วยเครื่องหมายบวก (+) จําเป็นต้องตรงกับการปรากฏอย่างน้อยหนึ่งครั้งของนิพจน์ก่อนหน้า ตัวอย่าง:
- match("abc+d","abd"); ส่งกลับ 0
- match("abc+d","abcd"); แสดง 1
- match("abc+d","abcccd"); ส่งกลับ 1
- match("abc+d","abxd"); ส่งกลับ 0
-: นิพจน์ที่ตามด้วยเครื่องหมายลบ (-) จําเป็นต้องมีการจับคู่สําหรับศูนย์หรือการปรากฏหนึ่งครั้งของนิพจน์ก่อนหน้า กล่าวอีกนัยหนึ่ง นิพจน์ก่อนหน้าเป็นทางเลือก ตัวอย่าง:
- match("colou-r", "color"); ส่งกลับ 1
- match("colou-r", "สี"); ส่งกลับ 1
[]: จับคู่อักขระเดี่ยวกับอักขระใดๆ ที่อยู่ในวงเล็บปีกกา ช่วงของอักขระสามารถระบุด้วยอักขระสองตัวที่คั่นด้วยเครื่องหมายลบ (-) ตัวอย่างเช่น [a-z] จับคู่ตัวอักษรทั้งหมดระหว่าง a และ z [0-9] จับคู่ตัวเลข และ [0-9a-f] ตรงกับตัวเลขฐานสิบหก ตัวอย่าง:
- match("[abc]","apple"); แสดงค่า 1 เนื่องจากตรงกับ ใน "apple"
- match("[abc]","kiwi"); แสดง ค่า 0 เนื่องจาก "กีวี" ไม่มี a, b หรือ c
- match("gr[ae]y","grey"); ส่งกลับ 1 นิพจน์นี้ตรงกับ "สีเทา" ด้วย
- match("gr[ae]y","graey"); แสดง ค่า 0 เนื่องจากมีอักขระระหว่าง "gr" และ "y" เดียวเท่านั้นที่จับคู่
[^]: ถ้าอักขระตัวแรกในข้อความที่อยู่ในวงเล็บเป็นเครื่องหมายวงเล็บ (^) นิพจน์จะตรงกับอักขระทั้งหมดยกเว้นอักขระที่อยู่ในเครื่องหมายวงเล็บ ตัวอย่าง:
- match("[^bc]at","bat"); ส่งกลับ 0
- match("[^bc]at","hat"); ส่งกลับ 1
- match("[^abc]","bat"); ส่งกลับ 1 อะไรก็ได้ยกเว้น a, b หรือ c จับคู่อยู่ ดังนั้น t จึงตรงกัน

strAlpha

คัดลอกเฉพาะอักขระพยัญชนะผสมตัวเลขจากสตริง

str strAlpha(str _text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะคัดลอกมา

ค่าที่ส่งกลับ

สตริงใหม่ที่มีอักขระพยัญชนะผสมตัวเลขทั้งหมดจากสตริงที่ระบุ

หมายเหตุ

ตัวอย่างเช่น strAlpha("2+2=5 ถูกต้องหรือไม่") ส่งกลับสตริง 225isthiscorrect

ตัวอย่าง

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

เปรียบเทียบสองสตริงข้อความ

int strCmp(str text1, str text2)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
text1	สตริงแรก
text2	สตริงที่สอง

ค่าที่ส่งกลับ

0 ถ้าสตริงทั้งสองเหมือนกัน 1 ถ้าสตริงแรกเรียงลําดับก่อนหน้า หรือ -1 ถ้าสตริงที่สองเรียงลําดับก่อนหน้า

หมายเหตุ

การเปรียบเทียบที่ทําโดยวิธีนี้เป็นแบบไวต่ออักษรใหญ่-เล็ก

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

แปลงอักขระตัวพิมพ์ใหญ่ทั้งหมดเป็นอักขระตัวพิมพ์เล็ก และแปลงอักขระทั้งหมดที่มีเครื่องหมายเน้นให้กับอักขระตัวพิมพ์เล็กที่ไม่ระบุตําแหน่งที่สอดคล้องกัน

str strColSeq(str text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
SMS	สตริงที่จะคัดลอกและแปลงอักขระ

ค่าที่ส่งกลับ

สตริงข้อความที่แปลงแล้ว

หมายเหตุ

มีฟังก์ชัน strColSeq อยู่เพื่อวัตถุประสงค์ความเข้ากันได้ย้อนหลัง ฟังก์ชันนี้สนับสนุนเฉพาะการแมปสําหรับอักขระยุโรปตะวันตกต่อไปนี้เท่านั้น:

พนักงาน ÖPQRSTUùúûüùÚÛÜVWXYýÝZæøåÆØÅ
สําหรับคําอธิบายเกี่ยวกับหมวดหมู่หมวดหมู่สินค้าที่เกี่ยวข้องกับ uwxyz~¦Ç~¦Ç~¦

สําหรับฟังก์ชันการทํางานที่ตรงตามมาตรฐาน Unicode ให้ใช้อินเทอร์เฟซการเขียนโปรแกรมแอปพลิเคชัน Win32 LCMapString (API) ผ่านคลาส DLL และ DLLFunc

ตัวอย่าง

ตัวอย่างต่อไปนี้พิมพ์ abcdeabcde

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

สร้างสําเนาของสตริงที่ลบสตริงย่อยที่ระบุออก

str strDel(str _text, int _position, int _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะคัดลอกมา
_ฐานะ	ตําแหน่งที่เริ่มละเว้นอักขระในระหว่างการดําเนินการคัดลอก
_เลข	จํานวนอักขระที่จะละเว้น เครื่องหมายลบที่ด้านหน้าของพารามิเตอร์ _number ระบุว่าอักขระ _number–1 ตัวก่อนอักขระที่ _position ควรนําออกพร้อมกับอักขระที่_position

ค่าที่ส่งกลับ

อักขระที่เหลือซึ่งคัดลอกจากสตริง

หมายเหตุ

ฟังก์ชัน strDel เสริมกับฟังก์ชันสตริงย่อย

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

ค้นหาสตริงสําหรับการปรากฏครั้งแรกของหนึ่งในอักขระที่ระบุ

int strFind(str _text, str _characters, int _position, int _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงสําหรับค้นหา
_อักขระ	อักขระสําหรับค้นหา
_ฐานะ	ตําแหน่งในสตริงที่การค้นหาเริ่มต้น
_เลข	หมายเลขที่มีเครื่องหมายที่ระบุทิศทางของการค้นหาและจํานวนตําแหน่งที่จะค้นหาในสตริง

ค่าที่ส่งกลับ

ค่าของตําแหน่งการปรากฏครั้งแรกของอักขระที่ระบุตัวใดตัวหนึ่ง หรือ 0 เมื่อไม่พบ

หมายเหตุ

หากต้องการค้นหาจากจุดเริ่มต้นของสตริงไปยังจุดสิ้นสุด ให้ใช้ 1 เป็นค่าของพารามิเตอร์ _position หากค่าของพารามิเตอร์ _number เป็นค่าลบ ระบบจะค้นหาจํานวนอักขระย้อนกลับจากตําแหน่งที่ระบุ การค้นหาไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก นี่คือตัวอย่าง

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

ฟังก์ชัน strFind เสริมกับฟังก์ชัน strNFind

strFmt

จัดรูปแบบสตริงที่ระบุและแทนที่การปรากฏใด ๆ ของ n ด้วยอาร์กิวเมนต์ n

str strFmt(str _string, ...)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_เชือก	สตริงที่จะจัดรูปแบบ

ค่าที่ส่งกลับ

สตริงที่จัดรูปแบบ

หมายเหตุ

ถ้าไม่ได้ระบุอาร์กิวเมนต์สําหรับพารามิเตอร์ พารามิเตอร์จะแสดงเป็น "%n" ในสตริง การแปลงสตริงของค่าชนิด จริง จะถูกจํากัดไว้ที่ตําแหน่งทศนิยมสองตําแหน่ง ค่าจะถูกปัดเศษ ไม่ถูกปัดเศษทิ้ง เมธอด System.String:Format จาก Microsoft .NET Framework สามารถใช้เพื่อรับฟังก์ชันการทํางานเพิ่มเติมได้ ดังที่แสดงในตัวอย่าง

ตัวอย่าง

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

strIns

สร้างสตริงโดยการแทรกสตริงหนึ่งลงในอีกสตริงหนึ่ง

str strIns(str _text1, str _text2, int _position)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_text1	สตริงที่จะแทรกสตริงอื่นๆ ลงไป
_text2	สตริงที่จะแทรกลงในสตริงอื่น ๆ
_ฐานะ	ตําแหน่งที่อักขระแรกของพารามิเตอร์ _text2 ควรเกิดขึ้นในสตริงผลลัพธ์

ค่าที่ส่งกลับ

สตริงข้อความรวม

หมายเหตุ

ฟังก์ชัน strIns เสริมกับฟังก์ชัน strDel ถ้าค่าของพารามิเตอร์ _position มากกว่าความยาวของสตริงต้นฉบับ สตริงที่จะแทรกจะถูกผนวกเข้ากับส่วนท้ายของสตริงต้นฉบับ

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

สร้างสตริงโดยใช้เฉพาะอักขระจากสตริงที่ป้อนเข้าแรกที่สตริงป้อนเข้าที่สองระบุควรถูกเก็บไว้

str strKeep(str _text1, str _text2)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_text1	สตริงที่มีอักขระที่สามารถใช้เพื่อสร้างสตริงผลลัพธ์
_text2	สตริงที่ระบุอักขระที่จะเก็บไว้สําหรับสตริงผลลัพธ์

ค่าที่ส่งกลับ

สตริงของอักขระที่เก็บไว้

หมายเหตุ

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

ฟังก์ชัน strKeep เสริมด้วยฟังก์ชัน strRem

strLen

คํานวณความยาวของสตริงที่ระบุ

int strLen(str text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
SMS	สตริงที่จะคํานวณความยาวของ

ค่าที่ส่งกลับ

ความยาวของสตริงที่ระบุ

หมายเหตุ

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

strLine

ดึงข้อมูลบรรทัดเดียวจากสตริงที่ครอบคลุมหลายบรรทัด

str strLine(str string, int count)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
สตริง	สตริงที่อาจขยายหลายบรรทัด
นับ	ออฟเซตของรายการที่จะแสดง

ค่าที่ส่งกลับ

บรรทัดที่คัดลอกของสตริงที่ระบุโดยพารามิเตอร์สตริง

หมายเหตุ

บรรทัดแรกของสตริงมีออฟเซตของ 0 คุณสามารถกําหนดหลายบรรทัดให้กับสตริงเดียวได้โดยการฝังอักขระ \n หรือ \r\n ในสตริง นอกจากนี้ คุณยังสามารถใช้เครื่องหมาย at (@) ได้ทันทีก่อนเครื่องหมายอัญประกาศเปิด และใช้แป้น Enter เพื่อกระจายส่วนของค่าสตริงสําหรับหลายบรรทัดในตัวแก้ไขรหัส X++

ตัวอย่าง

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);

strLTrim

ลบช่องว่างนําหน้าออกจากสตริงข้อความ

str strLTrim(str text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
SMS	สตริงที่จะลบช่องว่างนําหน้าออก

ค่าที่ส่งกลับ

สตริงที่เทียบเท่ากับข้อความที่นําหน้าช่องว่างถูกเอาออกแล้ว

หมายเหตุ

ฟังก์ชัน strLTrim เสริมกับฟังก์ชัน strRTrim

ตัวอย่าง

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

strLwr

แปลงตัวอักษรทั้งหมดในสตริงที่ระบุเป็นตัวพิมพ์เล็ก

str strLwr(str _text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะแปลงเป็นตัวพิมพ์เล็ก

ค่าที่ส่งกลับ

สําเนาของสตริงที่ระบุที่มีเพียงตัวอักษรพิมพ์เล็กเท่านั้น

หมายเหตุ

ฟังก์ชัน strLwr เสริมกับฟังก์ชัน strUpr ฟังก์ชัน strLwr ใช้ฟังก์ชัน LCMapString ใน Win32 API

ตัวอย่าง

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

ค้นหาส่วนของสตริงข้อความสําหรับการปรากฏครั้งแรกของอักขระที่ไม่ได้รวมอยู่ในรายการอักขระที่ระบุ

int strNFind(str _text, str _characters, int _position, int _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงข้อความที่จะค้นหา
_อักขระ	รายการของอักขระที่จะแยกออกจากการค้นหา
_ฐานะ	ตําแหน่งในสตริงที่จะเริ่มต้นการค้นหา
_เลข	หมายเลขที่มีเครื่องหมายที่ระบุทิศทางของการค้นหาและจํานวนตําแหน่งที่จะค้นหา ถ้าเครื่องหมายลบนําหน้า_number ระบบจะค้นหาอักขระ_number ในลําดับย้อนกลับจาก_position

ค่าที่ส่งกลับ

ตําแหน่งการปรากฏครั้งแรกของอักขระที่ไม่ได้ระบุโดยพารามิเตอร์ _characters หรือ 0 เมื่อไม่พบ

หมายเหตุ

การค้นหาไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก หากต้องการค้นหาจากจุดเริ่มต้นของสตริงไปยังจุดสิ้นสุด ให้ใช้ค่า 1 สําหรับพารามิเตอร์ _position หากเครื่องหมายลบนําหน้าค่าของพารามิเตอร์_number อักขระจะถูกค้นหาในลําดับย้อนกลับ โดยเริ่มต้นจากตําแหน่งที่ระบุโดยพารามิเตอร์_position

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

ฟังก์ชัน strNFind เสริมกับฟังก์ชัน strFind

strPoke

เขียนทับส่วนหนึ่งของสตริงด้วยสตริงอื่น

str strPoke(str _text1, str _text2, int _position)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_text1	สตริงเดิม
_text2	สตริงที่จะแทนที่ส่วนหนึ่งของสตริงเดิมด้วย
_ฐานะ	ตําแหน่งของสตริงเดิมที่จะเริ่มแทนที่อักขระ

ค่าที่ส่งกลับ

สตริงใหม่

หมายเหตุ

สตริงใหม่สามารถยาวกว่าสตริงเดิมได้ อย่างไรก็ตาม หากค่าของพารามิเตอร์ _position มากกว่าความยาวของสตริง สตริงต้นฉบับจะถูกส่งกลับโดยไม่มีการแทนที่

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

ผนวกสตริงด้วยจํานวนอักขระเครื่องหมายมหัพภาคตามด้วยอักขระเครื่องหมายทวิภาคและช่องว่าง

str strPrompt(str _string, _int len)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_เชือก	สตริงเดิม
_เลน	ความยาวสุดท้ายที่ต้องการของสตริง

ค่าที่ส่งกลับ

สตริงที่มีลักษณะเหมือนพร้อมท์สําหรับการป้อนข้อมูลของผู้ใช้

หมายเหตุ

ในกรณีที่ผิดปกติที่ค่าของพารามิเตอร์ _len มากกว่าความยาวของสตริงดั้งเดิมเล็กน้อยเท่านั้นความสําคัญสูงสุดจะถูกกําหนดเพื่อเพิ่มช่องว่างต่อท้าย ถัดไป ที่กําหนดลําดับความสําคัญเป็นเครื่องหมายทวิภาค ลําดับความสําคัญต่ําสุดจะถูกกําหนดให้กับรอบระยะเวลา ค่าลบสําหรับพารามิเตอร์ _len ส่งกลับสตริงอินพุตที่ต่อท้ายด้วยช่องว่างต่อท้าย

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

ตัวอย่าง

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

ลบอักขระที่ระบุในสตริงหนึ่งออกจากสตริงอื่น

str strRem(str text1, str text2)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
text1	สตริงที่จะลบอักขระออก
text2	อักขระที่จะแยกออกจากสตริงผลลัพธ์

ค่าที่ส่งกลับ

เนื้อหาที่เหลืออยู่ของสตริงต้นฉบับ

หมายเหตุ

ฟังก์ชันนี้เป็นแบบไวต่ออักษรใหญ่-เล็ก

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

ฟังก์ชันนี้เสริมด้วยฟังก์ชัน strKeep

strRep

ทําซ้ําสตริงของอักขระ

str strRep(str _text, str _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะทําซ้ํา
_เลข	จํานวนครั้งในการทําซ้ําสตริง

ค่าที่ส่งกลับ

สตริงใหม่ที่มีเนื้อหาของสตริงต้นฉบับที่ทําซ้ําตามจํานวนครั้งที่ระบุ

ตัวอย่าง

ตัวอย่างต่อไปนี้พิมพ์สตริงข้อความ ABABABAB

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

เอาอักขระช่องว่างต่อท้ายออกจากส่วนท้ายของสตริง

str strRTrim(str _text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะลบอักขระช่องว่างต่อท้ายออก

ค่าที่ส่งกลับ

สําเนาของสตริงที่ระบุที่ไม่มีอักขระช่องว่างต่อท้าย

หมายเหตุ

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

ฟังก์ชัน strRTrim เสริมเข้ากับฟังก์ชัน strLTrim

strScan

ค้นหาสตริงข้อความสําหรับการปรากฏของสตริงอื่น

int strScan(str _text1, str _text2, int _position, int _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_text1	สตริงที่จะค้นหา
_text2	สตริงที่จะค้นหา
_ฐานะ	ตําแหน่งแรกในพารามิเตอร์ _text1 ที่จะทําการเปรียบเทียบ
_เลข	จํานวนตําแหน่งในพารามิเตอร์ _text1 เพื่อลองการเปรียบเทียบใหม่ ถ้าเครื่องหมายลบนําหน้าพารามิเตอร์ _number ระบบจะค้นหาจํานวนอักขระในลําดับย้อนกลับจากตําแหน่งที่ระบุ

ค่าที่ส่งกลับ

ตําแหน่งที่พบสตริงที่ระบุในสตริง มิฉะนั้น 0 (ศูนย์)

หมายเหตุ

การเปรียบเทียบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก ค่าสําหรับพารามิเตอร์_position ที่น้อยกว่า 1 จะถือว่าเป็น 1 ทิศทางของการสแกนจะถูกควบคุมด้วยเครื่องหมายที่ระบุในพารามิเตอร์_number เครื่องหมายบวกระบุว่าการเปรียบเทียบที่ต่อเนื่องกันแต่ละครั้งจะเริ่มต้นหนึ่งตําแหน่งใกล้กับจุดสิ้นสุดของสตริงมากขึ้น เครื่องหมายลบแสดงว่าการเปรียบเทียบแต่ละรายการเริ่มต้นที่ตําแหน่งหนึ่งใกล้กับจุดเริ่มต้นของสตริงมากขึ้น

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

แปลงตัวอักษรทั้งหมดในสตริงเป็นตัวพิมพ์ใหญ่

str strUpr(str _text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงที่จะแปลงเป็นตัวอักษรตัวพิมพ์ใหญ่

ค่าที่ส่งกลับ

สําเนาของสตริงที่ระบุที่มีเพียงตัวอักษรพิมพ์เล็กเท่านั้น

หมายเหตุ

ฟังก์ชัน strUpr เสริมกับฟังก์ชัน strLwr ฟังก์ชัน strUpr ใช้ฟังก์ชัน LCMapString() ใน Win32 API

ตัวอย่าง

ตัวอย่างต่อไปนี้พิมพ์ ABCDD55EFGHIJ

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

subStr

เรียกใช้ส่วนของสตริง

str subStr(str _text, int _position, int _number)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงเดิม
_ฐานะ	ตําแหน่งในสตริงเดิมที่ส่วนที่จะเรียกใช้เริ่มต้น
_เลข	จํานวนเต็มที่มีเครื่องหมายที่ระบุทิศทางและจํานวนตําแหน่งที่จะดึงมาจากสตริงเดิม ถ้าเครื่องหมายลบนําหน้า _number ระบบจะเลือกสตริงย่อยย้อนกลับจากตําแหน่งที่ระบุ

ค่าที่ส่งกลับ

สตริงย่อยของสตริงเดิม

หมายเหตุ

ถ้าเครื่องหมายลบนําหน้าค่าของพารามิเตอร์ _number สตริงย่อยจะถูกเลือกย้อนกลับจากตําแหน่งที่ระบุ

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

ตรวจสอบว่าสตริงข้อความมีสตริงอื่นหรือไม่

boolean strContains(str _text, str _potentialContains)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_ข้อความ	สตริงเดิมที่จะค้นหา
_potentialContains	สตริงที่จะค้นหา

ค่าที่ส่งกลับ

True ถ้าสตริงเดิมประกอบด้วยสตริงที่ค้นหา มิฉะนั้น เป็นเท็จ

หมายเหตุ

การเปรียบเทียบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

ตรวจสอบว่าสตริงข้อความเริ่มต้นด้วยสตริงอื่นหรือไม่

boolean strStartsWith(str _string, str _potentialStart)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_เชือก	สตริงเดิมที่จะค้นหา
_potentialStart	สตริงที่เป็นไปได้ที่อยู่ในตอนแรก

ค่าที่ส่งกลับ

จริง ถ้าสตริงที่เป็นไปได้คือจุดเริ่มต้นของสตริงต้นฉบับ มิฉะนั้น เป็นเท็จ

หมายเหตุ

การเปรียบเทียบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

ตรวจสอบว่าสตริงข้อความลงท้ายด้วยสตริงอื่นหรือไม่

boolean strEndsWith(str _string, str _potentialEnd)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
_เชือก	สตริงเดิมที่จะค้นหา
_potentialEnd	สตริงที่เป็นไปได้ที่อยู่ในตอนท้าย

ค่าที่ส่งกลับ

จริง ถ้าสตริงที่เป็นไปได้จะลงท้ายสตริงเดิม มิฉะนั้น เป็นเท็จ

หมายเหตุ

การเปรียบเทียบไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

ลบช่องว่างนําหน้าและหางออกจากสตริงข้อความ

str strLRTrim(str text)

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
SMS	สตริงที่จะลบช่องว่างนําหน้าและหาง

ค่าที่ส่งกลับ

สําเนาของสตริงที่ระบุที่ไม่มีอักขระช่องว่างนําหน้าและต่อท้าย

หมายเหตุ

ฟังก์ชัน strLRTrim เสริมด้วยฟังก์ชัน strRTrim และ strLTrim

ตัวอย่าง

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");

คำติชม

หน้านี้มีประโยชน์หรือไม่

Last updated on 2025-11-07

แชร์ผ่าน

ฟังก์ชันเวลาที่รันสตริงของ X++

ไม้ขีดไฟ

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strAlpha

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strCmp

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strColSeq

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strDel

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strFind

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strFmt

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strIns

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strKeep

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strLen

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strLine

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strLTrim

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strLwr

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strNFind

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strPoke

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strPrompt

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

ตัวอย่าง

strRem

พารามิเตอร์

ค่าที่ส่งกลับ

หมายเหตุ

strRep

พารามิเตอร์

ค่าที่ส่งกลับ