BitsUtil.cs 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Diagnostics;
  4. using System.Linq;
  5. using System.Text;
  6. using System.Threading.Tasks;
  7. namespace CSharpUtil
  8. {
  9. public static class BitsUtil
  10. {
  11. #region byte extension
  12. /// <summary>
  13. /// 返回Int数据中某一位是否为1
  14. /// </summary>
  15. /// <param name="value"></param>
  16. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  17. /// <returns>true表示该位为1,false表示该位为0</returns>
  18. public static bool GetBitValue(this byte value, int index)
  19. {
  20. Trace.Assert(index >= 0 && index <= 7, $"{nameof(index)} is Out Of Range(0..7).");//索引出错
  21. int val = 1 << index;
  22. return (value & val) == val;
  23. }
  24. /// <summary>
  25. /// 设定Int数据中某一位的值
  26. /// </summary>
  27. /// <param name="value">位设定前的值</param>
  28. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  29. /// <param name="bitValue">true设该位为1,false设为0</param>
  30. /// <returns>返回位设定后的值</returns>
  31. public static byte SetBitValue(ref this byte value, int index, bool bitValue)
  32. {
  33. Trace.Assert(index >= 0 && index <= 7, $"{nameof(index)} is Out Of Range(0..7).");//索引出错
  34. var val = (byte)(1 << index);
  35. value = (byte)(bitValue ? (value | val) : (value & ~val));
  36. return value;
  37. }
  38. /// <summary>
  39. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  40. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  41. /// </summary>
  42. /// <param name="value"></param>
  43. /// <returns></returns>
  44. public static IEnumerable<bool> GetBitList(this byte value)
  45. {
  46. var list = new List<bool>(8);
  47. for (var i = 0; i <= 7; i++)
  48. {
  49. int val = 1 << i;
  50. list.Add((value & val) == val);
  51. }
  52. return list;
  53. }
  54. /// <summary>
  55. ///
  56. /// </summary>
  57. /// <param name="value"></param>
  58. /// <param name="index"></param>
  59. /// <returns></returns>
  60. public static bool Bit(this byte value, int index) => GetBitValue(value, index);
  61. /// <summary>
  62. ///
  63. /// </summary>
  64. /// <param name="value"></param>
  65. /// <returns></returns>
  66. public static bool[] Bits(this byte value)
  67. {
  68. var arr = new bool[8];
  69. for (var i = 0; i <= 7; i++)
  70. {
  71. int x = 1 << i;
  72. arr[i] = ((value & x) == x);
  73. }
  74. return arr;
  75. }
  76. #endregion
  77. #region ushort extension
  78. /// <summary>
  79. /// 返回Int数据中某一位是否为1
  80. /// </summary>
  81. /// <param name="value"></param>
  82. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  83. /// <returns>true表示该位为1,false表示该位为0</returns>
  84. public static bool GetBitValue(this ushort value, int index)
  85. {
  86. Trace.Assert(index >= 0 && index <= 15, $"{nameof(index)} is Out Of Range(0..15).");//索引出错
  87. int val = 1 << index;
  88. return (value & val) == val;
  89. }
  90. /// <summary>
  91. /// 设定Int数据中某一位的值
  92. /// </summary>
  93. /// <param name="value">位设定前的值</param>
  94. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  95. /// <param name="bitValue">true设该位为1,false设为0</param>
  96. /// <returns>返回位设定后的值</returns>
  97. public static ushort SetBitValue(ref this ushort value, int index, bool bitValue)
  98. {
  99. Trace.Assert(index >= 0 && index <= 15, $"{nameof(index)} is Out Of Range(0..15).");//索引出错
  100. var val = (ushort)(1 << index);
  101. value = (ushort)(bitValue ? (value | val) : (value & ~val));
  102. return value;
  103. }
  104. /// <summary>
  105. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  106. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  107. /// </summary>
  108. /// <param name="value"></param>
  109. /// <returns></returns>
  110. public static IEnumerable<bool> GetBitList(this ushort value)
  111. {
  112. var list = new List<bool>(16);
  113. for (var i = 0; i <= 15; i++)
  114. {
  115. int val = 1 << i;
  116. list.Add((value & val) == val);
  117. }
  118. return list;
  119. }
  120. /// <summary>
  121. ///
  122. /// </summary>
  123. /// <param name="value"></param>
  124. /// <param name="index"></param>
  125. /// <returns></returns>
  126. public static bool Bit(this ushort value, int index) => GetBitValue(value, index);
  127. /// <summary>
  128. ///
  129. /// </summary>
  130. /// <param name="value"></param>
  131. /// <returns></returns>
  132. public static bool[] Bits(this ushort value)
  133. {
  134. var arr = new bool[16];
  135. for (var i = 0; i <= 15; i++)
  136. {
  137. int x = 1 << i;
  138. arr[i] = ((value & x) == x);
  139. }
  140. return arr;
  141. }
  142. #endregion
  143. #region short extension
  144. /// <summary>
  145. /// 返回Int数据中某一位是否为1
  146. /// </summary>
  147. /// <param name="value"></param>
  148. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  149. /// <returns>true表示该位为1,false表示该位为0</returns>
  150. public static bool GetBitValue(this short value, int index)
  151. {
  152. Trace.Assert(index >= 0 && index <= 15, $"{nameof(index)} is Out Of Range(0..15).");//索引出错
  153. int val = 1 << index;
  154. return (value & val) == val;
  155. }
  156. /// <summary>
  157. /// 设定Int数据中某一位的值
  158. /// </summary>
  159. /// <param name="value">位设定前的值</param>
  160. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  161. /// <param name="bitValue">true设该位为1,false设为0</param>
  162. /// <returns>返回位设定后的值</returns>
  163. public static short SetBitValue(ref this short value, int index, bool bitValue)
  164. {
  165. Trace.Assert(index >= 0 && index <= 15, $"{nameof(index)} is Out Of Range(0..15).");//索引出错
  166. var val = (short)(1 << index);
  167. value = (short)(bitValue ? (value | val) : (value & ~val));
  168. return value;
  169. }
  170. /// <summary>
  171. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  172. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  173. /// </summary>
  174. /// <param name="value"></param>
  175. /// <returns></returns>
  176. public static IEnumerable<bool> GetBitList(this short value)
  177. {
  178. var list = new List<bool>(16);
  179. for (var i = 0; i <= 15; i++)
  180. {
  181. int val = 1 << i;
  182. list.Add((value & val) == val);
  183. }
  184. return list;
  185. }
  186. /// <summary>
  187. ///
  188. /// </summary>
  189. /// <param name="value"></param>
  190. /// <param name="index"></param>
  191. /// <returns></returns>
  192. public static bool Bit(this short value, int index) => GetBitValue(value, index);
  193. /// <summary>
  194. ///
  195. /// </summary>
  196. /// <param name="value"></param>
  197. /// <returns></returns>
  198. public static bool[] Bits(this short value)
  199. {
  200. var arr = new bool[16];
  201. for (var i = 0; i <= 15; i++)
  202. {
  203. int x = 1 << i;
  204. arr[i] = ((value & x) == x);
  205. }
  206. return arr;
  207. }
  208. #endregion
  209. #region Int extension
  210. /// <summary>
  211. /// 返回Int数据中某一位是否为1
  212. /// </summary>
  213. /// <param name="value"></param>
  214. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  215. /// <returns>true表示该位为1,false表示该位为0</returns>
  216. public static bool GetBitValue(this int value, int index)
  217. {
  218. Trace.Assert(index >= 0 && index <= 31, $"{nameof(index)} is Out Of Range(0..31).");//索引出错
  219. int val = 1 << index;
  220. return (value & val) == val;
  221. }
  222. /// <summary>
  223. /// 设定Int数据中某一位的值
  224. /// </summary>
  225. /// <param name="value">位设定前的值</param>
  226. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  227. /// <param name="bitValue">true设该位为1,false设为0</param>
  228. /// <returns>返回位设定后的值</returns>
  229. public static int SetBitValue(ref this int value, int index, bool bitValue)
  230. {
  231. Trace.Assert(index >= 0 && index <= 31, $"{nameof(index)} is Out Of Range(0..31).");//索引出错
  232. int val = 1 << index;
  233. value = bitValue ? (value | val) : (value & ~val);
  234. return value;
  235. }
  236. /// <summary>
  237. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  238. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  239. /// </summary>
  240. /// <param name="value"></param>
  241. /// <returns></returns>
  242. public static IEnumerable<bool> GetBitList(this int value)
  243. {
  244. var list = new List<bool>(32);
  245. for (var i = 0; i <= 31; i++)
  246. {
  247. int val = 1 << i;
  248. list.Add((value & val) == val);
  249. }
  250. return list;
  251. }
  252. /// <summary>
  253. ///
  254. /// </summary>
  255. /// <param name="value"></param>
  256. /// <param name="index"></param>
  257. /// <returns></returns>
  258. public static bool Bit(this int value, int index) => GetBitValue(value,index);
  259. /// <summary>
  260. ///
  261. /// </summary>
  262. /// <param name="value"></param>
  263. /// <returns></returns>
  264. public static bool[] Bits(this int value)
  265. {
  266. var arr = new bool[32];
  267. for (var i = 0; i <= 31; i++)
  268. {
  269. int x = 1 << i;
  270. arr[i] = ((value & x) == x);
  271. }
  272. return arr;
  273. }
  274. #endregion
  275. #region uint extension
  276. /// <summary>
  277. /// 返回Int数据中某一位是否为1
  278. /// </summary>
  279. /// <param name="value"></param>
  280. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  281. /// <returns>true表示该位为1,false表示该位为0</returns>
  282. public static bool GetBitValue(this uint value, int index)
  283. {
  284. Trace.Assert(index >= 0 && index <= 31, $"{nameof(index)} is Out Of Range(0..31).");//索引出错
  285. uint val = 1u << index;
  286. return (value & val) == val;
  287. }
  288. /// <summary>
  289. /// 设定Int数据中某一位的值
  290. /// </summary>
  291. /// <param name="value">位设定前的值</param>
  292. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  293. /// <param name="bitValue">true设该位为1,false设为0</param>
  294. /// <returns>返回位设定后的值</returns>
  295. public static uint SetBitValue(ref this uint value, int index, bool bitValue)
  296. {
  297. Trace.Assert(index >= 0 && index <= 31, $"{nameof(index)} is Out Of Range(0..31).");//索引出错
  298. uint val = 1u << index;
  299. value = bitValue ? (value | val) : (value & ~val);
  300. return value;
  301. }
  302. /// <summary>
  303. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  304. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  305. /// </summary>
  306. /// <param name="value"></param>
  307. /// <returns></returns>
  308. public static IEnumerable<bool> GetBitList(this uint value)
  309. {
  310. var list = new List<bool>(32);
  311. for (var i = 0; i <= 31; i++)
  312. {
  313. uint val = 1u << i;
  314. list.Add((value & val) == val);
  315. }
  316. return list;
  317. }
  318. /// <summary>
  319. ///
  320. /// </summary>
  321. /// <param name="value"></param>
  322. /// <param name="index"></param>
  323. /// <returns></returns>
  324. public static bool Bit(this uint value, int index) => GetBitValue(value, index);
  325. /// <summary>
  326. ///
  327. /// </summary>
  328. /// <param name="value"></param>
  329. /// <returns></returns>
  330. public static bool[] Bits(this uint value)
  331. {
  332. var arr = new bool[32];
  333. for (var i = 0; i <= 31; i++)
  334. {
  335. uint x = 1u << i;
  336. arr[i] = ((value & x) == x);
  337. }
  338. return arr;
  339. }
  340. #endregion
  341. #region Long extension
  342. /// <summary>
  343. /// 返回Int数据中某一位是否为1
  344. /// </summary>
  345. /// <param name="value"></param>
  346. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  347. /// <returns>true表示该位为1,false表示该位为0</returns>
  348. public static bool GetBitValue(this long value, int index)
  349. {
  350. Trace.Assert(index >= 0 && index <= 63, $"{nameof(index)} is Out Of Range(0..63).");//索引出错
  351. long val = 1 << index;
  352. return (value & val) == val;
  353. }
  354. /// <summary>
  355. /// 设定Int数据中某一位的值
  356. /// </summary>
  357. /// <param name="value">位设定前的值</param>
  358. /// <param name="index">32位数据的从右向左的偏移位索引(0~31)</param>
  359. /// <param name="bitValue">true设该位为1,false设为0</param>
  360. /// <returns>返回位设定后的值</returns>
  361. public static long SetBitValue(ref this long value, int index, bool bitValue)
  362. {
  363. Trace.Assert(index >= 0 && index <= 63, $"{nameof(index)} is Out Of Range(0..63).");//索引出错
  364. long val = 1 << index;
  365. value = bitValue ? (value | val) : (value & ~val);
  366. return value;
  367. }
  368. /// <summary>
  369. /// 根据Int类型的值,返回用1或0(对应True或Flase)填充的数组
  370. /// <remarks>从右侧开始向左索引(0~31)</remarks>
  371. /// </summary>
  372. /// <param name="value"></param>
  373. /// <returns></returns>
  374. public static IEnumerable<bool> GetBitList(this long value)
  375. {
  376. var list = new List<bool>(64);
  377. for (var i = 0; i <= 63; i++)
  378. {
  379. long val = 1 << i;
  380. list.Add((value & val) == val);
  381. }
  382. return list;
  383. }
  384. /// <summary>
  385. ///
  386. /// </summary>
  387. /// <param name="value"></param>
  388. /// <param name="index"></param>
  389. /// <returns></returns>
  390. public static bool Bit(this long value, int index) => GetBitValue(value, index);
  391. /// <summary>
  392. ///
  393. /// </summary>
  394. /// <param name="value"></param>
  395. /// <returns></returns>
  396. public static bool[] Bits(this long value)
  397. {
  398. var arr = new bool[64];
  399. for (var i = 0; i <= 31; i++)
  400. {
  401. long x = 1 << i;
  402. arr[i] = ((value & x) == x);
  403. }
  404. return arr;
  405. }
  406. #endregion
  407. }
  408. }