_interlockedbittestandset, _interlockedbittestandset64
TOC
Collapse the table of content
Expand the table of content

_interlockedbittestandset, _interlockedbittestandset64

Updated: March 2011

Microsoft Specific

Generate the lock bts instruction, which examines bit b of the address a and returns its current value before setting it to 1.

unsigned char _interlockedbittestandset(
   long *a,
   long b
);
unsigned char _interlockedbittestandset64(
   __int64 *a,
   __int64 b
);

[in] a

A pointer to the memory to examine.

[in] b

The bit position to test.

The bit at the position specified before it is set.

Intrinsic

Architecture

_interlockedbittestandset

x86, x64

_interlockedbittestandset64

x64

Header file <intrin.h>

As a result of the lock bts instruction, the bit is set to 1. The operation is atomic.

These functions behave as read-write memory barriers. For more information, see _ReadWriteBarrier.

This routine is only available as an intrinsic.

Date

History

Reason

March 2011

Clarified the return value.

Information enhancement.

Community Additions

ADD
Show:
© 2016 Microsoft