ฟังก์ชันรายการ

ฟังก์ชันเหล่านี้สร้างและจัดการค่ารายการ

ข้อมูล

ชื่อ	คำอธิบาย
List.Count	แสดงจํานวนหน่วยข้อมูลในรายการ
List.IsEmpty	แสดง true ถ้ารายการเป็นค่าว่าง
List.NonNullCount	แสดงจํานวนหน่วยข้อมูลที่ไม่ใช่ null ในรายการ

ตัวเลือก

ชื่อ	คำอธิบาย
List.Alternate	แสดงรายการที่ประกอบด้วยองค์ประกอบออฟเซตที่เป็นจํานวนคี่ในรายการ
List.Buffer	บัฟเฟอร์รายการ
List.Distinct	แสดงรายการของค่าที่ลบรายการที่ซ้ํากันออกแล้ว
List.FindText	แสดงรายการของค่า (รวมถึงเขตข้อมูลระเบียน) ที่ประกอบด้วยข้อความที่ระบุ
List.First	แสดงค่าแรกของรายการหรือค่าเริ่มต้นที่ระบุ หากว่างเปล่า
List.FirstN	แสดงหน่วยข้อมูลชุดแรกในรายการโดยระบุจํานวนหน่วยข้อมูลที่จะแสดงหรือเงื่อนไขที่ผ่านเกณฑ์
List.InsertRange	แทรกค่าลงในรายการที่ดัชนีที่กําหนด
List.IsDistinct	ระบุว่ามีรายการซ้ําในรายการหรือไม่
List.Last	แสดงค่าสุดท้ายของรายการหรือค่าเริ่มต้นที่ระบุ ถ้าว่างเปล่า
List.LastN	แสดงค่าสุดท้ายในรายการ สามารถระบุจํานวนค่าที่จะส่งกลับหรือเงื่อนไขที่มีคุณสมบัติได้
List.MatchesAll	แสดง true หากฟังก์ชันเงื่อนไขเหมาะสมกับค่าทั้งหมดในรายการ
List.MatchesAny	แสดง true ถ้าฟังก์ชันเงื่อนไขเหมาะสมกับค่าใด ๆ
List.Positions	แสดงรายการออฟเซตสําหรับข้อมูลป้อนเข้า
List.Range	แสดงชุดย่อยของรายการที่เริ่มต้นที่ออฟเซต
List.Select	แสดงรายการของค่าที่ตรงกับเงื่อนไข
List.Single	แสดงหน่วยข้อมูลในรายการหนึ่งรายการสําหรับรายการความยาวหนึ่ง ไม่เช่นนั้นจะแสดงข้อยกเว้น
List.SingleOrDefault	แสดงข้อมูลในรายการหนึ่งรายการสําหรับรายการของความยาวหนึ่งค่า และค่าเริ่มต้นสําหรับรายการที่ว่างเปล่า
List.Skip	แสดงรายการที่ข้ามจํานวนองค์ประกอบที่ระบุที่จุดเริ่มต้นของรายการ

ฟังก์ชันการแปลง

ชื่อ	คำอธิบาย
List.Accumulate	AAccumulates ค่าสรุปจากหน่วยข้อมูลในรายการ
List.Combine	แสดงรายการเดียวโดยการรวมหลายรายการ
List.ConformToPageReader	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
List.RemoveFirstN	แสดงรายการที่ข้ามจํานวนองค์ประกอบที่ระบุที่จุดเริ่มต้นของรายการ
List.RemoveItems	เอาหน่วยข้อมูลออกจากรายการแรกที่แสดงในรายการที่สอง
List.RemoveLastN	แสดงรายการที่ลบจํานวนองค์ประกอบที่ระบุออกจากส่วนท้ายของรายการ
List.RemoveMatchingItems	ลบการปรากฏทั้งหมดของค่าที่ป้อน
List.RemoveNulls	ลบค่า null ทั้งหมดจากรายการที่ระบุ
List.RemoveRange	ลบจํานวนของค่าโดยเริ่มต้นที่ตําแหน่งที่ระบุ
List.Repeat	แสดงรายการ count การดําเนินการซ้ําของรายการต้นฉบับ
List.ReplaceMatchingItems	แทนที่การปรากฏของค่าที่มีอยู่ในรายการด้วยค่าใหม่ที่ตรงกับเงื่อนไข
List.ReplaceRange	แทนที่จํานวนค่า count โดยเริ่มต้นที่ position ด้วยค่าการแทนที่
List.ReplaceValue	ค้นหารายการสําหรับค่าที่ระบุและแทนที่
List.Reverse	ย้อนกลับลําดับของค่าในรายการ
List.Split	แยกรายการที่ระบุลงในรายการของรายการโดยใช้ขนาดหน้าที่ระบุ
List.Transform	แสดงรายการค่าใหม่ที่คํานวณจากรายการนี้
List.TransformMany	แสดงรายการที่มีการแปลงองค์ประกอบจากรายการข้อมูลป้อนเข้าโดยใช้ฟังก์ชันที่ระบุ
List.Zip	แสดงรายการต่าง ๆ โดยการรวมหน่วยข้อมูลในตําแหน่งเดียวกันในหลาย ๆ รายการ

ฟังก์ชันการเป็นสมาชิก

เนื่องจากค่าทั้งหมดสามารถทดสอบเพื่อความเท่าเทียมกัน ฟังก์ชันเหล่านี้จึงสามารถใช้งานได้กับรายการที่ต่างกัน

ชื่อ	คำอธิบาย
List.AllTrue	แสดง true ถ้านิพจน์ทั้งหมดเป็นจริง
List.AnyTrue	แสดงค่าเป็น true ถ้านิพจน์ใด ๆ เป็นจริง
List.Contains	ระบุว่ารายการมีค่าหรือไม่
List.ContainsAll	ระบุว่ารายการมีค่าทั้งหมดในรายการอื่นที่ใด
List.ContainsAny	ระบุว่ารายการมีค่าใด ๆ ในรายการอื่นที่รวมอยู่
List.PositionOf	แสดงออฟเซตของค่าในรายการ
List.PositionOfAny	แสดงออฟเซตแรกของค่าในรายการ

การดําเนินการชุด

ชื่อ	คำอธิบาย
List.Difference	แสดงความแตกต่างของสองรายการที่ระบุ
List.Intersect	แสดงจุดตัดของค่ารายการที่พบในข้อมูลป้อนเข้า
List.Union	แสดงยูเนียนของค่ารายการที่พบในข้อมูลป้อนเข้า

สั่ง ซื้อ

ฟังก์ชันการจัดลําดับทําการเปรียบเทียบ ค่าทั้งหมดที่ถูกเปรียบเทียบต้องสามารถเปรียบเทียบได้ ซึ่งหมายความว่าค่าทั้งหมดจะต้องมาจากข้อมูลชนิดเดียวกัน (หรือมีค่า null ซึ่งจะเปรียบเทียบค่าน้อยที่สุด) มิฉะนั้น Expression.Error จะถูกโยน

ชนิดข้อมูลที่เปรียบเทียบได้ประกอบด้วย:

• เลข
• ระยะเวลา
• วันที่เวลา
• ข้อความ
• มีเหตุผล
• โมฆะ

ชื่อ	คำอธิบาย
List.Max	แสดงค่าสูงสุดหรือค่าเริ่มต้นสําหรับรายการที่ว่างเปล่า
List.MaxN	แสดงค่าสูงสุดในรายการ ต้องระบุจํานวนของค่าที่จะส่งกลับหรือเงื่อนไขการกรอง
List.Median	แสดงค่ามัธยฐานในรายการ
List.Min	แสดงค่าต่ําสุดหรือค่าเริ่มต้นสําหรับรายการที่ว่างเปล่า
List.MinN	แสดงค่าต่ําสุดในรายการ อาจระบุจํานวนของค่าที่จะส่งกลับหรือเงื่อนไขการกรอง
List.Sort	เรียงลําดับรายการของข้อมูลตามเกณฑ์ที่ระบุ
List.Percentile	ส่งกลับเปอร์เซ็นไทล์ตัวอย่างอย่าง น้อยหนึ่งที่สอดคล้องกับความน่าจะเป็นที่กําหนด

ค่าเฉลี่ย

ฟังก์ชันเหล่านี้จะทํางานกับรายการที่เหมือนกันของ Numbers, DateTimes และ Durations

ชื่อ	คำอธิบาย
List.Average	ส่งกลับค่าเฉลี่ยของค่า ทํางานกับค่าตัวเลข วันที่ วันที่เวลา เขตวันที่เวลา และระยะเวลา
List.Mode	แสดงค่าที่ใช้บ่อยที่สุดในรายการ
List.Modes	แสดงรายการของค่าที่ใช้บ่อยที่สุดในรายการ
List.StandardDeviation	ส่งกลับค่าประมาณตามตัวอย่างของค่าเบี่ยงเบนมาตรฐาน ฟังก์ชันนี้ดําเนินการประมาณการตามตัวอย่าง ผลลัพธ์คือตัวเลขสําหรับตัวเลขและระยะเวลาสําหรับ DateTimes และ Durations

การบวก

ฟังก์ชันเหล่านี้จะทํางานกับรายการที่เหมือนกันของ Numbers หรือ Durations

ชื่อ	คำอธิบาย
List.Sum	แสดงผลรวมของหน่วยข้อมูลในรายการ

ตัวเลข

ฟังก์ชันเหล่านี้จะทํางานผ่านตัวเลขเท่านั้น

ชื่อ	คำอธิบาย
List.Covariance	แสดงค่าความแปรปรวนระหว่างสองรายการของตัวเลข
List.Product	ส่งกลับผลคูณของตัวเลขในรายการ

เครื่อง กำเนิด ไฟฟ้า

ฟังก์ชันเหล่านี้สร้างรายการของค่า

ชื่อ	คำอธิบาย
List.Dates	สร้างรายการค่า date โดยกําหนดค่าเริ่มต้น จํานวนนับ และค่าระยะเวลาที่เพิ่ม
List.DateTimes	สร้างรายการค่า datetime โดยกําหนดค่าเริ่มต้น จํานวนนับ และค่าระยะเวลาที่เพิ่ม
List.DateTimeZones	สร้างรายการค่า datetimezone โดยกําหนดค่าเริ่มต้น จํานวนนับ และค่าระยะเวลาที่เพิ่ม
List.Durations	สร้างรายการค่า duration โดยกําหนดค่าเริ่มต้น จํานวนนับ และค่าระยะเวลาที่เพิ่ม
List.Generate	สร้างรายการของค่า
List.Numbers	แสดงรายการตัวเลขตามค่าเริ่มต้น จํานวนนับ และค่าการเพิ่มที่เลือกได้
List.Random	แสดงรายการของตัวเลขสุ่ม
List.Times	สร้างรายการค่า time โดยกําหนดค่าเริ่มต้น จํานวนนับ และค่าระยะเวลาที่เพิ่ม

ค่าพารามิเตอร์ต่างๆ

ข้อมูลจําเพาะการเกิดขึ้น

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2; ทั้งหมด

ลําดับการจัดเรียง

• Order.Ascending = 0; 2= 0.
• Order.Descending = 1;

เกณฑ์สมการ

เกณฑ์สมการสําหรับค่ารายการสามารถระบุเป็นอย่างใดอย่างหนึ่ง:

• ค่าฟังก์ชันที่เป็นอย่างใดอย่างหนึ่ง:
  • ตัวเลือกหลักที่กําหนดค่าในรายการเพื่อใช้เกณฑ์ความเท่าเทียมกัน
  • ฟังก์ชันตัวเปรียบเทียบที่ใช้ในการระบุชนิดของการเปรียบเทียบที่จะนําไปใช้ สามารถระบุฟังก์ชันตัวเปรียบเทียบที่สร้างขึ้นได้ — ไปที่ฟังก์ชัน Comparer
• ค่ารายการที่มี:
  • สองหน่วยข้อมูลที่ตรงกัน
  • องค์ประกอบแรกคือตัวเลือกหลักตามที่ระบุไว้ด้านบน
  • องค์ประกอบที่สองคือตัวเปรียบเทียบตามที่ระบุไว้ข้างต้น

สําหรับข้อมูลและตัวอย่างเพิ่มเติม ให้ไปที่ List.Distinct

เกณฑ์การเปรียบเทียบ

เกณฑ์การเปรียบเทียบสามารถระบุเป็นค่าใดค่าหนึ่งต่อไปนี้:

• ค่าตัวเลขเพื่อระบุลําดับการจัดเรียง สําหรับข้อมูลเพิ่มเติม ให้ไปที่ ลําดับการจัดเรียง
• หากต้องการคํานวณคีย์ที่จะใช้สําหรับการเรียงลําดับ ฟังก์ชันของอาร์กิวเมนต์หนึ่งรายการสามารถใช้ได้
• เมื่อต้องการเลือกคีย์และลําดับการควบคุม เกณฑ์การเปรียบเทียบสามารถเป็นรายการที่มีคีย์และลําดับได้
• เพื่อควบคุมการเปรียบเทียบทั้งหมด ฟังก์ชันของสองอาร์กิวเมนต์สามารถใช้ที่ส่งกลับเป็นค่า -1, 0 หรือ 1 ตามความสัมพันธ์ระหว่างอินพุตด้านซ้ายและขวา Value.Compare เป็นวิธีการที่สามารถใช้เพื่อกําหนดตรรกะนี้

สําหรับข้อมูลและตัวอย่างเพิ่มเติม ให้ไปที่ List.Sort

การดําเนินการแทนที่

การดําเนินการแทนที่จะถูกระบุด้วยค่ารายการ แต่ละรายการนี้ต้องเป็น:

• ค่ารายการของสองหน่วยข้อมูลที่ตรงกัน
• หน่วยข้อมูลแรกคือค่าเก่าในรายการที่จะถูกแทนที่
• หน่วยข้อมูลที่สองคือค่าใหม่ ซึ่งควรแทนที่การปรากฏทั้งหมดของค่าเก่าในรายการ