ภาคผนวก B: ตัวดำเนินการและสัญลักษณ์
ภาคผนวกนี้รวบรวมอภิธานศัพท์ไวยากรณ์ (syntax) ของภาษา Rust ซึ่งครอบคลุมทั้งตัวดำเนินการ (operators) และสัญลักษณ์ (symbols) อื่น ๆ ที่ปรากฏแบบเดี่ยว ๆ หรือใช้ในบริบทของพาธ (paths), เจเนอริก (generics), ข้อกำหนดเทรต (trait bounds), มาโคร (macros), แอตทริบิวต์ (attributes), คอมเมนต์ (comments), ทูเพิล (tuples) และวงเล็บรูปแบบต่าง ๆ
ตัวดำเนินการ
ตารางที่ B-1 รวบรวมตัวดำเนินการต่าง ๆ ใน Rust พร้อมตัวอย่างการใช้งานในบริบท คำอธิบายโดยสังเขป และระบุว่าตัวดำเนินการนั้นสามารถโอเวอร์โหลด (overload) ได้หรือไม่ หากสามารถโอเวอร์โหลดได้ จะระบุเทรตที่เกี่ยวข้องซึ่งใช้ในการโอเวอร์โหลดตัวดำเนินการดังกล่าวไว้ด้วย
ตารางที่ B-1: ตัวดำเนินการ
| ตัวดำเนินการ | ตัวอย่าง | คำอธิบาย | โอเวอร์โหลดได้หรือไม่ |
|---|---|---|---|
! | ident!(...), ident!{...}, ident![...] | การขยายมาโคร | |
! | !expr | การกลับบิตหรือนิเสธเชิงตรรกะ | Not |
!= | expr != expr | การเปรียบเทียบความไม่เท่ากัน | PartialEq |
% | expr % expr | เศษจากการหารทางคณิตศาสตร์ | Rem |
%= | var %= expr | เศษจากการหารทางคณิตศาสตร์พร้อมกำหนดค่า | RemAssign |
& | &expr, &mut expr | การยืมค่า | |
& | &type, &mut type, &'a type, &'a mut type | ชนิดพอยน์เตอร์อ้างอิงที่ถูกยืม | |
& | expr & expr | AND ระดับบิต | BitAnd |
&= | var &= expr | AND ระดับบิตพร้อมกำหนดค่า | BitAndAssign |
&& | expr && expr | AND เชิงตรรกะแบบลัดวงจร | |
* | expr * expr | การคูณทางคณิตศาสตร์ | Mul |
*= | var *= expr | การคูณทางคณิตศาสตร์พร้อมกำหนดค่า | MulAssign |
* | *expr | การดีเรเฟอเรนซ์ (dereference) | Deref |
* | *const type, *mut type | พอยน์เตอร์ดิบ | |
+ | trait + trait, 'a + trait | ข้อกำหนดชนิดข้อมูลแบบผสม | |
+ | expr + expr | การบวกทางคณิตศาสตร์ | Add |
+= | var += expr | การบวกทางคณิตศาสตร์พร้อมกำหนดค่า | AddAssign |
, | expr, expr | ตัวคั่นอาร์กิวเมนต์และสมาชิก | |
- | - expr | การกลับค่าเป็นลบทางคณิตศาสตร์ | Neg |
- | expr - expr | การลบทางคณิตศาสตร์ | Sub |
-= | var -= expr | การลบทางคณิตศาสตร์พร้อมกำหนดค่า | SubAssign |
-> | fn(...) -> type, |…| -> type | ชนิดข้อมูลของค่าที่คืนกลับสำหรับฟังก์ชันและโคลเชอร์ (closure) | |
. | expr.ident | การเข้าถึงฟิลด์ | |
. | expr.ident(expr, ...) | การเรียกใช้เมธอด | |
. | expr.0, expr.1 และอื่นๆ | การเข้าถึงสมาชิกทูเพิลด้วยดัชนี | |
.. | .., expr.., ..expr, expr..expr | เรนจ์ลิเทอรัลแบบไม่รวมขอบขวา | PartialOrd |
..= | ..=expr, expr..=expr | เรนจ์ลิเทอรัลแบบรวมขอบขวา | PartialOrd |
.. | ..expr | ไวยากรณ์อัปเดตสมาชิกของ struct | |
.. | variant(x, ..), struct_type { x, .. } | การผูกค่าแพตเทิร์นแบบ “และสมาชิกที่เหลือ” | |
... | expr...expr | (เลิกใช้แล้ว ให้ใช้ ..= แทน) ในแพตเทิร์น: แพตเทิร์นเรนจ์แบบรวมขอบเขต | |
/ | expr / expr | การหารทางคณิตศาสตร์ | Div |
/= | var /= expr | การหารทางคณิตศาสตร์พร้อมกำหนดค่า | DivAssign |
: | pat: type, ident: type | ข้อกำหนดชนิดข้อมูล | |
: | ident: expr | การกำหนดค่าเริ่มต้นของฟิลด์ใน struct | |
: | 'a: loop {...} | ป้ายกำกับของลูป | |
; | expr; | ตัวปิดท้ายสเตตเมนต์และไอเท็ม | |
; | [...; len] | ส่วนหนึ่งของไวยากรณ์อาร์เรย์ขนาดคงที่ | |
<< | expr << expr | การเลื่อนบิตไปทางซ้าย | Shl |
<<= | var <<= expr | การเลื่อนบิตไปทางซ้ายพร้อมกำหนดค่า | ShlAssign |
< | expr < expr | การเปรียบเทียบน้อยกว่า | PartialOrd |
<= | expr <= expr | การเปรียบเทียบน้อยกว่าหรือเท่ากับ | PartialOrd |
= | var = expr, ident = type | การกำหนดค่า / ความเทียบเท่า | |
== | expr == expr | การเปรียบเทียบความเท่ากัน | PartialEq |
=> | pat => expr | ส่วนหนึ่งของไวยากรณ์กิ่งของ match | |
> | expr > expr | การเปรียบเทียบมากกว่า | PartialOrd |
>= | expr >= expr | การเปรียบเทียบมากกว่าหรือเท่ากับ | PartialOrd |
>> | expr >> expr | การเลื่อนบิตไปทางขวา | Shr |
>>= | var >>= expr | การเลื่อนบิตไปทางขวาพร้อมกำหนดค่า | ShrAssign |
@ | ident @ pat | การผูกค่าแพตเทิร์นเข้ากับตัวแปร | |
^ | expr ^ expr | XOR ระดับบิต | BitXor |
^= | var ^= expr | XOR ระดับบิตพร้อมกำหนดค่า | BitXorAssign |
| | pat | pat | ทางเลือกของแพตเทิร์น | |
| | expr | expr | OR ระดับบิต | BitOr |
|= | var |= expr | OR ระดับบิตพร้อมกำหนดค่า | BitOrAssign |
|| | expr || expr | OR เชิงตรรกะแบบลัดวงจร | |
? | expr? | การส่งต่อข้อผิดพลาด |
สัญลักษณ์ที่ไม่ใช่ตัวดำเนินการ
ตารางต่อไปนี้รวบรวมสัญลักษณ์ทั้งหมดที่ไม่ได้ทำหน้าที่เป็นตัวดำเนินการ กล่าวคือ สัญลักษณ์เหล่านี้ไม่ได้มีพฤติกรรมเสมือนการเรียกฟังก์ชันหรือเมธอด
ตารางที่ B-2 แสดงสัญลักษณ์ที่ปรากฏเดี่ยวๆ และใช้ได้ในหลากหลายตำแหน่ง
ตารางที่ B-2: ไวยากรณ์แบบเดี่ยว
| สัญลักษณ์ | คำอธิบาย |
|---|---|
'ident | ช่วงอายุที่มีชื่อหรือป้ายกำกับของลูป |
ตัวเลขที่ตามด้วย u8, i32, f64, usize และอื่นๆ ทันที | ลิเทอรัลตัวเลขที่มีชนิดข้อมูลระบุกำกับไว้ |
"..." | สตริงลิเทอรัล |
r"...", r#"..."#, r##"..."## และอื่นๆ | สตริงลิเทอรัลแบบ raw โดยไม่มีการแปลง escape characters |
b"..." | ไบต์สตริงลิเทอรัล; สร้างอาร์เรย์ของไบต์แทนสตริง |
br"...", br#"..."#, br##"..."## และอื่นๆ | ไบต์สตริงลิเทอรัลแบบ raw; การผสมผสานของสตริงลิเทอรัลแบบ raw และไบต์สตริงลิเทอรัล |
'...' | อักขระลิเทอรัล |
b'...' | ไบต์ลิเทอรัล ASCII |
|…| expr | โคลเชอร์ |
! | ชนิด bottom type ที่ว่างเปล่าเสมอสำหรับฟังก์ชันที่ไม่คืนค่ากลับ |
_ | การผูกค่าแพตเทิร์นแบบ “ไม่สนใจค่า”; ยังใช้คั่นตัวเลขจำนวนเต็มเพื่อให้อ่านง่ายขึ้น |
ตารางที่ B-3 แสดงสัญลักษณ์ที่ปรากฏในบริบทของพาธที่ลากผ่านลำดับชั้นของมอดูลไปยังไอเท็ม
ตารางที่ B-3: ไวยากรณ์ที่เกี่ยวกับพาธ
| สัญลักษณ์ | คำอธิบาย |
|---|---|
ident::ident | พาธของเนมสเปซ |
::path | พาธที่สัมพัทธ์กับรูทของเครต (พาธแบบสัมบูรณ์อย่างชัดเจน) |
self::path | พาธที่สัมพัทธ์กับมอดูลปัจจุบัน (พาธแบบสัมพัทธ์อย่างชัดเจน) |
super::path | พาธที่สัมพัทธ์กับมอดูลแม่ของมอดูลปัจจุบัน |
type::ident, <type as trait>::ident | ค่าคงที่ ฟังก์ชัน และชนิดข้อมูลร่วม (associated items) |
<type>::... | ไอเท็มร่วมของชนิดข้อมูลที่ไม่สามารถระบุชื่อได้โดยตรง (ตัวอย่างเช่น <&T>::..., <[T]>::... และอื่นๆ) |
trait::method(...) | การแยกความกำกวมของการเรียกเมธอดโดยระบุชื่อเทรตที่นิยามเมธอดนั้น |
type::method(...) | การแยกความกำกวมของการเรียกเมธอดโดยระบุชื่อชนิดข้อมูลที่นิยามเมธอดนั้น |
<type as trait>::method(...) | การแยกความกำกวมของการเรียกเมธอดโดยระบุทั้งชื่อเทรตและชนิดข้อมูล |
ตารางที่ B-4 แสดงสัญลักษณ์ที่ปรากฏในบริบทของการใช้พารามิเตอร์ชนิดข้อมูลเจเนอริก
ตารางที่ B-4: เจเนอริก
| สัญลักษณ์ | คำอธิบาย |
|---|---|
path<...> | ระบุพารามิเตอร์ให้กับชนิดเจเนอริกในชนิดข้อมูล (ตัวอย่างเช่น Vec<u8>) |
path::<...>, method::<...> | ระบุพารามิเตอร์ให้กับชนิดเจเนอริก ฟังก์ชัน หรือเมธอดในนิพจน์; มักเรียกกันว่า เทอร์โบฟิช (turbofish) (ตัวอย่างเช่น "42".parse::<i32>()) |
fn ident<...> ... | นิยามฟังก์ชันเจเนอริก |
struct ident<...> ... | นิยาม struct เจเนอริก |
enum ident<...> ... | นิยาม enum เจเนอริก |
impl<...> ... | นิยามการอิมพลีเมนต์เจเนอริก |
for<...> type | ข้อกำหนดช่วงอายุแบบ higher-ranked (higher-ranked lifetime bounds) |
type<ident=type> | ชนิดเจเนอริกที่กำหนดค่าเฉพาะให้กับชนิดข้อมูลร่วมหนึ่งตัวหรือมากกว่า (ตัวอย่างเช่น Iterator<Item=T>) |
ตารางที่ B-5 แสดงสัญลักษณ์ที่ปรากฏในบริบทของการจำกัดพารามิเตอร์ชนิดข้อมูลเจเนอริกด้วยข้อกำหนดเทรต
ตารางที่ B-5: ข้อจำกัดจากข้อกำหนดเทรต
| สัญลักษณ์ | คำอธิบาย |
|---|---|
T: U | พารามิเตอร์เจเนอริก T ถูกจำกัดให้ใช้กับชนิดข้อมูลที่อิมพลีเมนต์เทรต U |
T: 'a | ชนิดเจเนอริก T ต้องมีช่วงอายุยืนยาวกว่าช่วงอายุ 'a (หมายความว่าชนิดข้อมูลนั้นต้องไม่มีการอ้างอิงที่มีช่วงอายุสั้นกว่า 'a ปะปนอยู่ แม้โดยอ้อม) |
T: 'static | ชนิดเจเนอริก T ต้องไม่มีการอ้างอิงที่ถูกยืมอื่นใดนอกจากที่เป็น 'static |
'b: 'a | ช่วงอายุเจเนอริก 'b ต้องยืนยาวกว่าช่วงอายุ 'a |
T: ?Sized | ยินยอมให้พารามิเตอร์ชนิดข้อมูลเจเนอริกเป็นชนิดข้อมูลขนาดไม่คงที่ขณะคอมไพล์ได้ |
'a + trait, trait + trait | ข้อกำหนดชนิดข้อมูลแบบผสม |
ตารางที่ B-6 แสดงสัญลักษณ์ที่ปรากฏในบริบทของการเรียกหรือนิยามมาโคร และการระบุแอตทริบิวต์บนไอเท็ม
ตารางที่ B-6: มาโครและแอตทริบิวต์
| สัญลักษณ์ | คำอธิบาย |
|---|---|
#[meta] | แอตทริบิวต์ภายนอก |
#![meta] | แอตทริบิวต์ภายใน |
$ident | การแทนที่ตัวแปรของมาโคร |
$ident:kind | ตัวแปรระดับเมตาของมาโคร |
$(...)... | การทำซ้ำของมาโคร |
ident!(...), ident!{...}, ident![...] | การเรียกใช้มาโคร |
ตารางที่ B-7 แสดงสัญลักษณ์ที่ใช้สร้างคอมเมนต์
ตารางที่ B-7: คอมเมนต์
| สัญลักษณ์ | คำอธิบาย |
|---|---|
// | คอมเมนต์บรรทัดเดียว |
//! | คอมเมนต์เอกสารบรรทัดเดียวแบบภายใน |
/// | คอมเมนต์เอกสารบรรทัดเดียวแบบภายนอก |
/*...*/ | คอมเมนต์แบบบล็อก |
/*!...*/ | คอมเมนต์เอกสารแบบบล็อกภายใน |
/**...*/ | คอมเมนต์เอกสารแบบบล็อกภายนอก |
ตารางที่ B-8 แสดงบริบทที่มีการใช้วงเล็บ
ตารางที่ B-8: วงเล็บ
| สัญลักษณ์ | คำอธิบาย |
|---|---|
() | ทูเพิลว่างเปล่า (ยูนิต หรือ unit) ทั้งในรูปของลิเทอรัลและชนิดข้อมูล |
(expr) | นิพจน์ที่อยู่ในวงเล็บ |
(expr,) | นิพจน์ทูเพิลที่มีสมาชิกตัวเดียว |
(type,) | ชนิดข้อมูลทูเพิลที่มีสมาชิกตัวเดียว |
(expr, ...) | นิพจน์ทูเพิล |
(type, ...) | ชนิดข้อมูลทูเพิล |
expr(expr, ...) | นิพจน์การเรียกใช้ฟังก์ชัน; ใช้กำหนดค่าเริ่มต้นให้ struct แบบทูเพิลและวาเรียนต์แบบทูเพิลของ enum ด้วย |
ตารางที่ B-9 แสดงบริบทที่มีการใช้วงเล็บปีกกา
ตารางที่ B-9: วงเล็บปีกกา
| บริบท | คำอธิบาย |
|---|---|
{...} | นิพจน์บล็อก |
Type {...} | ลิเทอรัล struct |
ตารางที่ B-10 แสดงบริบทที่มีการใช้วงเล็บเหลี่ยม
ตารางที่ B-10: วงเล็บเหลี่ยม
| บริบท | คำอธิบาย |
|---|---|
[...] | ลิเทอรัลอาร์เรย์ |
[expr; len] | ลิเทอรัลอาร์เรย์ที่บรรจุ expr ซ้ำกันจำนวน len ตัว |
[type; len] | ชนิดข้อมูลอาร์เรย์ที่บรรจุสมาชิกชนิด type จำนวน len อินสแตนซ์ |
expr[expr] | การเข้าถึงสมาชิกคอลเลกชันด้วยดัชนี; โอเวอร์โหลดได้ (Index, IndexMut) |
expr[..], expr[a..], expr[..b], expr[a..b] | การเข้าถึงสมาชิกคอลเลกชันในลักษณะการตัดสไลซ์ โดยใช้ Range, RangeFrom, RangeTo หรือ RangeFull เป็น “ดัชนี” |