Sequence.Generators.cs

using System;
using System.Collections.Generic;

namespace ABCNET.Utils
{
    /// <summary>
    /// Ïðåäîñòàâëÿåò ôóíêöèîíàë äëÿ ðàáîòû ñ ïîñëåäîâàòåëüíîñòÿìè.
    /// </summary>
    public static partial class Sequence
    {
        #region public
        /// <summary>
        /// Ñîçäà¸ò ïîñëåäîâàòåëüíîñòü íà îñíîâå ôóíêöèè ñåëåêòîðà.
        /// </summary>
        /// <param name="count">Êîëè÷åñòâî ýëåìåíòîâ.</param>
        /// <param name="selector">Ôóíêöèÿ ñåëåêòîð.</param>
        /// <param name="firstIndex">Íà÷àëüíûé èíäåêñ.</param>
        /// <returns>Ïîñëåäîâàòåëüíîñòü.</returns>
        public static IEnumerable<T> By<T>(int count, Func<int, T> selector, int firstIndex = 0)
        {
            if (count < 0)
                throw new ArgumentOutOfRangeException(nameof(count));
            if (selector == null)
                throw new ArgumentNullException(nameof(selector));

            for (int i = 0; i < count; i++)
                yield return selector(i + firstIndex);
        }

        /// <summary>
        /// Ñîçäà¸ò ïîñëåäîâàòåëüíîñòü ñëó÷àéíûõ ÷èñåë òèïà Integer.
        /// </summary>
        /// <param name="count">Êîëè÷åñòâî ýëåìåíòîâ.</param>
        /// <param name="low">Íèæíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <param name="high">Âåðõíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <returns>Ïîñëåäîâàòåëüíîñòü.</returns>
        public static IEnumerable<int> Random(int count, int low = Int32BordersHelper.Low, int high = Int32BordersHelper.High)
        {
            if (count < 0)
                throw new ArgumentOutOfRangeException(nameof(count));
            if (low > high)
                throw new ArgumentException(nameof(low));

            for (int i = 0; i < count; i++)
                yield return Base.Random(low, high);
        }

        /// <summary>
        /// Ñîçäà¸ò ïîñëåäîâàòåëüíîñòü ñëó÷àéíûõ ÷èñåë òèïà Real.
        /// </summary>
        /// <param name="count">Êîëè÷åñòâî ýëåìåíòîâ.</param>
        /// <param name="low">Íèæíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <param name="high">Âåðõíÿÿ ãðàíèöà äèàïàçîíà.</param>
        /// <returns>Ïîñëåäîâàòåëüíîñòü.</returns>
        public static IEnumerable<double> Random(int count, double low = DoubleBordersHelper.Low, double high = DoubleBordersHelper.High)
        {
            if (count < 0)
                throw new ArgumentOutOfRangeException(nameof(count));
            if (low > high)
                throw new ArgumentException(nameof(low));

            for (int i = 0; i < count; i++)
                yield return Base.Random(low, high);
        }

        /// <summary>
        /// Ñîçäà¸ò ïîñëåäîâàòåëüíîñòü, çàïîëíåííóþ óêàçàííûì çíà÷åíèåì.
        /// </summary>
        /// <param name="count">Êîëè÷åñòâî ýëåìåíòîâ.</param>
        /// <param name="value">Çíà÷åíèå.</param>
        /// <returns>Ïîñëåäîâàòåëüíîñòü.</returns>
        public static IEnumerable<T> Fill<T>(int count, T value)
        {
            if (count < 0)
                throw new ArgumentOutOfRangeException(nameof(count));

            for (int i = 0; i < count; i++)
                yield return value;
        }
        #endregion public
    }
}