Code:
/ 4.0 / 4.0 / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / Core / System / Collections / Generic / BitHelper.cs / 1305376 / BitHelper.cs
using System; using System.Collections; using System.Text; namespace System.Collections.Generic { ////// ABOUT: /// Helps with operations that rely on bit marking to indicate whether an item in the /// collection should be added, removed, visited already, etc. /// /// BitHelper doesn't allocate the array; you must pass in an array or ints allocated on the /// stack or heap. ToIntArrayLength() tells you the int array size you must allocate. /// /// USAGE: /// Suppose you need to represent a bit array of length (i.e. logical bit array length) /// BIT_ARRAY_LENGTH. Then this is the suggested way to instantiate BitHelper: /// **************************************************************************** /// int intArrayLength = BitHelper.ToIntArrayLength(BIT_ARRAY_LENGTH); /// BitHelper bitHelper; /// if (intArrayLength less than stack alloc threshold) /// int* m_arrayPtr = stackalloc int[intArrayLength]; /// bitHelper = new BitHelper(m_arrayPtr, intArrayLength); /// else /// int[] m_arrayPtr = new int[intArrayLength]; /// bitHelper = new BitHelper(m_arrayPtr, intArrayLength); /// *************************************************************************** /// /// IMPORTANT: /// The second ctor args, length, should be specified as the length of the int array, not /// the logical bit array. Because length is used for bounds checking into the int array, /// it's especially important to get this correct for the stackalloc version. See the code /// samples above; this is the value gotten from ToIntArrayLength(). /// /// The length ctor argument is the only exception; for other methods -- MarkBit and /// IsMarked -- pass in values as indices into the logical bit array, and it will be mapped /// to the position within the array of ints. /// /// unsafe internal class BitHelper { // should not be serialized private const byte MarkedBitFlag = 1; private const byte IntSize = 32; // m_length of underlying int array (not logical bit array) private int m_length; // ptr to stack alloc'd array of ints private int* m_arrayPtr; // array of ints private int[] m_array; // whether to operate on stack alloc'd or heap alloc'd array private bool useStackAlloc; /// /// Instantiates a BitHelper with a heap alloc'd array of ints /// /// int array to hold bits /// length of int array //// [System.Security.SecurityCritical] internal BitHelper(int* bitArrayPtr, int length) { this.m_arrayPtr = bitArrayPtr; this.m_length = length; useStackAlloc = true; } ///// // /// Instantiates a BitHelper with a heap alloc'd array of ints /// /// int array to hold bits /// length of int array internal BitHelper(int[] bitArray, int length) { this.m_array = bitArray; this.m_length = length; } ////// Mark bit at specified position /// /// //// [System.Security.SecurityCritical] internal unsafe void MarkBit(int bitPosition) { if (useStackAlloc) { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { m_arrayPtr[bitArrayIndex] |= (MarkedBitFlag << (bitPosition % IntSize)); } } else { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { m_array[bitArrayIndex] |= (MarkedBitFlag << (bitPosition % IntSize)); } } } ///// /// Is bit at specified position marked? /// /// ///// // [System.Security.SecurityCritical] internal unsafe bool IsMarked(int bitPosition) { if (useStackAlloc) { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { return ((m_arrayPtr[bitArrayIndex] & (MarkedBitFlag << (bitPosition % IntSize))) != 0); } return false; } else { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { return ((m_array[bitArrayIndex] & (MarkedBitFlag << (bitPosition % IntSize))) != 0); } return false; } } ///// /// How many ints must be allocated to represent n bits. Returns (n+31)/32, but /// avoids overflow /// /// ///internal static int ToIntArrayLength(int n) { return n > 0 ? ((n - 1) / IntSize + 1) : 0; } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved. using System; using System.Collections; using System.Text; namespace System.Collections.Generic { /// /// ABOUT: /// Helps with operations that rely on bit marking to indicate whether an item in the /// collection should be added, removed, visited already, etc. /// /// BitHelper doesn't allocate the array; you must pass in an array or ints allocated on the /// stack or heap. ToIntArrayLength() tells you the int array size you must allocate. /// /// USAGE: /// Suppose you need to represent a bit array of length (i.e. logical bit array length) /// BIT_ARRAY_LENGTH. Then this is the suggested way to instantiate BitHelper: /// **************************************************************************** /// int intArrayLength = BitHelper.ToIntArrayLength(BIT_ARRAY_LENGTH); /// BitHelper bitHelper; /// if (intArrayLength less than stack alloc threshold) /// int* m_arrayPtr = stackalloc int[intArrayLength]; /// bitHelper = new BitHelper(m_arrayPtr, intArrayLength); /// else /// int[] m_arrayPtr = new int[intArrayLength]; /// bitHelper = new BitHelper(m_arrayPtr, intArrayLength); /// *************************************************************************** /// /// IMPORTANT: /// The second ctor args, length, should be specified as the length of the int array, not /// the logical bit array. Because length is used for bounds checking into the int array, /// it's especially important to get this correct for the stackalloc version. See the code /// samples above; this is the value gotten from ToIntArrayLength(). /// /// The length ctor argument is the only exception; for other methods -- MarkBit and /// IsMarked -- pass in values as indices into the logical bit array, and it will be mapped /// to the position within the array of ints. /// /// unsafe internal class BitHelper { // should not be serialized private const byte MarkedBitFlag = 1; private const byte IntSize = 32; // m_length of underlying int array (not logical bit array) private int m_length; // ptr to stack alloc'd array of ints private int* m_arrayPtr; // array of ints private int[] m_array; // whether to operate on stack alloc'd or heap alloc'd array private bool useStackAlloc; /// /// Instantiates a BitHelper with a heap alloc'd array of ints /// /// int array to hold bits /// length of int array //// [System.Security.SecurityCritical] internal BitHelper(int* bitArrayPtr, int length) { this.m_arrayPtr = bitArrayPtr; this.m_length = length; useStackAlloc = true; } ///// // /// Instantiates a BitHelper with a heap alloc'd array of ints /// /// int array to hold bits /// length of int array internal BitHelper(int[] bitArray, int length) { this.m_array = bitArray; this.m_length = length; } ////// Mark bit at specified position /// /// //// [System.Security.SecurityCritical] internal unsafe void MarkBit(int bitPosition) { if (useStackAlloc) { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { m_arrayPtr[bitArrayIndex] |= (MarkedBitFlag << (bitPosition % IntSize)); } } else { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { m_array[bitArrayIndex] |= (MarkedBitFlag << (bitPosition % IntSize)); } } } ///// /// Is bit at specified position marked? /// /// ///// // [System.Security.SecurityCritical] internal unsafe bool IsMarked(int bitPosition) { if (useStackAlloc) { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { return ((m_arrayPtr[bitArrayIndex] & (MarkedBitFlag << (bitPosition % IntSize))) != 0); } return false; } else { int bitArrayIndex = bitPosition / IntSize; if (bitArrayIndex < m_length && bitArrayIndex >= 0) { return ((m_array[bitArrayIndex] & (MarkedBitFlag << (bitPosition % IntSize))) != 0); } return false; } } ///// /// How many ints must be allocated to represent n bits. Returns (n+31)/32, but /// avoids overflow /// /// ///internal static int ToIntArrayLength(int n) { return n > 0 ? ((n - 1) / IntSize + 1) : 0; } } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007. // Copyright (c) Microsoft Corporation. All rights reserved.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- TransformerInfo.cs
- RouteValueExpressionBuilder.cs
- Pkcs7Recipient.cs
- ReadOnlyTernaryTree.cs
- OperatorExpressions.cs
- OdbcError.cs
- ToolStripProgressBar.cs
- CharConverter.cs
- RtfControlWordInfo.cs
- CodeRemoveEventStatement.cs
- ResetableIterator.cs
- XmlAttributeCache.cs
- UnsafeNativeMethodsCLR.cs
- InfoCardRSACryptoProvider.cs
- Animatable.cs
- CssTextWriter.cs
- AbstractSvcMapFileLoader.cs
- Vector3DConverter.cs
- NumberSubstitution.cs
- NonVisualControlAttribute.cs
- PrtCap_Builder.cs
- ObjRef.cs
- OdbcConnectionString.cs
- GroupStyle.cs
- DataContractFormatAttribute.cs
- ValueProviderWrapper.cs
- StringFunctions.cs
- ConfigViewGenerator.cs
- SerialReceived.cs
- ObjectFactoryCodeDomTreeGenerator.cs
- SerialStream.cs
- ThaiBuddhistCalendar.cs
- listitem.cs
- TransformPatternIdentifiers.cs
- Html32TextWriter.cs
- BufferedWebEventProvider.cs
- CompatibleComparer.cs
- ListItemCollection.cs
- StringValidator.cs
- ZipIOZip64EndOfCentralDirectoryLocatorBlock.cs
- HttpModuleActionCollection.cs
- TreeIterators.cs
- UserControlAutomationPeer.cs
- WebBrowsableAttribute.cs
- AssociationTypeEmitter.cs
- xmlsaver.cs
- XpsLiterals.cs
- HtmlAnchor.cs
- RuntimeHelpers.cs
- PropertyGrid.cs
- ChangeProcessor.cs
- CodeDirectionExpression.cs
- WindowsUserNameSecurityTokenAuthenticator.cs
- ServiceModelConfiguration.cs
- DragEventArgs.cs
- QueryableFilterRepeater.cs
- InvalidComObjectException.cs
- TypeLibConverter.cs
- SQLConvert.cs
- FixedTextPointer.cs
- EventLog.cs
- ConstraintManager.cs
- DeflateEmulationStream.cs
- RelationshipFixer.cs
- WeakRefEnumerator.cs
- Command.cs
- ProcessModelSection.cs
- hresults.cs
- IPeerNeighbor.cs
- ValidationErrorCollection.cs
- MethodBuilder.cs
- EventDescriptorCollection.cs
- UpdatableWrapper.cs
- WindowsStreamSecurityUpgradeProvider.cs
- RequestTimeoutManager.cs
- Matrix3DValueSerializer.cs
- BitmapFrameEncode.cs
- CounterNameConverter.cs
- DateTimeFormatInfoScanner.cs
- WebPartConnectionsEventArgs.cs
- ImageConverter.cs
- DateTimeConverter.cs
- DecoderExceptionFallback.cs
- EditCommandColumn.cs
- DocumentGridContextMenu.cs
- HandlerFactoryCache.cs
- PartialArray.cs
- _HeaderInfo.cs
- EntitySqlQueryBuilder.cs
- XMLSyntaxException.cs
- ToolStripSeparator.cs
- Vector3DAnimation.cs
- ApplicationActivator.cs
- ProvidePropertyAttribute.cs
- TreeWalkHelper.cs
- SqlFactory.cs
- BaseCAMarshaler.cs
- AddingNewEventArgs.cs
- NotifyIcon.cs
- XmlChildNodes.cs