ภาคผนวก A: คำสงวน
รายการต่อไปนี้รวบรวมคำสงวน (keywords) ที่ถูกสงวนไว้สำหรับการใช้งานในปัจจุบันหรือในอนาคตของภาษา Rust ด้วยเหตุนี้ คำเหล่านี้จึงไม่สามารถนำมาตั้งเป็นตัวระบุหรือชื่อเรียก (identifiers) ได้ (ยกเว้นเมื่อใช้งานในรูปแบบ raw identifier ดังที่เราจะกล่าวถึงในหัวข้อ“ชื่อเรียกแบบ raw”) โดยคำว่า ตัวระบุ (identifiers) หมายถึงชื่อของฟังก์ชัน ตัวแปร พารามิเตอร์ ฟิลด์ของ struct มอดูล เครต (crate) ค่าคงที่ มาโคร (macro) ค่าสแตติก แอตทริบิวต์ (attribute) ชนิดข้อมูล เทรต (trait) หรือช่วงอายุ (lifetime)
คำสงวนที่ใช้อยู่ในปัจจุบัน
ต่อไปนี้คือรายการคำสงวนที่ใช้อยู่ในปัจจุบัน พร้อมคำอธิบายการทำงานของแต่ละคำ
as: ทำการแคสต์ชนิดข้อมูลพื้นฐาน, ช่วยแยกความกำกวมของเทรตเฉพาะที่มีไอเท็มนั้นอยู่ หรือใช้เปลี่ยนชื่อไอเท็มในสเตตเมนต์useasync: คืนค่าเป็นFutureแทนที่จะทำการบล็อกเธรด (thread) ปัจจุบันawait: พักการทำงานชั่วคราวไว้จนกว่าผลลัพธ์ของFutureจะพร้อมใช้งานbreak: ออกจากลูปการทำงานทันทีconst: นิยามค่าคงที่ หรือ raw pointer ที่เป็นค่าคงที่continue: ข้ามไปยังรอบถัดไปของลูปการทำงานcrate: ในพาธของมอดูล ใช้อ้างอิงถึงรูทของเครต (crate root)dyn: ส่งต่อการทำงานแบบไดนามิก (dynamic dispatch) ไปยังเทรตออบเจกต์ (trait object)else: ทางเลือกสำรองในโครงสร้างควบคุมทิศทางการทำงานแบบifและif letenum: นิยามประเภทข้อมูลแจงนับ (enumeration)extern: เชื่อมโยงฟังก์ชันหรือตัวแปรภายนอกfalse: ค่าลิเทอรัลเท็จของชนิดข้อมูลบูลีน (boolean)fn: นิยามฟังก์ชัน หรือชนิดข้อมูลพอยน์เตอร์ของฟังก์ชันfor: วนลูปประมวลผลสมาชิกจากอิเทอเรเตอร์ (iterator), อิมพลีเมนต์เทรต หรือระบุช่วงอายุแบบ higher-rankedif: แตกกิ่งการทำงานตามผลลัพธ์ของนิพจน์เงื่อนไขimpl: อิมพลีเมนต์ฟังก์ชันการทำงานเฉพาะตัว (inherent) หรือของเทรตin: ส่วนหนึ่งของไวยากรณ์ลูปforlet: ผูกค่าตัวแปรloop: วนลูปซ้ำแบบไม่มีเงื่อนไขmatch: จับคู่ค่ากับแพตเทิร์นmod: นิยามมอดูลmove: กำหนดให้โคลเชอร์ (closure) รับสิทธิ์ความเป็นเจ้าของในตัวแปรทั้งหมดที่แคปเจอร์มาmut: ระบุความสามารถในการเปลี่ยนแปลงค่า (mutability) ในการอ้างอิง, raw pointer หรือการผูกค่าแพตเทิร์นpub: กำหนดระดับการเข้าถึงเป็นแบบสาธารณะ (public) ในฟิลด์ของ struct, บล็อกimplหรือมอดูลref: ผูกค่าด้วยการอ้างอิง (reference)return: คืนค่าออกจากฟังก์ชันSelf: นามแฝงชนิดข้อมูลสำหรับชนิดข้อมูลที่เรากำลังนิยามหรืออิมพลีเมนต์อยู่self: ตัวรับของเมธอด (method subject) หรือมอดูลปัจจุบันstatic: ตัวแปรส่วนกลาง (global variable) หรือช่วงอายุที่คงอยู่ตลอดอายุการทำงานของโปรแกรมstruct: นิยามโครงสร้างข้อมูล (struct)super: มอดูลแม่ของมอดูลปัจจุบันtrait: นิยามเทรต (trait)true: ค่าลิเทอรัลจริงของชนิดข้อมูลบูลีนtype: นิยามนามแฝงชนิดข้อมูล (type alias) หรือชนิดข้อมูลร่วม (associated type)union: นิยาม union; ถือเป็นคำสงวนเฉพาะเมื่อใช้ในการประกาศ union เท่านั้นunsafe: ระบุโค้ด ฟังก์ชัน เทรต หรือการอิมพลีเมนต์ที่อาจไม่ปลอดภัย (unsafe)use: นำสัญลักษณ์ (symbols) เข้ามาสู่ขอบเขตการทำงาน (scope)where: ระบุข้อกำหนดเงื่อนไข (clauses) ที่ใช้จำกัดชนิดข้อมูลwhile: วนลูปตามเงื่อนไขโดยอิงจากผลลัพธ์ของนิพจน์
คำสงวนที่สงวนไว้สำหรับใช้ในอนาคต
คำสงวนต่อไปนี้ยังไม่มีฟังก์ชันการทำงานใด ๆ ในปัจจุบัน แต่ถูกสงวนไว้โดยภาษา Rust เผื่อสำหรับการใช้งานในอนาคต:
abstractbecomeboxdofinalgenmacrooverrideprivtrytypeofunsizedvirtualyield
ชื่อเรียกแบบ raw
ชื่อเรียกแบบ raw (raw identifiers) คือไวยากรณ์พิเศษที่ช่วยให้คุณสามารถนำคำสงวนมาใช้ในตำแหน่งที่ปกติแล้วไม่อนุญาตให้ใช้ได้ โดยใช้งานด้วยการใส่คำนำหน้า r# กำกับไว้หน้าคำสงวน
ตัวอย่างเช่น match เป็นคำสงวน หากคุณพยายามคอมไพล์ฟังก์ชันต่อไปนี้ที่ใช้ match เป็นชื่อของมัน:
ชื่อไฟล์: src/main.rs
fn match(needle: &str, haystack: &str) -> bool {
haystack.contains(needle)
}
คุณจะได้รับข้อผิดพลาดนี้:
error: expected identifier, found keyword `match`
--> src/main.rs:4:4
|
4 | fn match(needle: &str, haystack: &str) -> bool {
| ^^^^^ expected identifier, found keyword
ข้อผิดพลาดนี้แสดงให้เห็นว่าคุณไม่สามารถใช้คำสงวน match เป็นชื่อเรียกของฟังก์ชันได้ หากต้องการใช้ match เป็นชื่อฟังก์ชัน คุณต้องใช้ชื่อเรียกแบบ raw ดังนี้:
ชื่อไฟล์: src/main.rs
fn r#match(needle: &str, haystack: &str) -> bool {
haystack.contains(needle)
}
fn main() {
assert!(r#match("foo", "foobar"));
}
โค้ดชุดนี้จะคอมไพล์ผ่านได้โดยไม่มีข้อผิดพลาดใด ๆ สังเกตการใส่คำนำหน้า r# ที่ชื่อฟังก์ชัน ทั้งในจุดที่นิยามฟังก์ชันและจุดที่เรียกใช้ฟังก์ชันใน main
ชื่อเรียกแบบ raw ช่วยให้คุณสามารถเลือกใช้คำใดก็ได้เป็นตัวระบุ แม้ว่าคำนั้นจะตรงกับคำสงวนก็ตาม วิธีนี้ช่วยให้เรามีอิสระในการตั้งชื่อตัวระบุมากขึ้น และยังช่วยให้สามารถทำงานร่วมกับโปรแกรมที่เขียนด้วยภาษาอื่นที่คำเหล่านี้ไม่ได้เป็นคำสงวนได้เป็นอย่างดี นอกจากนี้ ชื่อเรียกแบบ raw ยังช่วยให้คุณสามารถเรียกใช้ไลบรารีที่เขียนขึ้นด้วยฉบับ (edition) ของ Rust ที่แตกต่างจากฉบับที่เครตของคุณใช้อยู่ได้ ตัวอย่างเช่น คำว่า try ไม่ได้เป็นคำสงวนในฉบับ 2015 แต่ถูกกำหนดเป็นคำสงวนในฉบับ 2018, 2021 และ 2024 หากคุณต้องพึ่งพาไลบรารีที่เขียนด้วยฉบับ 2015 ซึ่งมีฟังก์ชันชื่อ try คุณจะต้องใช้ไวยากรณ์ชื่อเรียกแบบ raw ในรูปแบบ r#try เพื่อเรียกใช้งานฟังก์ชันดังกล่าวจากโค้ดของคุณในฉบับที่ใหม่กว่า สามารถดูรายละเอียดเพิ่มเติมเกี่ยวกับฉบับต่าง ๆ ของ Rust ได้ในภาคผนวก E