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

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

Πληροφορία

Όνομα	Περιγραφή
List.Count	Επιστρέφει τον αριθμό των στοιχείων σε μια λίστα.
List.IsEmpty	Επιστρέφει true εάν η λίστα είναι κενή.
List.NonNullCount	Επιστρέφει τον αριθμό των στοιχείων που δεν είναι null στη λίστα.

Επιλογή

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

Μέσοι όροι

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

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

Πρόσθεση

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

Όνομα	Περιγραφή
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 τιμών με βάση μια αρχική τιμή, πλήθος και τιμή επαυξητικής διάρκειας.

Τιμές παραμέτρων

Προδιαγραφή εμφάνισης

• Εμφάνιση.Πρώτη = 0;
• Εμφάνιση.Τελευταία = 1;
• Εμφάνιση.Όλα = 2;

Σειρά ταξινόμησης

• Order.Αύξουσα = 0;
• Order.Φθίνουσα = 1;

Κριτήρια εξίσωσης

Σε πολλές από τις συναρτήσεις λίστας, η equationCriteria παράμετρος υποδεικνύει τον τρόπο καθορισμού της ισότητας μεταξύ των στοιχείων λίστας. Τα κριτήρια εξίσωσης για τις τιμές λίστας μπορούν να καθοριστούν ως ένα από τα εξής:

• Μια τιμή συνάρτησης που είναι είτε:
  • Ένας επιλογέας κλειδιού που καθορίζει την τιμή στη λίστα για την εφαρμογή των κριτηρίων ισότητας.
  • Μια συνάρτηση σύγκρισης που χρησιμοποιείται για τον καθορισμό του είδους σύγκρισης που θα εφαρμοστεί. Μπορούν να καθοριστούν ενσωματωμένες συναρτήσεις σύγκρισης—μεταβείτε στις συναρτήσεις σύγκρισης.
• Μια τιμή λίστας που έχει:
  • Ακριβώς δύο στοιχεία.
  • Το πρώτο στοιχείο είναι ο επιλογέας κλειδιού, όπως καθορίζεται παραπάνω.
  • Το δεύτερο στοιχείο είναι μια συνάρτηση σύγκρισης όπως καθορίζεται παραπάνω.

Στις περισσότερες συναρτήσεις λίστας, η συνάρτηση σύγκρισης που χρησιμοποιείται στην equationCriteria παράμετρο πρέπει να είναι μία από τις ενσωματωμένες συναρτήσεις σύγκρισης. Σε αυτές τις συναρτήσεις λίστας, η χρήση ενός προσαρμοσμένου συγκριτή οδηγεί σε σφάλμα. Ωστόσο, οι ακόλουθες συναρτήσεις λίστας σάς επιτρέπουν να χρησιμοποιήσετε ένα προσαρμοσμένο συγκριτικό:

• List.Contains
• List.ContainsAll
• List.ContainsAny
• List.PositionOf
• List.PositionOfAny

Για περισσότερες πληροφορίες και παραδείγματα, μεταβείτε στο List.Distinct και List.PositionOf.

Κριτήρια σύγκρισης

Το κριτήριο σύγκρισης μπορεί να παρασχεθεί ως μία από τις ακόλουθες τιμές:

• Μια αριθμητική τιμή για τον καθορισμό μιας σειράς ταξινόμησης. Για περισσότερες πληροφορίες, μεταβείτε στο Σειρά ταξινόμησης.
• Για να υπολογίσετε ένα κλειδί που θα χρησιμοποιηθεί για ταξινόμηση, μπορεί να χρησιμοποιηθεί μια συνάρτηση ενός ορίσματος.
• Για να επιλέξετε ένα κλειδί και μια σειρά ελέγχου, το κριτήριο σύγκρισης μπορεί να είναι μια λίστα που περιέχει το κλειδί και τη σειρά.
• Για να ελέγξετε πλήρως τη σύγκριση, μπορεί να χρησιμοποιηθεί μια συνάρτηση δύο ορισμάτων που επιστρέφει -1, 0 ή 1 με βάση τη σχέση μεταξύ των αριστερών και των δεξιών εισόδων. Value.Compare είναι μια μέθοδος που μπορεί να χρησιμοποιηθεί για την ανάθεση αυτής της λογικής.

Για περισσότερες πληροφορίες και παραδείγματα, μεταβείτε στο List.Sort.

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

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

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