IEnumerableExtensions.cs 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603
  1. #nullable enable
  2. using System;
  3. using System.Collections.Generic;
  4. using System.Linq;
  5. using System.Linq.Expressions;
  6. using System.Threading;
  7. using System.Threading.Tasks;
  8. namespace Masuit.Tools
  9. {
  10. public static partial class IEnumerableExtensions
  11. {
  12. #if NET6_0
  13. #else
  14. /// <summary>
  15. /// 按字段去重
  16. /// </summary>
  17. /// <typeparam name="TSource"></typeparam>
  18. /// <typeparam name="TKey"></typeparam>
  19. /// <param name="source"></param>
  20. /// <param name="keySelector"></param>
  21. /// <returns></returns>
  22. public static IEnumerable<TSource> DistinctBy<TSource, TKey>(this IEnumerable<TSource> source, Func<TSource, TKey> keySelector)
  23. {
  24. var hash = new HashSet<TKey>();
  25. return source.Where(p => hash.Add(keySelector(p)));
  26. }
  27. #endif
  28. /// <summary>
  29. /// 添加多个元素
  30. /// </summary>
  31. /// <typeparam name="T"></typeparam>
  32. /// <param name="this"></param>
  33. /// <param name="values"></param>
  34. public static void AddRange<T>(this ICollection<T> @this, params T[] values)
  35. {
  36. foreach (var obj in values)
  37. {
  38. @this.Add(obj);
  39. }
  40. }
  41. /// <summary>
  42. /// 添加符合条件的多个元素
  43. /// </summary>
  44. /// <typeparam name="T"></typeparam>
  45. /// <param name="this"></param>
  46. /// <param name="predicate"></param>
  47. /// <param name="values"></param>
  48. public static void AddRangeIf<T>(this ICollection<T> @this, Func<T, bool> predicate, params T[] values)
  49. {
  50. foreach (var obj in values)
  51. {
  52. if (predicate(obj))
  53. {
  54. @this.Add(obj);
  55. }
  56. }
  57. }
  58. /// <summary>
  59. /// 添加不重复的元素
  60. /// </summary>
  61. /// <typeparam name="T"></typeparam>
  62. /// <param name="this"></param>
  63. /// <param name="values"></param>
  64. public static void AddRangeIfNotContains<T>(this ICollection<T> @this, params T[] values)
  65. {
  66. foreach (T obj in values)
  67. {
  68. if ([email protected](obj))
  69. {
  70. @this.Add(obj);
  71. }
  72. }
  73. }
  74. /// <summary>
  75. /// 移除符合条件的元素
  76. /// </summary>
  77. /// <typeparam name="T"></typeparam>
  78. /// <param name="this"></param>
  79. /// <param name="where"></param>
  80. public static void RemoveWhere<T>(this ICollection<T> @this, Func<T, bool> @where)
  81. {
  82. foreach (var obj in @this.Where(where).ToList())
  83. {
  84. @this.Remove(obj);
  85. }
  86. }
  87. /// <summary>
  88. /// 在元素之后添加元素
  89. /// </summary>
  90. /// <typeparam name="T"></typeparam>
  91. /// <param name="list"></param>
  92. /// <param name="condition">条件</param>
  93. /// <param name="value">值</param>
  94. public static void InsertAfter<T>(this IList<T> list, Func<T, bool> condition, T value)
  95. {
  96. foreach (var item in list.Select((item, index) => new { item, index }).Where(p => condition(p.item)).OrderByDescending(p => p.index))
  97. {
  98. if (item.index + 1 == list.Count)
  99. {
  100. list.Add(value);
  101. }
  102. else
  103. {
  104. list.Insert(item.index + 1, value);
  105. }
  106. }
  107. }
  108. /// <summary>
  109. /// 在元素之后添加元素
  110. /// </summary>
  111. /// <typeparam name="T"></typeparam>
  112. /// <param name="list"></param>
  113. /// <param name="index">索引位置</param>
  114. /// <param name="value">值</param>
  115. public static void InsertAfter<T>(this IList<T> list, int index, T value)
  116. {
  117. foreach (var item in list.Select((v, i) => new { Value = v, Index = i }).Where(p => p.Index == index).OrderByDescending(p => p.Index))
  118. {
  119. if (item.Index + 1 == list.Count)
  120. {
  121. list.Add(value);
  122. }
  123. else
  124. {
  125. list.Insert(item.Index + 1, value);
  126. }
  127. }
  128. }
  129. /// <summary>
  130. /// 转HashSet
  131. /// </summary>
  132. /// <typeparam name="T"></typeparam>
  133. /// <typeparam name="TResult"></typeparam>
  134. /// <param name="source"></param>
  135. /// <param name="selector"></param>
  136. /// <returns></returns>
  137. public static HashSet<TResult> ToHashSet<T, TResult>(this IEnumerable<T> source, Func<T, TResult> selector)
  138. {
  139. var set = new HashSet<TResult>();
  140. set.UnionWith(source.Select(selector));
  141. return set;
  142. }
  143. /// <summary>
  144. /// 遍历IEnumerable
  145. /// </summary>
  146. /// <param name="objs"></param>
  147. /// <param name="action">回调方法</param>
  148. /// <typeparam name="T"></typeparam>
  149. public static void ForEach<T>(this IEnumerable<T> objs, Action<T> action)
  150. {
  151. foreach (var o in objs)
  152. {
  153. action(o);
  154. }
  155. }
  156. /// <summary>
  157. /// 异步foreach
  158. /// </summary>
  159. /// <typeparam name="T"></typeparam>
  160. /// <param name="source"></param>
  161. /// <param name="maxParallelCount">最大并行数</param>
  162. /// <param name="action"></param>
  163. /// <param name="cancellationToken"></param>
  164. /// <returns></returns>
  165. public static async Task ForeachAsync<T>(this IEnumerable<T> source, Func<T, Task> action, int maxParallelCount, CancellationToken cancellationToken = default)
  166. {
  167. var list = new List<Task>();
  168. foreach (var item in source)
  169. {
  170. if (cancellationToken.IsCancellationRequested)
  171. {
  172. return;
  173. }
  174. list.Add(action(item));
  175. if (list.Count >= maxParallelCount)
  176. {
  177. await Task.WhenAll(list);
  178. list.Clear();
  179. }
  180. }
  181. await Task.WhenAll(list);
  182. }
  183. /// <summary>
  184. /// 异步foreach
  185. /// </summary>
  186. /// <typeparam name="T"></typeparam>
  187. /// <param name="source"></param>
  188. /// <param name="action"></param>
  189. /// <returns></returns>
  190. public static Task ForeachAsync<T>(this IEnumerable<T> source, Func<T, Task> action, CancellationToken cancellationToken = default)
  191. {
  192. return ForeachAsync(source, action, source.Count(), cancellationToken);
  193. }
  194. /// <summary>
  195. /// 异步Select
  196. /// </summary>
  197. /// <typeparam name="T"></typeparam>
  198. /// <typeparam name="TResult"></typeparam>
  199. /// <param name="source"></param>
  200. /// <param name="selector"></param>
  201. /// <returns></returns>
  202. public static Task<TResult[]> SelectAsync<T, TResult>(this IEnumerable<T> source, Func<T, Task<TResult>> selector)
  203. {
  204. return Task.WhenAll(source.Select(selector));
  205. }
  206. /// <summary>
  207. /// 异步Select
  208. /// </summary>
  209. /// <typeparam name="T"></typeparam>
  210. /// <typeparam name="TResult"></typeparam>
  211. /// <param name="source"></param>
  212. /// <param name="selector"></param>
  213. /// <returns></returns>
  214. public static Task<TResult[]> SelectAsync<T, TResult>(this IEnumerable<T> source, Func<T, int, Task<TResult>> selector)
  215. {
  216. return Task.WhenAll(source.Select(selector));
  217. }
  218. /// <summary>
  219. /// 异步For
  220. /// </summary>
  221. /// <typeparam name="T"></typeparam>
  222. /// <param name="source"></param>
  223. /// <param name="selector"></param>
  224. /// <param name="maxParallelCount">最大并行数</param>
  225. /// <param name="cancellationToken">取消口令</param>
  226. /// <returns></returns>
  227. public static async Task ForAsync<T>(this IEnumerable<T> source, Func<T, int, Task> selector, int maxParallelCount, CancellationToken cancellationToken = default)
  228. {
  229. var list = new List<Task>();
  230. int index = 0;
  231. foreach (var item in source)
  232. {
  233. if (cancellationToken.IsCancellationRequested)
  234. {
  235. return;
  236. }
  237. list.Add(selector(item, index++));
  238. if (list.Count >= maxParallelCount)
  239. {
  240. await Task.WhenAll(list);
  241. list.Clear();
  242. }
  243. }
  244. await Task.WhenAll(list);
  245. }
  246. /// <summary>
  247. /// 异步For
  248. /// </summary>
  249. /// <typeparam name="T"></typeparam>
  250. /// <param name="source"></param>
  251. /// <param name="selector"></param>
  252. /// <param name="cancellationToken">取消口令</param>
  253. /// <returns></returns>
  254. public static Task ForAsync<T>(this IEnumerable<T> source, Func<T, int, Task> selector, CancellationToken cancellationToken = default)
  255. {
  256. return ForAsync(source, selector, source.Count(), cancellationToken);
  257. }
  258. /// <summary>
  259. /// 取最大值
  260. /// </summary>
  261. /// <typeparam name="TSource"></typeparam>
  262. /// <typeparam name="TResult"></typeparam>
  263. /// <param name="source"></param>
  264. /// <param name="selector"></param>
  265. /// <returns></returns>
  266. public static TResult MaxOrDefault<TSource, TResult>(this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector) => source.Select(selector).DefaultIfEmpty().Max();
  267. /// <summary>
  268. /// 取最大值
  269. /// </summary>
  270. /// <typeparam name="TSource"></typeparam>
  271. /// <typeparam name="TResult"></typeparam>
  272. /// <param name="source"></param>
  273. /// <param name="selector"></param>
  274. /// <param name="defaultValue"></param>
  275. /// <returns></returns>
  276. public static TResult MaxOrDefault<TSource, TResult>(this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector, TResult defaultValue) => source.Select(selector).DefaultIfEmpty(defaultValue).Max();
  277. /// <summary>
  278. /// 取最大值
  279. /// </summary>
  280. /// <typeparam name="TSource"></typeparam>
  281. /// <param name="source"></param>
  282. /// <returns></returns>
  283. public static TSource MaxOrDefault<TSource>(this IQueryable<TSource> source) => source.DefaultIfEmpty().Max();
  284. /// <summary>
  285. /// 取最大值
  286. /// </summary>
  287. /// <typeparam name="TSource"></typeparam>
  288. /// <param name="source"></param>
  289. /// <param name="defaultValue"></param>
  290. /// <returns></returns>
  291. public static TSource MaxOrDefault<TSource>(this IQueryable<TSource> source, TSource defaultValue) => source.DefaultIfEmpty(defaultValue).Max();
  292. /// <summary>
  293. /// 取最大值
  294. /// </summary>
  295. /// <typeparam name="TSource"></typeparam>
  296. /// <typeparam name="TResult"></typeparam>
  297. /// <param name="source"></param>
  298. /// <param name="selector"></param>
  299. /// <param name="defaultValue"></param>
  300. /// <returns></returns>
  301. public static TResult MaxOrDefault<TSource, TResult>(this IEnumerable<TSource> source, Func<TSource, TResult> selector, TResult defaultValue) => source.Select(selector).DefaultIfEmpty(defaultValue).Max();
  302. /// <summary>
  303. /// 取最大值
  304. /// </summary>
  305. /// <typeparam name="TSource"></typeparam>
  306. /// <typeparam name="TResult"></typeparam>
  307. /// <param name="source"></param>
  308. /// <param name="selector"></param>
  309. /// <returns></returns>
  310. public static TResult MaxOrDefault<TSource, TResult>(this IEnumerable<TSource> source, Func<TSource, TResult> selector) => source.Select(selector).DefaultIfEmpty().Max();
  311. /// <summary>
  312. /// 取最大值
  313. /// </summary>
  314. /// <typeparam name="TSource"></typeparam>
  315. /// <param name="source"></param>
  316. /// <returns></returns>
  317. public static TSource MaxOrDefault<TSource>(this IEnumerable<TSource> source) => source.DefaultIfEmpty().Max();
  318. /// <summary>
  319. /// 取最大值
  320. /// </summary>
  321. /// <typeparam name="TSource"></typeparam>
  322. /// <param name="source"></param>
  323. /// <param name="defaultValue"></param>
  324. /// <returns></returns>
  325. public static TSource MaxOrDefault<TSource>(this IEnumerable<TSource> source, TSource defaultValue) => source.DefaultIfEmpty(defaultValue).Max();
  326. /// <summary>
  327. /// 取最小值
  328. /// </summary>
  329. /// <typeparam name="TSource"></typeparam>
  330. /// <typeparam name="TResult"></typeparam>
  331. /// <param name="source"></param>
  332. /// <param name="selector"></param>
  333. /// <returns></returns>
  334. public static TResult MinOrDefault<TSource, TResult>(this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector) => source.Select(selector).DefaultIfEmpty().Min();
  335. /// <summary>
  336. /// 取最小值
  337. /// </summary>
  338. /// <typeparam name="TSource"></typeparam>
  339. /// <typeparam name="TResult"></typeparam>
  340. /// <param name="source"></param>
  341. /// <param name="selector"></param>
  342. /// <param name="defaultValue"></param>
  343. /// <returns></returns>
  344. public static TResult MinOrDefault<TSource, TResult>(this IQueryable<TSource> source, Expression<Func<TSource, TResult>> selector, TResult defaultValue) => source.Select(selector).DefaultIfEmpty(defaultValue).Min();
  345. /// <summary>
  346. /// 取最小值
  347. /// </summary>
  348. /// <typeparam name="TSource"></typeparam>
  349. /// <param name="source"></param>
  350. /// <returns></returns>
  351. public static TSource MinOrDefault<TSource>(this IQueryable<TSource> source) => source.DefaultIfEmpty().Min();
  352. /// <summary>
  353. /// 取最小值
  354. /// </summary>
  355. /// <typeparam name="TSource"></typeparam>
  356. /// <param name="source"></param>
  357. /// <param name="defaultValue"></param>
  358. /// <returns></returns>
  359. public static TSource MinOrDefault<TSource>(this IQueryable<TSource> source, TSource defaultValue) => source.DefaultIfEmpty(defaultValue).Min();
  360. /// <summary>
  361. /// 取最小值
  362. /// </summary>
  363. /// <typeparam name="TSource"></typeparam>
  364. /// <typeparam name="TResult"></typeparam>
  365. /// <param name="source"></param>
  366. /// <param name="selector"></param>
  367. /// <returns></returns>
  368. public static TResult MinOrDefault<TSource, TResult>(this IEnumerable<TSource> source, Func<TSource, TResult> selector) => source.Select(selector).DefaultIfEmpty().Min();
  369. /// <summary>
  370. /// 取最小值
  371. /// </summary>
  372. /// <typeparam name="TSource"></typeparam>
  373. /// <typeparam name="TResult"></typeparam>
  374. /// <param name="source"></param>
  375. /// <param name="selector"></param>
  376. /// <param name="defaultValue"></param>
  377. /// <returns></returns>
  378. public static TResult MinOrDefault<TSource, TResult>(this IEnumerable<TSource> source, Func<TSource, TResult> selector, TResult defaultValue) => source.Select(selector).DefaultIfEmpty(defaultValue).Min();
  379. /// <summary>
  380. /// 取最小值
  381. /// </summary>
  382. /// <typeparam name="TSource"></typeparam>
  383. /// <param name="source"></param>
  384. /// <returns></returns>
  385. public static TSource MinOrDefault<TSource>(this IEnumerable<TSource> source) => source.DefaultIfEmpty().Min();
  386. /// <summary>
  387. /// 取最小值
  388. /// </summary>
  389. /// <typeparam name="TSource"></typeparam>
  390. /// <param name="source"></param>
  391. /// <param name="defaultValue"></param>
  392. /// <returns></returns>
  393. public static TSource MinOrDefault<TSource>(this IEnumerable<TSource> source, TSource defaultValue) => source.DefaultIfEmpty(defaultValue).Min();
  394. /// <summary>
  395. /// 标准差
  396. /// </summary>
  397. /// <typeparam name="T"></typeparam>
  398. /// <param name="source"></param>
  399. /// <param name="selector"></param>
  400. /// <returns></returns>
  401. public static TResult StandardDeviation<T, TResult>(this IEnumerable<T> source, Func<T, TResult> selector) where TResult : IConvertible
  402. {
  403. return StandardDeviation(source.Select(t => selector(t).ConvertTo<double>())).ConvertTo<TResult>();
  404. }
  405. /// <summary>
  406. /// 标准差
  407. /// </summary>
  408. /// <typeparam name="T"></typeparam>
  409. /// <param name="source"></param>
  410. /// <returns></returns>
  411. public static T StandardDeviation<T>(this IEnumerable<T> source) where T : IConvertible
  412. {
  413. return StandardDeviation(source.Select(t => t.ConvertTo<double>())).ConvertTo<T>();
  414. }
  415. /// <summary>
  416. /// 标准差
  417. /// </summary>
  418. /// <param name="source"></param>
  419. /// <returns></returns>
  420. public static double StandardDeviation(this IEnumerable<double> source)
  421. {
  422. double result = 0;
  423. int count = source.Count();
  424. if (count > 1)
  425. {
  426. double avg = source.Average();
  427. double sum = source.Sum(d => (d - avg) * (d - avg));
  428. result = Math.Sqrt(sum / count);
  429. }
  430. return result;
  431. }
  432. /// <summary>
  433. /// 随机排序
  434. /// </summary>
  435. /// <typeparam name="T"></typeparam>
  436. /// <param name="source"></param>
  437. /// <returns></returns>
  438. public static IOrderedEnumerable<T> OrderByRandom<T>(this IEnumerable<T> source)
  439. {
  440. return source.OrderBy(_ => Guid.NewGuid());
  441. }
  442. /// <summary>
  443. /// 序列相等
  444. /// </summary>
  445. /// <typeparam name="T"></typeparam>
  446. /// <param name="first"></param>
  447. /// <param name="second"></param>
  448. /// <param name="condition"></param>
  449. /// <returns></returns>
  450. public static bool SequenceEqual<T>(this IEnumerable<T> first, IEnumerable<T> second, Func<T, T, bool> condition)
  451. {
  452. if (first is ICollection<T> source1 && second is ICollection<T> source2)
  453. {
  454. if (source1.Count != source2.Count)
  455. {
  456. return false;
  457. }
  458. if (source1 is IList<T> list1 && source2 is IList<T> list2)
  459. {
  460. int count = source1.Count;
  461. for (int index = 0; index < count; ++index)
  462. {
  463. if (!condition(list1[index], list2[index]))
  464. {
  465. return false;
  466. }
  467. }
  468. return true;
  469. }
  470. }
  471. using IEnumerator<T> enumerator1 = first.GetEnumerator();
  472. using IEnumerator<T> enumerator2 = second.GetEnumerator();
  473. while (enumerator1.MoveNext())
  474. {
  475. if (!enumerator2.MoveNext() || !condition(enumerator1.Current, enumerator2.Current))
  476. {
  477. return false;
  478. }
  479. }
  480. return !enumerator2.MoveNext();
  481. }
  482. /// <summary>
  483. /// 序列相等
  484. /// </summary>
  485. /// <typeparam name="T1"></typeparam>
  486. /// <typeparam name="T2"></typeparam>
  487. /// <param name="first"></param>
  488. /// <param name="second"></param>
  489. /// <param name="condition"></param>
  490. /// <returns></returns>
  491. public static bool SequenceEqual<T1, T2>(this IEnumerable<T1> first, IEnumerable<T2> second, Func<T1, T2, bool> condition)
  492. {
  493. if (first is ICollection<T1> source1 && second is ICollection<T2> source2)
  494. {
  495. if (source1.Count != source2.Count)
  496. {
  497. return false;
  498. }
  499. if (source1 is IList<T1> list1 && source2 is IList<T2> list2)
  500. {
  501. int count = source1.Count;
  502. for (int index = 0; index < count; ++index)
  503. {
  504. if (!condition(list1[index], list2[index]))
  505. {
  506. return false;
  507. }
  508. }
  509. return true;
  510. }
  511. }
  512. using IEnumerator<T1> enumerator1 = first.GetEnumerator();
  513. using IEnumerator<T2> enumerator2 = second.GetEnumerator();
  514. while (enumerator1.MoveNext())
  515. {
  516. if (!enumerator2.MoveNext() || !condition(enumerator1.Current, enumerator2.Current))
  517. {
  518. return false;
  519. }
  520. }
  521. return !enumerator2.MoveNext();
  522. }
  523. /// <summary>
  524. /// 对比两个集合哪些是新增的、删除的、修改的
  525. /// </summary>
  526. /// <typeparam name="T1"></typeparam>
  527. /// <typeparam name="T2"></typeparam>
  528. /// <param name="olds"></param>
  529. /// <param name="news"></param>
  530. /// <param name="key1Selector">对比因素属性</param>
  531. /// <param name="key2Selector">对比因素属性</param>
  532. /// <returns></returns>
  533. public static (IEnumerable<T2> adds, IEnumerable<T1> remove, IEnumerable<T1> updates) CompareChanges<T1, T2>(this IEnumerable<T1> olds, IEnumerable<T2> news, Func<T1, object> key1Selector, Func<T2, object> key2Selector)
  534. {
  535. return (news.Where(c => olds.All(m => key1Selector(m) != key2Selector(c))), olds.Where(m => news.All(c => key2Selector(c) != key1Selector(m))), olds.Where(m => news.Any(c => key1Selector(m) == key2Selector(c))));
  536. }
  537. /// <summary>
  538. /// 对比两个集合哪些是新增的、删除的、修改的
  539. /// </summary>
  540. /// <typeparam name="T"></typeparam>
  541. /// <param name="olds"></param>
  542. /// <param name="news"></param>
  543. /// <param name="keySelector">对比因素属性</param>
  544. /// <returns></returns>
  545. public static (IEnumerable<T> adds, IEnumerable<T> remove, IEnumerable<T> updates) CompareChanges<T>(this IEnumerable<T> olds, IEnumerable<T> news, Func<T, object> keySelector)
  546. {
  547. return (news.Where(c => olds.All(m => keySelector(m) != keySelector(c))), olds.Where(m => news.All(c => keySelector(c) != keySelector(m))), olds.Where(m => news.Any(c => keySelector(m) == keySelector(c))));
  548. }
  549. }
  550. }