User Guide Cancel

BitMaskRead

 

Description

Performs a bitwise mask read operation.

Returns

An integer, created from length bits of_ number,_ beginning at start.

Category

Mathematical functions

Function syntax

BitMaskRead(number, start, length)

See also

BitMaskClearBitMaskSet

Parameters

Parameter

Description

number

32-bit signed integer to mask

start

Integer, in the range 0-31, inclusive; start bit for read

length

Integer, in the range 0-31, inclusive; length of mask

Usage

Bit functions operate on 32-bit signed integers, in the range -2147483648 - 2147483647.

Example

<h3>BitMaskRead Example</h3>
<p>Returns integer created from <em>length</em> bits of <em>number</em>, beginning
with <em>start</em>.</p>

<p>BitMaskRead(255, 4, 4): <cfoutput>#BitMaskRead(255, 4, 4)#</cfoutput></p>
<p>BitMaskRead(255, 0, 4): <cfoutput>#BitMaskRead(255, 0, 4)#</cfoutput></p>
<p>BitMaskRead(128, 0, 7): <cfoutput>#BitMaskRead(128, 0, 7)#</cfoutput></p>

Example

<cfscript>
number = 255 ;
start = 0 ;
length = 4;
writeOutput(bitmaskread(number, start, length)) ;
</cfscript>
<cfscript> number = 255 ; start = 0 ; length = 4; writeOutput(bitmaskread(number, start, length)) ; </cfscript>
<cfscript>
  number = 255 ;
  start = 0 ;
  length = 4; 
  writeOutput(bitmaskread(number, start, length)) ;
</cfscript>

Get help faster and easier

New user?