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

  • บทความ

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

ข้อมูล

ชื่อ คำอธิบาย
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 แสดงรายการของค่าเวลาของจํานวนขนาดโดยเริ่มต้นที่จุดเริ่มต้น

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

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

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

เกณฑ์สมการ

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

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

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

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

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

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

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

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

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

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