Interlocked.Add Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds two integers and replaces the first integer with the sum, as an atomic operation.
Overloads
| Add(Int32, Int32) |
Adds two 32-bit integers and replaces the first integer with the sum, as an atomic operation. |
| Add(Int64, Int64) |
Adds two 64-bit integers and replaces the first integer with the sum, as an atomic operation. |
| Add(UInt32, UInt32) |
Adds two 32-bit unsigned integers and replaces the first integer with the sum, as an atomic operation. |
| Add(UInt64, UInt64) |
Adds two 64-bit unsigned integers and replaces the first integer with the sum, as an atomic operation. |
Add(Int32, Int32)
- Source:
- Interlocked.CoreCLR.cs
- Source:
- Interlocked.CoreCLR.cs
- Source:
- Interlocked.CoreCLR.cs
Adds two 32-bit integers and replaces the first integer with the sum, as an atomic operation.
public:
static int Add(int % location1, int value);public static int Add (ref int location1, int value);static member Add : int * int -> intPublic Shared Function Add (ByRef location1 As Integer, value As Integer) As IntegerParameters
- location1
- Int32
A variable containing the first value to be added. The sum of the two values is stored in location1.
- value
- Int32
The value to be added to the integer at location1.
Returns
The new value that was stored at location1 by this operation.
Exceptions
The address of location1 is a null pointer.
Remarks
This method handles an overflow condition by wrapping: if the value at location1 is Int32.MaxValue and value is 1, the result is Int32.MinValue; if value is 2, the result is (Int32.MinValue + 1); and so on. No exception is thrown.
See also
Applies to
Add(Int64, Int64)
- Source:
- Interlocked.CoreCLR.cs
- Source:
- Interlocked.CoreCLR.cs
- Source:
- Interlocked.CoreCLR.cs
Adds two 64-bit integers and replaces the first integer with the sum, as an atomic operation.
public:
static long Add(long % location1, long value);public static long Add (ref long location1, long value);static member Add : int64 * int64 -> int64Public Shared Function Add (ByRef location1 As Long, value As Long) As LongParameters
- location1
- Int64
A variable containing the first value to be added. The sum of the two values is stored in location1.
- value
- Int64
The value to be added to the integer at location1.
Returns
The new value that was stored at location1 by this operation.
Exceptions
The address of location1 is a null pointer.
Remarks
This method handles an overflow condition by wrapping: if the value at location1 is Int64.MaxValue and value is 1, the result is Int64.MinValue; if value is 2, the result is (Int64.MinValue + 1); and so on. No exception is thrown.
See also
Applies to
Add(UInt32, UInt32)
- Source:
- Interlocked.cs
- Source:
- Interlocked.cs
- Source:
- Interlocked.cs
Important
This API is not CLS-compliant.
Adds two 32-bit unsigned integers and replaces the first integer with the sum, as an atomic operation.
public:
static System::UInt32 Add(System::UInt32 % location1, System::UInt32 value);[System.CLSCompliant(false)]
public static uint Add (ref uint location1, uint value);[<System.CLSCompliant(false)>]
static member Add : uint32 * uint32 -> uint32Public Shared Function Add (ByRef location1 As UInteger, value As UInteger) As UIntegerParameters
- location1
- UInt32
A variable containing the first value to be added. The sum of the two values is stored in location1.
- value
- UInt32
The value to be added to the integer at location1.
Returns
The new value that was stored at location1 by this operation.
- Attributes
Exceptions
The address of location1 is a null pointer.
Applies to
Add(UInt64, UInt64)
- Source:
- Interlocked.cs
- Source:
- Interlocked.cs
- Source:
- Interlocked.cs
Important
This API is not CLS-compliant.
Adds two 64-bit unsigned integers and replaces the first integer with the sum, as an atomic operation.
public:
static System::UInt64 Add(System::UInt64 % location1, System::UInt64 value);[System.CLSCompliant(false)]
public static ulong Add (ref ulong location1, ulong value);[<System.CLSCompliant(false)>]
static member Add : uint64 * uint64 -> uint64Public Shared Function Add (ByRef location1 As ULong, value As ULong) As ULongParameters
- location1
- UInt64
A variable containing the first value to be added. The sum of the two values is stored in location1.
- value
- UInt64
The value to be added to the integer at location1.
Returns
The new value that was stored at location1 by this operation.
- Attributes
Exceptions
The address of location1 is a null pointer.
Applies to
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for