الوحدة النمطية Collections.Seq

عمليات أساسية على IEnumerables.

مساحة الاسم/مسار الوحدة النمطية: Microsoft.FSharp.Collections

التجميع: FSharp.Core (في FSharp.Core.dll)

module Seq

ملاحظات

لعرض عام للتسلسل في ب #، راجع تسلسلات (F #).

القيم

Value

الوصف

append

التفاف التعدادان المعطان كتعداد واحد متصل.

average

تقوم بإرجاع متوسط العناصر في التسلسل.

averageBy

إرجاع متوسط النتائج التي تم إنشاؤها بواسطة تطبيق الدالة على كل عنصر في التسلسل.

ذاكرة التخزين المؤقت

إرجاع تسلسل يتوافق مع إصدار مخزن مؤقتاً من التسلسل المدخل. التسلسل الناتج سيكون له نفس العناصر كما في التسلسل المدخل. يمكن تعداد النتيجة عدة مرات. التسلسل المدخل سيتم تعداده مرة واحدة على الأكثر و عند الضرورة فقط. التخزين المؤقت للتسلسل يكون عادةً مفيد عندما يكون تقييم العناصر في التسلسل الأصلي بشكل متكرر مكلف من الناحية الحسابية أو إذا كانت عملية التكرار لها تأثيرات جانبية، لا يرغب المستخدم في تكرارها عدة مرات. تعداد التسلسل الناتج هو مؤشر ترابط آمن بمعنى أن عدة قيم مستقلة من نوع IEnumerator قد يتم استخدامها في نفس الوقت من مؤشرات ترابط مختلفة (محاولات الوصول إلى جدول الlookaside الداخلي هي مؤشرات ترابط آمنة). كل IEnumerator منفرد لا يكون عادةً مؤشر الترابط آمن و لا يجب أن يتم الوصول إليها بشكل متزامن.

Cast

التفاف تسلسل System.Collections إلى تسلسل مكتوب .

اختر

تطبق الدالة المعطاة على كل عنصر من القائمة. تقوم بإرجاع قائمة احتواء النتائج "x" لكل عنصر حيث الدالة تقوم بإرجاع (Some(x

تجميع

تطبيق الدالة المعطاة على كل عنصر في التسلسل و يصل كافة النتائج.

compareWith

يقارن بين تسلسلان باستخدام دالة المقارنة المعطاه ، عنصر بعد عنصر. إرجاع إول نتيجة غير صفرية من دالة المقارنة. إذا تم الوصول إلى نهاية تسلسل فإنه يقوم بإرجاع -1 إذا كان التسلسل الإول أقصر و 1 إذا كان التسلسل الثاني أقصر.

Concat

يدمج قائمة التعداد المعطاه من قوائم التعدادات كقائمة تعداد واحدة متصلة.

countBy

يتم تطبيق دالة إنشاء-مفتاح إلى كل عنصر في تسلسل و إرجاع تسلسل يحمل مفاتيح الفريدة و عدد التكرارات في تسلسل الأصلي الخاص بها.

تأخر

إرجاع تسلسل تم إنشاؤه من المواصفات المؤجلة المعطاه من سلسلة.

distinct

إرجاع سلسلة لا تحتوي على إدخالات مكررة طبقًا للتجزئة العامه و لمقارنات المساواة على الإدخالات. إذا تم حدوث العنصر عدة مرات في التسلسل سوف يتم تجاهل التكرارات الاحقه.

distinctBy

إرجاع سلسلة لا تحتوي على إدخالات مكررة وفقاً لمقارنات التجزئة و المساواة العامة على المفاتيح التي يتم إرجاعها من قبل دالة إنشاء المفتاح المعطاه . إذا تم حدوث العنصر عدة مرات في التسلسل سوف يتم تجاهل التكرارات الاحقه.

فارغة

إنشاء تسلسل فارغ.

exists

اختبار إذا كان أي عنصر من التسلسل يفي دالة التقييم المعطى.

exists2

اختبار حالة أي زوج من العناصر المقابلة من التسلسلات المدخلة يفي دالة التقييم المعطاه.

عامل تصفية

ترجع مجموعة جديدة تحتوي فقط على عناصر المجموعة التي ترجع عندها دالة التقييم المعطاة "صحيح".

بحث

تعيد العنصر الأول الذي قيمة الدالة المعطاة عنده: true.

findIndex

تقوم بإرجاع فهرس أول عنصر الذي قيمة الدالة المعطاة عنده true.

fold

تطبق دالة على كل عنصر في المجموعة، عن طريق الاستخدام المتوازي لوسيطة مجمع خلال العملية الحسابية. إذا كانت الدالة المدخلة هي f و العناصر هي i0...iN فتحسب f (... (f s i0)...) iN.

forall

تختبر ما إذا كانت كل العناصر في التسلسل مستوفية دالة التقييم المعطاة.

forall2

اختبار كافة أزواج العناصر المرسومة من التسلسلان إذا كانوا يقومون باستيفاء دالة التقييم المعطى. إذا كان أحد التسلسلات أقصر من الآخر سوف يتم تجاهل العناصر المتبقية للتسلسل الأطول .

groupBy

يتم تطبيق دالة إنشاء المفاتيح على كل عنصر في تسلسل و العائد تسلسل مكون من مفاتيح فريدة. يحتوي كل مفتاح فريد أيضاً على سلسلة من كافة العناصر التي تطابق هذا المفتاح.

head

إرجاع العناصر الأول من التسلسل.

init

تنشئ تسلسل جديد الذي عند تكراره يقوم بإرجاع عناصر متتابعة عن طريق استدعاء الدالة المعطاة، للأعلى للعدد المعطى. لن يتم حفظ نتائج الاتصال بالدالة، و سيتم إعادة تطبيق الدالة حسب الحاجة لإعادة إنشاء العناصر. يتم تمرير فهرس العنصر الذي يتم إنشاؤه إلى الدالة.

initInfinite

تنشئ تسلسل جديد الذي عند تكراره يقوم بإرجاع عناصر متتابعة عن طريق استدعاء الدالة المعطاة. لن يتم حفظ نتائج الاتصال بالدالة، و سيتم إعادة تطبيق الدالة حسب الحاجة لإعادة إنشاء العناصر. يتم تمرير فهرس العنصر الذي يتم إنشاؤه إلى الدالة.

isEmpty

تقوم بإرجاع"true" إذا كانت المتسلسلة لا تحتوي على عناصر، و "false" خلاف ذلك.

iter

تطبق الدالة المعطاة على كل عنصر من المجموعة.

iter2

تقوم بتطبيق الدالة المعطاه على مجموعتين في نفس الوقت. إذا كان أحد التسلسلات أقصر من الآخر سوف يتم تجاهل العناصر المتبقية للتسلسل الأطول .

iteri

تطبق الدالة المعطاة على كل عنصر من المجموعة. الأعداد الصحيحة التي تم تمريرها للدالة توضح ترتيب العنصر.

طولها

تقوم بإرجاع طول التسلسل.

مخطط

إنشاء مجموعة جديدة عناصرها هي نتائج تطبيق الدالة المعطاه لكل من عناصر المجموعة. سيتم تطبيق الدالة المعطاه ما دامت العناصر تطالب باستخدام الأسلوب MoveNext على العدادات العائدة من الكائن.

map2

إنشاء مجموعة جديدة عناصرها هي نتائج تطبيق الدالة المعطاة على أزواج العناصر الموازية من التسلسلين. إذا كان أحد التسلسلات المدخلة أقصر من الآخر سوف يتم تجاهل العناصر المتبقية للتسلسل الأطول .

mapi

إنشاء مجموعة جديدة عناصرها هي نتائج تطبيق الدالة المعطاه لكل من عناصر المجموعة. فهرس العدد الصحيح الذي تم تمريره إلى الدالة يشير إلى الفهرس (من 0) لعنصر يتم تحويله.

max

إرجاع أكبر عنصر في التسلسل و المقارنة تتم بواسطة Operators.max

maxBy

إرجاع أكبر عنصر في التسلسل بالمقارنة بواسطة Operators.max على دالة النتيجة.

min

إرجاع أقل عنصر في التسلسل بالمقارنة بواسطة Operators.min.

minBy

إرجاع أقل عنصر فى التسلسل بالمقارنة عبر Operators.min على دالة النتيجة.

nth

يحسب العنصر الذى رقمه n في المجموعة.

ofArray

تعرض الصفيف المعطى على شكل تسلسل.

ofList

تعرض القائمة المعطاة كتسلسل.

pairwise

إرجاع تسلسل من كل عنصر في تسلسل الإدخال و مهمته السابقة ، مع استثناء العنصر الأول الذي يتم إرجاعه فقط كـمهمة سابقة للعنصر الثاني.

pick

تطبيق الدالةالمعطاة على عناصر متتالية، و إرجاع أول x حيث ترجع الدالة: "Some(x)".

readonly

إنشاء كائن تسلسل جديد يتم تفويضه لكائن التسلسل المعطى. هذا يضمن ان التسلسل الأصلي غير قابل لإعادة إستكشاف و تصبح منيعة لانتشار النوع. على سبيل المثال، في حالة إعطاء مصفوفة التسلسل الذي تم إرجاعه سوف تقوم بإرجاع عناصر المصفوفة ولكن لا يمكن تحويل كائن التسلسل إلى مصفوفة.

reduce

تطبق دالة على كل عنصر في التسلسل، عن طريق الإستخدام المتوازي لوسيطة مجمع خلال العملية الحسابية. تبدأ بتطبيق الدالة لأول عنصرين. ثم إدخال هذه النتيجة في الدالة مع العنصر الثالث و إلخ. إرجاع النتيجة النهائية.

مسح

مثل fold ولكن تقوم بالحساب عند الطلب وإرجاع تسلسل وسيط ونتائج نهائية.

singleton

إرجاع تسلسل يعطي عنصر واحد فقط.

skip

ترجع تسلسل: يتخطى عدد "ن" من عناصر التسلسل الأساسي، ثم تعطي العناصر المتبقية في التسلسل.

skipWhile

إرجاع تسلسل: عند تكراره، يتخطى عناصر التسلسل الأساسي عندما ترجع دالة التقييم المعطاة true ، ومن ثم تعطي عناصر التسلسل المتبقية.

فرز

تعطي تسلسل مرتب عن طريق مفاتيح.

sortBy

يتم تطبيق مفتاح - إنشاء دالة إلى كل عنصر في تسلسل و العائد تسلسل مرتب عن طريق مفاتيح. تتم مقارنة المفاتيح باستخدام المقارنة العامة حيث تم إنشائها من قبل Operators.compare.

Sum

إرجاع مجموع العناصر في التسلسل.

sumBy

إرجاع مجموع النتائج التي تم إنشاؤها بواسطة تطبيق الدالة على كل عنصر في التسلسل.

take

إرجاع عدد عناصر معين من التسلسل.

takeWhile

إرجاع تسلسل: عند تكراره، يجعل عناصر التسلسل الأساسي عندما ترجع دالة التقييم المعطاة true ، ومن ثم لا تقوم بإرجاع أى عناصر.

toArray

ينشئ مصفوفة من مجموعة معطاه.

toList

إنشاء قائمة من المجموعة المعطاة.

truncate

إرجاع تسلسل عند تعداده يقوم بإرجاع على الأكثر N عنصر.

tryFind

تعيد العنصر الأول الذي قيمة الدالة المعطاة عنده: true. و ترجع None إذا لم يوجد مثل هذا العنصر.

tryFindIndex

إرجاع فهرس العنصر الأول في التسلسل الذي يستوفي دالة التقييم المعطاة. و ترجع None إذا لم يوجد مثل هذا العنصر.

tryPick

تطبيق الدالةالمعطاة على عناصر متتالية، و إرجاع أول نتيجة حيث ترجع الدالة: "(Some(x".

unfold

إرجاع سلسلة تحتوي على العناصر التي تم إنشاؤها بواسطة العملية الحسابية المعطاه. الوسيطة الأولي state المعطاه يتم تمريرها إلى منشئ العنصر. بالنسبة لكل العناصر IEnumerator في الدفق هي التي تم إنشاؤها عند الطلب عن طريق تطبيق منشئ العنصر حتى لا يتم إرجاع أى قيمة من منشئ العنصر. كل استدعاء لمنشئ العنصر يقوم بإرجاع باقي جديد state.

windowed

إرجاع تسلسل يعطي إنزلاق الإطارات التي تحتوي على عناصر رسم من تسلسل الإدخال. كل نافذة يتم إرجاعها كمصفوفة حديثة.

zip

تضم إثنين من التسلسلات إلى قائمة أزواج. لا تحتاج التسلسلات أن تكون متساوية فى الطول: عند استنفاد تسلسل واحد أية عناصر متبقية في التسلسل الأخر يتم تجاهلها .

zip3

ضم التسلسلات الثلاثة في قائمة ثلاثية. لا تحتاج التسلسلات أن تكون متساوية فى الطول: عند استنفاد تسلسل واحد أية عناصر متبقية في التسلسلات الأخرى يتم تجاهلها .

الأنظمة الأساسية

Windows 7, Windows Vista SP2, Windows XP SP3, Windows XP x64 SP2, Windows Server 2008 R2, Windows Server 2008 SP2, Windows Server 2003 SP2

معلومات الإصدار

وقت التشغيل #F

معتمد في: 2.0, 4.0

Silverlight

معتمد في: 3

راجع أيضًا:

المرجع

تسلسلات (F #)

موارد أخرى

مساحة الاسم Microsoft.FSharp.Collections

نوع الإختصار<Collections.seq<'T