Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ภาคผนวก 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 & exprAND ระดับบิตBitAnd
&=var &= exprAND ระดับบิตพร้อมกำหนดค่าBitAndAssign
&&expr && exprAND เชิงตรรกะแบบลัดวงจร
*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 ^ exprXOR ระดับบิตBitXor
^=var ^= exprXOR ระดับบิตพร้อมกำหนดค่าBitXorAssign
|pat | patทางเลือกของแพตเทิร์น
|expr | exprOR ระดับบิตBitOr
|=var |= exprOR ระดับบิตพร้อมกำหนดค่าBitOrAssign
||expr || exprOR เชิงตรรกะแบบลัดวงจร
?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 เป็น “ดัชนี”