ROSE 0.11.145.147
SgAsmCliHeader.h
1
2#ifndef ROSE_SgAsmCliHeader_H
3#define ROSE_SgAsmCliHeader_H
4#include <RoseFirst.h>
5#include <Cxx_GrammarDeclarations.h>
6#include <SgAsmGenericSection.h>
7
8
9
10/* #line 1 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
11
12// WARNING -- GENERATED CODE -- DO NOT MODIFY THIS CODE -- WARNING!
13// This code is automatically generated for each
14// terminal and non-terminal within the defined
15// grammar. There is a simple way to change the
16// code to fix bugs etc. See the ROSE README file
17// for directions.
18
19// tps: (02/22/2010): Adding DLL export requirements
20#include "rosedll.h"
21
22// predeclarations for SgAsmCliHeader
23
24/* #line 25 "../../../src/frontend/SageIII//SgAsmCliHeader.h" */
25/* #line 30606 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
26
27#ifdef ROSE_SgAsmCliHeader_IMPL
28#include <SgAsmCilMetadataRoot.h>
29#endif
30
31
32/* #line 13 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $PREDECLARATIONS" */
33
34/* #line 14 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
35
36#if !defined(DOCUMENTATION)
37// Class Definition for SgAsmCliHeader
38class ROSE_DLL_API SgAsmCliHeader : public SgAsmGenericSection
39 {
40 public:
41
42
43/* #line 44 "../../../src/frontend/SageIII//SgAsmCliHeader.h" */
44
45 virtual SgNode* copy ( SgCopyHelp& help) const override;
46// Start of memberFunctionString
47/* #line 30698 "/workspace/src/ROSETTA/src/binaryInstruction.C" */
48
49
50 //----------------------- Boost serialization for SgAsmCliHeader -----------------------
51#ifdef ROSE_HAVE_BOOST_SERIALIZATION_LIB
52private:
53 friend class boost::serialization::access;
54
55 template<class S>
56 void serialize(S &s, const unsigned /*version*/) {
57 debugSerializationBegin("SgAsmCliHeader");
58 s & BOOST_SERIALIZATION_BASE_OBJECT_NVP(SgAsmGenericSection);
59 s & BOOST_SERIALIZATION_NVP(p_cb);
60 s & BOOST_SERIALIZATION_NVP(p_majorRuntimeVersion);
61 s & BOOST_SERIALIZATION_NVP(p_minorRuntimeVersion);
62 s & BOOST_SERIALIZATION_NVP(p_metaData);
63 s & BOOST_SERIALIZATION_NVP(p_flags);
64 s & BOOST_SERIALIZATION_NVP(p_entryPointToken);
65 s & BOOST_SERIALIZATION_NVP(p_resources);
66 s & BOOST_SERIALIZATION_NVP(p_strongNameSignature);
67 s & BOOST_SERIALIZATION_NVP(p_codeManagerTable);
68 s & BOOST_SERIALIZATION_NVP(p_vTableFixups);
69 s & BOOST_SERIALIZATION_NVP(p_exportAddressTableJumps);
70 s & BOOST_SERIALIZATION_NVP(p_managedNativeHeader);
71 debugSerializationEnd("SgAsmCliHeader");
72 }
73#endif // ROSE_HAVE_BOOST_SERIALIZATION_LIB
74public:
75public:
81 uint32_t const& get_cb() const;
82 void set_cb(uint32_t const&);
85public:
91 uint16_t const& get_majorRuntimeVersion() const;
92 void set_majorRuntimeVersion(uint16_t const&);
95public:
101 uint16_t const& get_minorRuntimeVersion() const;
102 void set_minorRuntimeVersion(uint16_t const&);
105public:
111 uint64_t const& get_metaData() const;
112 void set_metaData(uint64_t const&);
115public:
121 uint32_t const& get_flags() const;
122 void set_flags(uint32_t const&);
125public:
131 uint32_t const& get_entryPointToken() const;
132 void set_entryPointToken(uint32_t const&);
135public:
141 uint64_t const& get_resources() const;
142 void set_resources(uint64_t const&);
145public:
151 uint64_t const& get_strongNameSignature() const;
152 void set_strongNameSignature(uint64_t const&);
155public:
161 uint64_t const& get_codeManagerTable() const;
162 void set_codeManagerTable(uint64_t const&);
165public:
171 uint64_t const& get_vTableFixups() const;
172 void set_vTableFixups(uint64_t const&);
175public:
181 uint64_t const& get_exportAddressTableJumps() const;
182 void set_exportAddressTableJumps(uint64_t const&);
185public:
191 uint64_t const& get_managedNativeHeader() const;
192 void set_managedNativeHeader(uint64_t const&);
194 // FIXME[Robb Matzke 2023-03-20]: is the lack of serialization a bug?
195public:
199 SgAsmCilMetadataRoot* const& get_metadataRoot() const;
200 void set_metadataRoot(SgAsmCilMetadataRoot* const&);
202 public:
207
209 virtual SgAsmCliHeader* parse() override;
210
212 virtual void dump(FILE*, const char *prefix, ssize_t idx) const override;
213public:
215 virtual ~SgAsmCliHeader();
216
217public:
220
221protected:
229
230
231// End of memberFunctionString
232// Start of memberFunctionString
233/* #line 1 "/workspace/src/ROSETTA/Grammar/Common.code" */
234
235// *** COMMON CODE SECTION BEGINS HERE ***
236
237 public:
238
239 // DQ (3/25/3006): I put this back in because it had the logic for where the copy function required
240 // and not required which is required to match the other aspects of the copy mechanism code generation.
241 // Specifically it is a problem to declare the copy function everywhere because it is not implemented
242 // for the SgSymbol IR nodes. I'm not clear why it is not implemented for these IR nodes.
243 /* \brief Copies AST (whole subtree, depending on the SgCopyHelp class */
244 // virtual SgNode* copy ( const SgCopyHelp & help) const;
245
247 virtual std::string class_name() const override;
248
250 virtual VariantT variantT() const override; // MS: new variant used in tree traversal
251
253 // King84 (2010.08.16): Moved this to an enum to save space, since it's only used at compiler-time anyway.
254 // static const VariantT static_variant = V_SgAsmCliHeader;
255 enum { static_variant = V_SgAsmCliHeader };
256
257 /* the generated cast function */
259 ROSE_DLL_API friend SgAsmCliHeader* isSgAsmCliHeader( SgNode * s );
260
262 ROSE_DLL_API friend const SgAsmCliHeader* isSgAsmCliHeader( const SgNode * s );
263
264 // ******************************************
265 // * Memory Pool / New / Delete
266 // ******************************************
267
268 public:
270 static const unsigned pool_size; //
272 static std::vector<unsigned char *> pools; //
274 static SgAsmCliHeader * next_node; //
275
277 static unsigned long initializeStorageClassArray(SgAsmCliHeaderStorageClass *); //
278
280 static void clearMemoryPool(); //
281 static void deleteMemoryPool(); //
282
284 static void extendMemoryPoolForFileIO(); //
285
287 static SgAsmCliHeader * getPointerFromGlobalIndex(unsigned long); //
289 static SgAsmCliHeader * getPointerFromGlobalIndex(AstSpecificDataManagingClass *, unsigned long); //
290
292 static unsigned long getNumberOfValidNodesAndSetGlobalIndexInFreepointer(unsigned long); //
294 static void resetValidFreepointers(); //
296 static unsigned long getNumberOfLastValidPointer(); //
297
298
299#if defined(INLINE_FUNCTIONS)
301 inline void *operator new (size_t size);
302#else
304 void *operator new (size_t size);
305#endif
307 void operator delete (void* pointer, size_t size);
308
309 // DQ (4/5/2007): This is not the correct operator that we want, but appears to be required to compile ROSE with ROSE.
310 void operator delete (void* pointer)
311 {
312 // This is the generated delete operator...
313 SgAsmCliHeader::operator delete (pointer,sizeof(SgAsmCliHeader));
314 }
315
317 static size_t numberOfNodes();
318
320 static size_t memoryUsage();
321
322 // End of scope which started in IR nodes specific code
323 /* */
324
325 /* name Internal Functions
326 \brief Internal functions ... incomplete-documentation
327
328 These functions have been made public as part of the design, but they are suggested for internal use
329 or by particularly knowledgeable users for specialized tools or applications.
330
331 \internal We could not make these private because they are required by user for special purposes. And
332 it would be unwieldy to have many of the internal classes in ROSE be explicitly defined as friends.
333
334 */
335
336 // MS: 02/12/02 container of pointers to AST successor nodes used in the traversal
337 // overridden in every class by *generated* implementation
339 virtual std::vector<SgNode*> get_traversalSuccessorContainer() override;
340 // MS: 06/28/02 container of names of variables or container indices
341 // used used in the traversal to access AST successor nodes
342 // overridden in every class by *generated* implementation
345 virtual std::vector<std::string> get_traversalSuccessorNamesContainer() override;
346
347 // GB (09/25/2007): Functions for index-based access to traversal successors; these are hopefully a lot faster
348 // than all the vector copies. The implementation for these functions is generated for each class.
350 virtual size_t get_numberOfTraversalSuccessors() override;
352 virtual SgNode *get_traversalSuccessorByIndex(size_t idx) override;
354 virtual size_t get_childIndex(SgNode *child) override;
355
356#ifndef ROSE_USE_INTERNAL_FRONTEND_DEVELOPMENT
357 // MS: 08/16/2002 method for generating RTI information
359 virtual RTIReturnType roseRTI() override;
360#endif
361 /* */
362
363
364
365 /* name Deprecated Functions
366 \brief Deprecated functions ... incomplete-documentation
367
368 These functions have been deprecated from use.
369 */
370 /* */
371
373 virtual const char* sage_class_name() const override ROSE_DEPRECATED_FUNCTION;
374
375 // JJW (10/16/2008): Changed to a single function in Node.code, and put
376 // getVariant() in #if 0 block to prevent confusing Doxygen
377#if 0
379 virtual int variant() const ROSE_DEPRECATED_FUNCTION;
381 // virtual int getVariant() const ROSE_DEPRECATED_FUNCTION;
382#endif
383 /* */
384
385
386
387
388 public:
389 /* name Traversal Support Functions
390 \brief Traversal support functions ... incomplete-documentation
391
392 These functions have been made public as part of the design, but they are suggested for internal use
393 or by particularly knowledgable users for specialized tools or applications.
394 */
395 /* */
396
397 // DQ (11/26/2005): Support for visitor pattern mechanims
398 // (inferior to ROSE traversal mechanism, experimental).
402
403 /* DXN (08/09/2010): support for the classic visitor pattern done in GoF */
405 virtual void accept (ROSE_VisitorPattern & visitor) override;
406
407 // DQ (12/26/2005): Support for traversal based on the memory pool
410 static void traverseMemoryPoolNodes(ROSE_VisitTraversal & visit);
411
415
416 // DQ (2/9/2006): Added to support traversal over single representative of each IR node
417 // This traversal helps support internal tools that call static member functions.
418 // note: this function operates on the memory pools.
421 static void visitRepresentativeNode (ROSE_VisitTraversal & visit);
422 /* */
423
424 public:
425 /* NodeId support functions */
427 static SgNode* getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx);
430 static SgAsmCliHeader* getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx);
433 static std::string getNodeIdString(SgAsmCliHeader* sgnode);
434 static std::string getNodeIdStringInternal(SgAsmCliHeader* sgnode);
435
436 public:
437 /* name Memory Allocation Functions
438 \brief Memory allocations functions ... incomplete-documentation
439
440 These functions have been made public as part of the design, but they are suggested for internal use
441 or by particularly knowledgable users for specialized tools or applications.
442 */
443 /* */
444
455 virtual bool isInMemoryPool() override;
456
467 virtual void checkDataMemberPointersIfInMemoryPool() override;
468
469 // DQ (4/30/2006): Modified to be a const function.
484 virtual std::vector<std::pair<SgNode*,std::string> > returnDataMemberPointers() const override;
485
496
508 virtual long getChildIndex( SgNode* childNode ) const override;
509
510 // DQ (9/2/2015): Since this function is generated by ROSETTA, we can't define the
511 // comment here (changed to be a C style comment and not be a doxygen comment).
512 /* \brief Constructor for use by AST File I/O Mechanism
513
514 This constructor permits the IR node to be rebuilt from the contiguously arranged data in memory
515 which obtained via fast binary file I/O from disk.
516 */
517 // SgAsmCliHeader( SgAsmCliHeaderStorageClass& source );
518
519
520
521
522
523 // JH (10/24/2005): methods added to support the ast file IO
524 private:
525
526 /* name AST Memory Allocation Support Functions
527 \brief Memory allocations support....
528
529 These functions handle the low leve support of the memory allocation scheme which permits IR nodes to be allocated
530 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
531 and support the AST File I/O Mechanism.
532 */
533 /* */
534
535 /* JH (10/24/2005): Two typedefs. The TestType notes the type every pointer is cast to before
536 we compare them. Since I had several problems with this, I decided to make a typdef to ensure
537 that I use the same type everywhere, if any changes are made. THe second one declares the type
538 (actually unsigned long) where teh pointer address gets converted to. On 64 bit platforms this
539 might got changed, but unfortunatly, the return types are still unsigned longs. There exists
540 a correspinding one in the AST_FILE_IO class!
541 */
542 // DQ (9/2/2015): This typedef is no longer used, we can't define the
543 // comment here (changed to be a C style comment and not be a doxygen comment).
544 /* \brief Typedef used for low level memory access.
545 */
546 // typedef unsigned char* TestType;
547
548 // DQ (9/2/2015): This typedef is no longer used, we can't define the
549 // comment here (changed to be a C style comment and not be a doxygen comment).
550 /* \brief Typedef used to hold memory addresses as values.
551 */
552 // typedef unsigned long AddressType;
553
554
555
556 // necessary, to have direct access to the p_freepointer and the private methods !
558 friend class AST_FILE_IO;
559
561 friend class SgAsmCliHeaderStorageClass;
562
564 friend class AstSpecificDataManagingClass;
565
567 friend class AstSpecificDataManagingClassStorageClass;
568 public:
570 SgAsmCliHeader( const SgAsmCliHeaderStorageClass& source );
571
572 // private: // JJW hack
573 /*
574 name AST Memory Allocation Support Variables
575 Memory allocations support variables
576
577 These variables handle the low level support of the memory allocation scheme which permits IR nodes to be allocated
578 in large contiguous blocks to reduce memory fragmentation, improve performance, support specialized access (AST traversals),
579 and support the AST File I/O Mechanism.
580 */
581 /* */
582
583 public:
584
585 // DQ (11/21/2009): Added function to add new Regular Expression attributes and return pointer
586 // to current node (so that it will work cleanly with build functions to specify patterns).
587 // virtual SgNode* addRegExpAttribute();
594
595#ifndef _MSC_VER
596// Rasmussen (04/17/2019): Support for ATerms has been deprecated as it is no longer needed
597// and likely never fully implemented nor tested. Files remain in the src tree but are no
598// longer built.
599#define BUILD_ATERM_SUPPORT 0
600 #if BUILD_ATERM_SUPPORT
601 #ifdef ROSE_USE_ROSE_ATERM_SUPPORT
602 // DQ (10/4/2014): Adding ATerm support to ROSE.
612 // Rasmussen (1/7/2019): Added override to kill warning messages of overridden virtual function
613 virtual ATerm generate_ATerm() override;
614
616 virtual void generate_ATerm_Annotation(ATerm & term) override;
617 #endif
618 #endif // BUILD_ATERM_SUPPORT
619#endif
620 // These can't be virtual functions since we don't yet know what IR node to build (until we have read the aterm).
621 // virtual generate_AST(ATerm & term);
622 // virtual void read_ATerm_Annotation(ATerm & term);
623
624// *** COMMON CODE SECTION ENDS HERE ***
625
626
627// End of memberFunctionString
628// Start of memberFunctionString
629/* #line 706 "/workspace/src/ROSETTA/Grammar/Node.code" */
630
631 // the generated cast function
632 // friend ROSE_DLL_API SgAsmCliHeader* isSgAsmCliHeader ( SgNode* s );
633
634 typedef SgAsmGenericSection base_node_type;
635
636
637// End of memberFunctionString
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652 protected:
653// Start of memberFunctionString
654uint32_t p_cb;
655
656// End of memberFunctionString
657// Start of memberFunctionString
658uint16_t p_majorRuntimeVersion;
659
660// End of memberFunctionString
661// Start of memberFunctionString
662uint16_t p_minorRuntimeVersion;
663
664// End of memberFunctionString
665// Start of memberFunctionString
666uint64_t p_metaData;
667
668// End of memberFunctionString
669// Start of memberFunctionString
670uint32_t p_flags;
671
672// End of memberFunctionString
673// Start of memberFunctionString
674uint32_t p_entryPointToken;
675
676// End of memberFunctionString
677// Start of memberFunctionString
678uint64_t p_resources;
679
680// End of memberFunctionString
681// Start of memberFunctionString
682uint64_t p_strongNameSignature;
683
684// End of memberFunctionString
685// Start of memberFunctionString
686uint64_t p_codeManagerTable;
687
688// End of memberFunctionString
689// Start of memberFunctionString
690uint64_t p_vTableFixups;
691
692// End of memberFunctionString
693// Start of memberFunctionString
694uint64_t p_exportAddressTableJumps;
695
696// End of memberFunctionString
697// Start of memberFunctionString
698uint64_t p_managedNativeHeader;
699
700// End of memberFunctionString
701// Start of memberFunctionString
702SgAsmCilMetadataRoot* p_metadataRoot;
703
704// End of memberFunctionString
705
707 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint32_t,&SgAsmCliHeader::p_cb>;
708 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint16_t,&SgAsmCliHeader::p_majorRuntimeVersion>;
709 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint16_t,&SgAsmCliHeader::p_minorRuntimeVersion>;
710 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_metaData>;
711 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint32_t,&SgAsmCliHeader::p_flags>;
712 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint32_t,&SgAsmCliHeader::p_entryPointToken>;
713 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_resources>;
714 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_strongNameSignature>;
715 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_codeManagerTable>;
716 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_vTableFixups>;
717 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_exportAddressTableJumps>;
718 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, uint64_t,&SgAsmCliHeader::p_managedNativeHeader>;
719 friend struct Rose::Traits::generated::describe_field_t<SgAsmCliHeader, SgAsmCilMetadataRoot*,&SgAsmCliHeader::p_metadataRoot>;
720
721/* #line 21 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
722
723
724 };
725#endif
726
727// postdeclarations for SgAsmCliHeader
728
729/* #line 730 "../../../src/frontend/SageIII//SgAsmCliHeader.h" */
730
731/* #line 27 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro after subst for $POSTDECLARATIONS" */
732
733/* #line 28 "/workspace/src/ROSETTA/Grammar/grammarClassDeclarationMacros.macro" */
734
735
736/* #line 737 "../../../src/frontend/SageIII//SgAsmCliHeader.h" */
737
738#endif // ROSE_SgAsmCliHeader_H
739
Class holding static data and functions supporting File I/O.
Definition AST_FILE_IO.h:19
Attribute containing a regex expression as a string.
CIL SgAsmCilMetadataRoot.
CIL Managed Code section.
Contiguous region of a file.
virtual SgAsmGenericSection * parse()
Parse contents of the section.
virtual void dump(FILE *, const char *prefix, ssize_t idx) const
Print some debugging info.
void initializeProperties()
Initialize all properties that have explicit initial values.
Windows PE file header.
Supporting class from copy mechanism within ROSE.
Definition sageCopy.h:26
This class represents the base class for all IR nodes within Sage III.
virtual size_t get_numberOfTraversalSuccessors()
return number of children in the traversal successor list
virtual RTIReturnType roseRTI()
return C++ Runtime-Time-Information
virtual std::vector< std::string > get_traversalSuccessorNamesContainer()
container of names of variables or container indices used used in the traversal to access AST success...
virtual void debugSerializationEnd(const char *className)
Called by generated serializers.
static std::string getNodeIdString(SgNode *sgnode)
compute the NodeId for a particular SgNode*.
virtual bool isInMemoryPool()
FOR INTERNAL USE This is used in internal tests to verify that all IR nodes are allocated from the he...
int variant() const
Older version function returns enum value "NODE".
virtual void processDataMemberReferenceToPointers(ReferenceToPointerHandler *)
FOR INTERNAL USE Processes pairs of references to SgNode* and strings for use in AST tools
virtual VariantT variantT() const
returns new style SageIII enum values
virtual long getChildIndex(SgNode *childNode) const
FOR INTERNAL USE Returns a unique index value for the childNode in the list of children at this IR no...
virtual size_t get_childIndex(SgNode *child)
index-based access to traversal successors by child node
virtual void debugSerializationBegin(const char *className)
Called by generated serializers.
virtual std::vector< SgNode * > get_traversalSuccessorContainer()
container of pointers to AST successor nodes used in the traversal overridden in every class by gener...
virtual std::string class_name() const
returns a string representing the class name
static void visitRepresentativeNode(ROSE_VisitTraversal &visit)
FOR INTERNAL USE Support for type-based traversal.
virtual void checkDataMemberPointersIfInMemoryPool()
FOR INTERNAL USE This is used in internal tests to verify that all IR nodes are allocated from the he...
static size_t numberOfNodes()
Returns the total number of IR nodes of this type.
virtual void accept(ROSE_VisitorPattern &visitor)
support for the classic visitor pattern done in GoF
virtual SgNode * get_traversalSuccessorByIndex(size_t idx)
index-based access to traversal successors by index number
static void traverseMemoryPoolVisitorPattern(ROSE_VisitorPattern &visitor)
FOR INTERNAL USE Support for visitor pattern.
void executeVisitorMemberFunction(ROSE_VisitorPattern &visitor)
FOR INTERNAL USE Support for visitor pattern.
static SgNode * getNodeByNodeId(VariantT variantT, size_t poolIdx, size_t itemIdx)
Find a node by its variant type, pool index, and item index.
static size_t memoryUsage()
Returns the size in bytes of the total memory allocated for all IR nodes of this type.
static void traverseMemoryPoolNodes(ROSE_VisitTraversal &visit)
FOR INTERNAL USE Support for visitor pattern over all IR nodes by type of IR node.
virtual const char * sage_class_name() const
generates string representing the class name: (e.g. for SgNode returns "SgNode").
virtual std::vector< std::pair< SgNode *, std::string > > returnDataMemberPointers() const
FOR INTERNAL USE Returns STL vector of pairs of SgNode* and strings for use in AST tools
static SgNode * getNodeByNodeIdInternal(size_t poolIdx, size_t itemIdx)
FOR INTERNAL USE Find an SgNode from its memory pool and location therin.
SgNode * addRegExpAttribute(std::string s, AstRegExAttribute *a)
Support for AST matching using regular expression.
void serialize(std::ostream &output, Graph &graph)
Serialize a graph into a stream of bytes.
void copy(const Word *src, const BitRange &srcRange, Word *dst, const BitRange &dstRange)
Copy some bits.