Thep Excel
List.First – ดึงสมาชิกตัวแรกจาก List
List.First ใช้เพื่อดึงค่าสมาชิกตัวแรกจาก List หากเอา List ว่างเปล่า ให้ใช้ค่า Default ปกป้อง
= List.First(list as list, optional defaultValue as any) as any
Function Metrics
Popularity
7/10
Difficulty
2/10
Usefulness
7/10
Syntax & Arguments
= List.First(list as list, optional defaultValue as any) as any
| Argument | Type | Required | Default | Description |
|---|---|---|---|---|
| list | list | Yes | List ที่ต้องการดึงสมาชิกตัวแรก | |
| defaultValue | any | Optional | null | ค่าที่จะคืนกลับมาหาก List ว่างเปล่า (ค่าเริ่มต้นคือ null) |
How it works
ดึงข้อมูลล่าสุด
หาก List เรียงลำดับจากใหม่ไปเก่า สามารถใช้ List.First เพื่อดึงข้อมูลล่าสุดออกมา
ป้องกัน Error จาก List ว่าง
ใช้ดึงค่าจาก List ที่อาจจะว่างเปล่าได้ โดยกำหนดค่า Default เพื่อป้องกันการเกิด Error หรือค่า null ที่ไม่ต้องการ
Examples
ตัวอย่างที่ 1: ดึงค่าตัวแรกจาก List ปกติ
List.First({1, 2, 3})
= List.First({1, 2, 3})
1
ตัวอย่างที่ 2: ดึงค่าจาก List ว่างเปล่า (ไม่มี Default)
List.First({})
= List.First({})
null
ตัวอย่างที่ 3: ดึงค่าจาก List ว่างเปล่า (มี Default)
List.First({}, "ไม่มีข้อมูล")
= List.First({}, "ไม่มีข้อมูล")
"ไม่มีข้อมูล"
ตัวอย่างที่ 4: ดึงค่าแรกจาก Filtered List (Real-world)
let Source = {10, 20, 30, 40, 50}, Filtered = List.Select(Source, each _ > 25), FirstValue = List.First(Filtered, -1) in FirstValue
let
Source = {10, 20, 30, 40, 50},
Filtered = List.Select(Source, each _ > 25),
FirstValue = List.First(Filtered, -1)
in
FirstValue
30
FAQs
List.First ต่างจาก List.FirstN อย่างไร?
List.First คืนค่าสมาชิก ‘ตัวเดียว’ (single value) ในขณะที่ List.FirstN คืนค่าเป็น ‘List’ ของสมาชิก N ตัวแรก เช่น List.FirstN({1,2,3}, 1) คืนค่า {1} ไม่ใช่ 1
จะเกิดอะไรถ้า List มีสมาชิกแต่เป็นค่า null?
ฟังก์ชันคืนค่า null นั้นออกมา ไม่ใช่ defaultValue (defaultValue ใช้เฉพาะกรณี List ว่างเท่านั้น)
ใช้ List.First กับ Table ได้ไหม?
ไม่ได้โดยตรง ต้องแปลง Table เป็น List ก่อน โดยใช้ Table.ToList() หรือเข้าถึง Column เป็น List
Resources & Related
Resources
-
Microsoft Learn: List.First
official
Related functions
Additional Notes
ฟังก์ชัน List.First ใช้สำหรับดึงสมาชิกตัวแรกของ List ออกมา หากไม่มีค่า Default ที่ระบุ List ว่าง ฟังก์ชันจะคืนค่าเป็น null
ที่เจ๋งคือ List.First ช่วยให้เราเขียน Code ที่ safety มากขึ้น โดยการระบุค่า Default ตั้งแต่ต้น ไม่ต้องลดส่วนหลัง Error ตัวตั้งแต่ต้น
ส่วนตัวผมใช้ List.First บ่อยเวลา Transform Data ที่อาจจะไม่มีค่า (Empty Result) คู่กับ List.Select หรือ List.Filter เพื่อปกป้อง Edge Case ต่างๆ ครับ