Συναρτήσεις list

  • Άρθρο

Αυτές οι συναρτήσεις δημιουργούν και χειρίζονται τιμές λίστας.

Πληροφορίες

Ονομασία Περιγραφή
List.Count Επιστρέφει τον αριθμό των στοιχείων σε μια λίστα.
List.NonNullCount Επιστρέφει τον αριθμό των στοιχείων μιας λίστας εξαιρώντας τις τιμές null
List.IsEmpty Επιστρέφει εάν μια λίστα είναι κενή.

Επιλογή

Ονομασία Περιγραφή
List.Alternate Επιστρέφει μια λίστα με τα στοιχεία που εναλλάσσονται από την αρχική λίστα με βάση ένα πλήθος, προαιρετικό repeatInterval και μια προαιρετική μετατόπιση.
List.Buffer Αποθηκεύει τη λίστα σε 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 .

Οι συγκρίσιμοί τύποι δεδομένων περιλαμβάνουν:

  • Αριθμός
  • Διάρκεια
  • Ημερομηνία/ώρα
  • Μήνυμα κειμένου
  • Λογική
  • Null
Ονομασία Περιγραφή
List.Max Επιστρέφει το μέγιστο στοιχείο σε μια λίστα ή την προαιρετικά προεπιλεγμένη τιμή εάν η λίστα είναι κενή.
List.MaxN Επιστρέφει τις μέγιστες τιμές στη λίστα. Ο αριθμός των τιμών που θα επιστραφούν ή πρέπει να καθοριστεί μια συνθήκη φιλτραρίσματος.
List.Median Επιστρέφει το διάμεσο στοιχείο από μια λίστα.
List.Min Επιστρέφει το ελάχιστο στοιχείο σε μια λίστα ή την προαιρετικά προεπιλεγμένη τιμή εάν η λίστα είναι κενή.
List.MinN Επιστρέφει τις ελάχιστες τιμές σε μια λίστα. Ο αριθμός των τιμών που θα επιστραφούν ή μπορεί να καθοριστεί μια συνθήκη φιλτραρίσματος.
List.Sort Επιστρέφει μια ταξινομημένη λίστα χρησιμοποιώντας κριτήριο σύγκρισης.
List.Percentile Επιστρέφει ένα ή περισσότερα εκατοστημόρια δείγματος που αντιστοιχούν στις δεδομένες πιθανότητες.

Μέσοι όροι

Αυτές οι συναρτήσεις λειτουργούν σε ομοιογενείς λίστες αριθμών, ημερομηνιών/ωρών και διαρκειών.

Ονομασία Περιγραφή
List.Average Επιστρέφει μια μέση τιμή από μια λίστα στον τύπο δεδομένων των τιμών της λίστας.
List.Mode Επιστρέφει ένα στοιχείο που εμφανίζεται συχνότερα σε μια λίστα.
List.Modes Επιστρέφει όλα τα στοιχεία που εμφανίζονται με την ίδια μέγιστη συχνότητα.
List.StandardDeviation Επιστρέφει την τυπική απόκλιση από μια λίστα τιμών. Η συνάρτηση List.StandardDeviation εκτελεί μια εκτίμηση βάσει δείγματος. Το αποτέλεσμα είναι ένας αριθμός για αριθμούς και μια διάρκεια για DateTimes και Διάρκειες.

Πρόσθεση

Αυτές οι συναρτήσεις λειτουργούν σε ομοιογενείς λίστες αριθμών ή διαρκειών.

Ονομασία Περιγραφή
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.

Λειτουργίες αντικατάστασης

Οι λειτουργίες αντικατάστασης καθορίζονται από μια τιμή λίστας. Κάθε στοιχείο αυτής της λίστας πρέπει να είναι:

  • Μια τιμή λίστας από δύο ακριβώς στοιχεία.
  • Το πρώτο στοιχείο είναι η παλιά τιμή της λίστας, η οποία θα αντικατασταθεί.
  • Το δεύτερο στοιχείο είναι η νέα τιμή, η οποία θα πρέπει να αντικαταστήσει όλες τις εμφανίσεις της παλιάς τιμής στη λίστα.