xref: /petsc/include/petscbt.h (revision 94bacf5d63357eebdb6cb60590cd3fc642c33a09)
127260eb9SSatish Balay 
2f621e05eSBarry Smith #if !defined(__PETSCBT_H)
3f621e05eSBarry Smith #define __PETSCBT_H
4f621e05eSBarry Smith PETSC_EXTERN_CXX_BEGIN
519fee000SSatish Balay 
6f621e05eSBarry Smith /*S
7f621e05eSBarry Smith      PetscBT - PETSc bitarrays
8f621e05eSBarry Smith 
9f621e05eSBarry Smith      Level: advanced
1019fee000SSatish Balay 
11*94bacf5dSBarry Smith      PetscBTCreate(m,&bt)       - creates a bit array with enough room to hold m values
12*94bacf5dSBarry Smith      PetscBTDestroy(&bt)        - destroys the bit array
136831982aSBarry Smith      PetscBTMemzero(m,bt)       - zeros the entire bit array (sets all values to false)
146831982aSBarry Smith      PetscBTSet(bt,index)       - sets a particular entry as true
156831982aSBarry Smith      PetscBTClear(bt,index)     - sets a particular entry as false
16f1af5d2fSBarry Smith      PetscBTLookup(bt,index)    - returns the value
17f1af5d2fSBarry Smith      PetscBTLookupSet(bt,index) - returns the value and then sets it true
186831982aSBarry Smith      PetscBTLength(m)           - returns number of bytes in array with m bits
196831982aSBarry Smith      PetscBTView(m,bt,viewer)   - prints all the entries in a bit array
20eec0b4cfSBarry Smith 
216831982aSBarry Smith     We do not currently check error flags on PetscBTSet(), PetscBTClear(), PetscBTLookup(),
226831982aSBarry Smith     PetcBTLookupSet(), PetscBTLength() cause error checking would cost hundreds more cycles then
236831982aSBarry Smith     the operation.
246831982aSBarry Smith 
25b9617806SBarry Smith S*/
26521d7252SBarry Smith typedef char* PetscBT;
27ca71c51bSBarry Smith 
287087cfbeSBarry Smith extern  char      _BT_mask;
297087cfbeSBarry Smith extern  char      _BT_c;
307087cfbeSBarry Smith extern  PetscInt  _BT_idx;
31ca71c51bSBarry Smith 
3253b8de81SBarry Smith PETSC_STATIC_INLINE PetscInt  PetscBTLength(PetscInt m)
3353b8de81SBarry Smith {
3453b8de81SBarry Smith   return  ((m)/PETSC_BITS_PER_BYTE+1);
3553b8de81SBarry Smith }
3682502324SSatish Balay 
3753b8de81SBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTMemzero(PetscInt m,PetscBT array)
3853b8de81SBarry Smith {
3953b8de81SBarry Smith   return PetscMemzero(array,sizeof(char)*((m)/PETSC_BITS_PER_BYTE+1));
4053b8de81SBarry Smith }
413b71518fSBarry Smith 
42*94bacf5dSBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTDestroy(PetscBT *array)
4353b8de81SBarry Smith {
44*94bacf5dSBarry Smith   return PetscFree(*array);
4553b8de81SBarry Smith }
46ca71c51bSBarry Smith 
4753b8de81SBarry Smith PETSC_STATIC_INLINE PetscInt PetscBTLookup(PetscBT array,PetscInt index)
4853b8de81SBarry Smith {
4953b8de81SBarry Smith return  (_BT_idx        = (index)/PETSC_BITS_PER_BYTE,
5053b8de81SBarry Smith    _BT_c          = array[_BT_idx],
5153b8de81SBarry Smith    _BT_mask       = (char)1 << ((index)%PETSC_BITS_PER_BYTE),
5253b8de81SBarry Smith    (_BT_c & _BT_mask) != 0);
5353b8de81SBarry Smith }
5419fee000SSatish Balay 
5553b8de81SBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTView(PetscInt m,const PetscBT bt,PetscViewer viewer)
5653b8de81SBarry Smith {
57*94bacf5dSBarry Smith   PetscInt       i;
58*94bacf5dSBarry Smith   PetscErrorCode ierr;
5919fee000SSatish Balay 
60*94bacf5dSBarry Smith   if (!viewer) viewer = PETSC_VIEWER_STDOUT_SELF;
61*94bacf5dSBarry Smith   ierr = PetscViewerASCIISynchronizedAllow(viewer,PETSC_TRUE);CHKERRQ(ierr);
62*94bacf5dSBarry Smith   for (i=0; i<m; i++) {
63*94bacf5dSBarry Smith     ierr = PetscViewerASCIISynchronizedPrintf(viewer,"%D %d\n",i,PetscBTLookup(bt,i));CHKERRQ(ierr);
64*94bacf5dSBarry Smith   }  ierr = PetscViewerFlush(viewer);CHKERRQ(ierr);
65*94bacf5dSBarry Smith   ierr = PetscViewerASCIISynchronizedAllow(viewer,PETSC_FALSE);CHKERRQ(ierr);
6653b8de81SBarry Smith   return 0;
6753b8de81SBarry Smith }
68ca71c51bSBarry Smith 
6953b8de81SBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTCreate(PetscInt m,PetscBT *array)
7053b8de81SBarry Smith {
7153b8de81SBarry Smith   return (PetscMalloc(((m)/PETSC_BITS_PER_BYTE+1)*sizeof(char),array) || PetscBTMemzero(m,*array));
7253b8de81SBarry Smith }
7353b8de81SBarry Smith 
7453b8de81SBarry Smith PETSC_STATIC_INLINE char PetscBTLookupSet(PetscBT array,PetscInt index)
7553b8de81SBarry Smith {
7653b8de81SBarry Smith   return (_BT_idx        = (index)/PETSC_BITS_PER_BYTE,
7753b8de81SBarry Smith    _BT_c          = array[_BT_idx],
7853b8de81SBarry Smith    _BT_mask       = (char)1 << ((index)%PETSC_BITS_PER_BYTE),
7953b8de81SBarry Smith    array[_BT_idx] = _BT_c | _BT_mask,
8053b8de81SBarry Smith           _BT_c & _BT_mask);
8153b8de81SBarry Smith }
8253b8de81SBarry Smith 
8353b8de81SBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTSet(PetscBT array,PetscInt index)
8453b8de81SBarry Smith {
8553b8de81SBarry Smith return  (_BT_idx        = (index)/PETSC_BITS_PER_BYTE,
8653b8de81SBarry Smith    _BT_c          = array[_BT_idx],
8753b8de81SBarry Smith    _BT_mask       = (char)1 << ((index)%PETSC_BITS_PER_BYTE),
8853b8de81SBarry Smith          array[_BT_idx] = _BT_c | _BT_mask,0);
8953b8de81SBarry Smith }
9053b8de81SBarry Smith 
9153b8de81SBarry Smith PETSC_STATIC_INLINE PetscErrorCode PetscBTClear(PetscBT array,PetscInt index)
9253b8de81SBarry Smith {
9353b8de81SBarry Smith  return (_BT_idx        = (index)/PETSC_BITS_PER_BYTE,
9453b8de81SBarry Smith    _BT_c          = array[_BT_idx],
9553b8de81SBarry Smith    _BT_mask       = (char)1 << ((index)%PETSC_BITS_PER_BYTE),
9653b8de81SBarry Smith          array[_BT_idx] = _BT_c & (~_BT_mask),0);
9753b8de81SBarry Smith }
9853b8de81SBarry Smith 
99ca71c51bSBarry Smith 
100e9fa29b7SSatish Balay PETSC_EXTERN_CXX_END
101ca71c51bSBarry Smith #endif
102