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

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

ข้อมูล

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

การเลือก

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

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

ชื่อ	คำอธิบาย
List.Accumulate	สะสมผลลัพธ์จากรายการ เริ่มต้นจากข้อมูลค่าเริ่มต้น ฟังก์ชันนี้จะใช้ฟังก์ชันสะสมและแสดงผลลัพธ์สุดท้าย
List.Combine	ผสานรายการต่างๆ เป็นรายการเดียว
List.ConformToPageReader	ฟังก์ชันนี้มีไว้สําหรับการใช้งานภายในเท่านั้น
List.RemoveRange	แสดงรายการที่ลบหน่วยข้อมูลการนับที่ข้อมูลเริ่มต้นออก จํานวนเริ่มต้นคือ 1
List.RemoveFirstN	แสดงรายการที่มีจํานวนองค์ประกอบที่ระบุที่ลบออกจากรายการ โดยเริ่มต้นที่องค์ประกอบแรก จํานวนองค์ประกอบที่ลบออกจะขึ้นอยู่กับพารามิเตอร์ที่เลือก countOrCondition ได้
List.RemoveItems	เอาหน่วยข้อมูลออกจาก list1 ที่อยู่ใน list2และแสดงรายการใหม่
List.RemoveLastN	แสดงรายการที่มีจํานวนองค์ประกอบที่ระบุที่ลบออกจากรายการ โดยเริ่มต้นที่องค์ประกอบสุดท้าย จํานวนองค์ประกอบที่ลบออกจะขึ้นอยู่กับพารามิเตอร์ที่เลือก countOrCondition ได้
List.Repeat	แสดงรายการที่ทําซ้ําเนื้อหาของเวลาการนับรายการข้อมูลป้อนเข้า
List.ReplaceRange	แสดงรายการที่แทนที่ค่าจํานวนในรายการที่มี replaceWith รายการโดยเริ่มต้นที่ดัชนี
List.RemoveMatchingItems	ลบการปรากฏทั้งหมดของค่าที่กําหนดในรายการออก
List.RemoveNulls	ลบค่า null ออกจากรายการ
List.ReplaceMatchingItems	แทนที่การปรากฏของค่าที่มีอยู่ในรายการ ด้วยค่าใหม่โดยใช้ ที่ให้มาequationCriteria ค่าเก่าและใหม่จะได้รับมาจาก replacements พารามิเตอร์ สามารถระบุค่าเกณฑ์สมการทางเลือกเพื่อควบคุมการเปรียบเทียบความเท่ากัน สําหรับรายละเอียดของการดําเนินการแทนที่และเกณฑ์สมการ ให้ไปที่ ค่าพารามิเตอร์
List.ReplaceValue	ค้นหารายการของค่าสําหรับค่า และแทนที่การปรากฏแต่ละรายการด้วยค่าการแทนที่
List.Reverse	แสดงรายการที่ย้อนกลับหน่วยข้อมูลในรายการ
List.Split	แยกรายการที่ระบุลงในรายการของรายการโดยใช้ขนาดหน้าที่ระบุ
List.Transform	ดําเนินการฟังก์ชันของแต่ละหน่วยข้อมูลในรายการและแสดงรายการใหม่
List.TransformMany	แสดงรายการที่มีการคาดการณ์องค์ประกอบจากรายการข้อมูลป้อนเข้า

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

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

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

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

ชื่อ	คำอธิบาย
List.Difference	แสดงหน่วยข้อมูลในรายการ 1 ที่ไม่ปรากฏในรายการ 2 รองรับค่าที่ซ้ํากัน
List.Intersect	แสดงรายการจากรายละเอียดของรายการต่าง ๆ และแบ่งหน่วยข้อมูลทั่วไปในแต่ละรายการ รองรับค่าที่ซ้ํากัน
List.Union	แสดงรายการจากรายการและรวมหน่วยข้อมูลในแต่ละรายการ รายการผลลัพธ์จะมีหน่วยข้อมูลทั้งหมดในรายการการป้อนข้อมูลต่าง ๆ ค่าที่ซ้ํากันจะถูกจับคู่เป็นส่วนหนึ่งของการรวม
List.Zip	แสดงรายการที่รวมหน่วยข้อมูลที่อยู่ในตําแหน่งเดียวกันไว้

การสั่งซื้อ

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

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

• ตัวเลข
• ระยะเวลา
• DateTime
• Text
• ตรรกะ
• Null

ชื่อ	คำอธิบาย
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	แสดงค่าเบี่ยงเบนมาตรฐานจากรายการของค่า List.StandardDeviation ดําเนินการประมาณการ ตามตัวอย่าง ผลลัพธ์คือตัวเลขสําหรับตัวเลขและระยะเวลาสําหรับ DateTimes และ Durations

การเพิ่มเติม

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

ชื่อ	คำอธิบาย
List.Sum	แสดงผลรวมจากรายการ

ตัวเลข

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

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

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

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

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

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

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

• Occurrence.First = 0;
• Occurrence.Last = 1;
• Occurrence.All = 2;

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

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

เกณฑ์สมการ

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

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

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

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

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

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

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

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

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

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