Interlocked.Decrement Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama.
Aşırı Yüklemeler
| Decrement(Int64) |
Belirtilen değişkenin azalmasını sağlar ve sonucu atomik bir işlem olarak depolar. |
| Decrement(Int32) |
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama. |
| Decrement(UInt32) |
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama. |
| Decrement(UInt64) |
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama. |
Decrement(Int64)
- Kaynak:
- Interlocked.CoreCLR.cs
- Kaynak:
- Interlocked.CoreCLR.cs
- Kaynak:
- Interlocked.CoreCLR.cs
Belirtilen değişkenin azalmasını sağlar ve sonucu atomik bir işlem olarak depolar.
public:
static long Decrement(long % location);public static long Decrement (ref long location);static member Decrement : int64 -> int64Public Shared Function Decrement (ByRef location As Long) As LongParametreler
- location
- Int64
Değeri azalan değişken.
Döndürülenler
Azaltma işlemi tamamlandıktan hemen sonra değişkeninin değeri.
Özel durumlar
adresi location bir null işaretçidir.
adresi location bir null işaretçidir.
Açıklamalar
Bu yöntem bir taşma koşulunu sarmalayarak işler: if location = Int64.MinValue, location - 1 = . Int64.MaxValue Özel durum oluşturulmaz.
Ayrıca bkz.
Şunlara uygulanır
Decrement(Int32)
- Kaynak:
- Interlocked.CoreCLR.cs
- Kaynak:
- Interlocked.CoreCLR.cs
- Kaynak:
- Interlocked.CoreCLR.cs
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama.
public:
static int Decrement(int % location);public static int Decrement (ref int location);static member Decrement : int -> intPublic Shared Function Decrement (ByRef location As Integer) As IntegerParametreler
- location
- Int32
Değeri azalan değişken.
Döndürülenler
Azaltma işlemi tamamlandıktan hemen sonra değişkeninin değeri.
Özel durumlar
adresi location bir null işaretçidir.
adresi location bir null işaretçidir.
Örnekler
Aşağıdaki örnek, orta nokta değeriyle 1.000 rastgele sayı oluşturmak için 0 ile 1.000 arasında değişen rastgele sayıların sayısını belirler. Orta nokta değerlerinin sayısını izlemek için, rastgele midpointCountsayı oluşturucu orta nokta değerini her döndürdüğünde değişkeni 1.000'e eşit olarak ayarlanır ve azalan değere ayarlanır. Üç iş parçacığı rastgele sayılar oluşturduğundan, birden çok iş parçacığının Decrement(Int32) eşzamanlı olarak güncelleştirilmesini midpointCount sağlamak için yöntemi çağrılır. Rastgele sayı oluşturucuyu korumak için de bir kilit kullanıldığını ve yöntemin yürütmeyi Main üç iş parçacığından önce bitirmediğinden emin olmak için bir CountdownEvent nesnenin kullanıldığını unutmayın.
using System;
using System.Threading;
public class Example
{
const int LOWERBOUND = 0;
const int UPPERBOUND = 1001;
static Object lockObj = new Object();
static Random rnd = new Random();
static CountdownEvent cte;
static int totalCount = 0;
static int totalMidpoint = 0;
static int midpointCount = 10000;
public static void Main()
{
cte = new CountdownEvent(1);
// Start three threads.
for (int ctr = 0; ctr <= 2; ctr++) {
cte.AddCount();
Thread th = new Thread(GenerateNumbers);
th.Name = "Thread" + ctr.ToString();
th.Start();
}
cte.Signal();
cte.Wait();
Console.WriteLine();
Console.WriteLine("Total midpoint values: {0,10:N0} ({1:P3})",
totalMidpoint, totalMidpoint/((double)totalCount));
Console.WriteLine("Total number of values: {0,10:N0}",
totalCount);
}
private static void GenerateNumbers()
{
int midpoint = (UPPERBOUND - LOWERBOUND) / 2;
int value = 0;
int total = 0;
int midpt = 0;
do {
lock (lockObj) {
value = rnd.Next(LOWERBOUND, UPPERBOUND);
}
if (value == midpoint) {
Interlocked.Decrement(ref midpointCount);
midpt++;
}
total++;
} while (Volatile.Read(ref midpointCount) > 0);
Interlocked.Add(ref totalCount, total);
Interlocked.Add(ref totalMidpoint, midpt);
string s = String.Format("Thread {0}:\n", Thread.CurrentThread.Name) +
String.Format(" Random Numbers: {0:N0}\n", total) +
String.Format(" Midpoint values: {0:N0} ({1:P3})", midpt,
((double) midpt)/total);
Console.WriteLine(s);
cte.Signal();
}
}
// The example displays output like the following:
// Thread Thread2:
// Random Numbers: 3,204,021
// Midpoint values: 3,156 (0.099 %)
// Thread Thread0:
// Random Numbers: 4,073,592
// Midpoint values: 4,015 (0.099 %)
// Thread Thread1:
// Random Numbers: 2,828,192
// Midpoint values: 2,829 (0.100 %)
//
// Total midpoint values: 10,000 (0.099 %)
// Total number of values: 10,105,805
Imports System.Threading
Module Example
Const LOWERBOUND As Integer = 0
Const UPPERBOUND As Integer = 1001
Dim lockObj As New Object()
Dim rnd As New Random()
Dim cte As CountdownEvent
Dim totalCount As Integer = 0
Dim totalMidpoint As Integer = 0
Dim midpointCount As Integer = 10000
Public Sub Main()
cte = New CountdownEvent(1)
' Start three threads.
For ctr As Integer = 0 To 2
cte.AddCount()
Dim th As New Thread(AddressOf GenerateNumbers)
th.Name = "Thread" + ctr.ToString()
th.Start()
Next
cte.Signal()
cte.Wait()
Console.WriteLine()
Console.WriteLine("Total midpoint values: {0,10:N0} ({1:P3})",
totalMidpoint, totalMidpoint/totalCount)
Console.WriteLine("Total number of values: {0,10:N0}",
totalCount)
End Sub
Private Sub GenerateNumbers()
Dim midpoint As Integer = (upperBound - lowerBound) \ 2
Dim value As Integer = 0
Dim total As Integer = 0
Dim midpt As Integer = 0
Do
SyncLock lockObj
value = rnd.Next(lowerBound, upperBound)
End SyncLock
If value = midpoint Then
Interlocked.Decrement(midpointCount)
midpt += 1
End If
total += 1
Loop While midpointCount > 0
Interlocked.Add(totalCount, total)
Interlocked.Add(totalMidpoint, midpt)
Dim s As String = String.Format("Thread {0}:", Thread.CurrentThread.Name) + vbCrLf +
String.Format(" Random Numbers: {0:N0}", total) + vbCrLf +
String.Format(" Midpoint values: {0:N0} ({1:P3})", midpt, midpt/total)
Console.WriteLine(s)
cte.Signal()
End Sub
End Module
' The example displays output like the following:
' Thread Thread2:
' Random Numbers: 3,204,021
' Midpoint values: 3,156 (0.099 %)
' Thread Thread0:
' Random Numbers: 4,073,592
' Midpoint values: 4,015 (0.099 %)
' Thread Thread1:
' Random Numbers: 2,828,192
' Midpoint values: 2,829 (0.100 %)
'
' Total midpoint values: 10,000 (0.099 %)
' Total number of values: 10,105,805
Aşağıdaki örnek öncekine benzer, ancak 50.000 rastgele orta nokta tamsayısı oluşturmak için bir iş parçacığı yordamı yerine sınıfını kullanır Task . Bu örnekte, bir lambda ifadesi iş parçacığı yordamının GenerateNumbers yerini alır ve yöntemine Task.WaitAll yapılan çağrı nesne gereksinimini CountdownEvent ortadan kaldırır.
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
const int LOWERBOUND = 0;
const int UPPERBOUND = 1001;
static Object lockObj = new Object();
static Random rnd = new Random();
static int totalCount = 0;
static int totalMidpoint = 0;
static int midpointCount = 50000;
public static async Task Main()
{
List<Task> tasks = new List<Task>();
// Start three tasks.
for (int ctr = 0; ctr <= 2; ctr++)
tasks.Add(Task.Run( () => { int midpoint = (UPPERBOUND - LOWERBOUND) / 2;
int value = 0;
int total = 0;
int midpt = 0;
do {
lock (lockObj) {
value = rnd.Next(LOWERBOUND, UPPERBOUND);
}
if (value == midpoint) {
Interlocked.Decrement(ref midpointCount);
midpt++;
}
total++;
} while (Volatile.Read(ref midpointCount) > 0);
Interlocked.Add(ref totalCount, total);
Interlocked.Add(ref totalMidpoint, midpt);
string s = String.Format("Task {0}:\n", Task.CurrentId) +
String.Format(" Random Numbers: {0:N0}\n", total) +
String.Format(" Midpoint values: {0:N0} ({1:P3})", midpt,
((double) midpt)/total);
Console.WriteLine(s);
} ));
await Task.WhenAll(tasks.ToArray());
Console.WriteLine();
Console.WriteLine("Total midpoint values: {0,10:N0} ({1:P3})",
totalMidpoint, totalMidpoint/((double)totalCount));
Console.WriteLine("Total number of values: {0,10:N0}",
totalCount);
}
}
// The example displays output like the following:
// Task 1:
// Random Numbers: 24,530,624
// Midpoint values: 24,675 (0.101 %)
// Task 2:
// Random Numbers: 7,079,718
// Midpoint values: 7,093 (0.100 %)
// Task 3:
// Random Numbers: 18,284,617
// Midpoint values: 18,232 (0.100 %)
//
// Total midpoint values: 50,000 (0.100 %)
// Total number of values: 49,894,959
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Const LOWERBOUND As Integer = 0
Const UPPERBOUND As Integer = 1001
Dim lockObj As New Object()
Dim rnd As New Random()
Dim totalCount As Integer = 0
Dim totalMidpoint As Integer = 0
Dim midpointCount As Integer = 50000
Public Sub Main()
Dim tasks As New List(Of Task)()
' Start three tasks.
For ctr As Integer = 0 To 2
tasks.Add( Task.Run(Sub()
Dim midpoint As Integer = (upperBound - lowerBound) \ 2
Dim value As Integer = 0
Dim total As Integer = 0
Dim midpt As Integer = 0
Do
SyncLock lockObj
value = rnd.Next(lowerBound, upperBound)
End SyncLock
If value = midpoint Then
Interlocked.Decrement(midpointCount)
midpt += 1
End If
total += 1
Loop While midpointCount > 0
Interlocked.Add(totalCount, total)
Interlocked.Add(totalMidpoint, midpt)
Dim s As String = String.Format("Task {0}:", Task.CurrentId) + vbCrLf +
String.Format(" Random Numbers: {0:N0}", total) + vbCrLf +
String.Format(" Midpoint values: {0:N0} ({1:P3})", midpt, midpt/total)
Console.WriteLine(s)
End Sub ))
Next
Task.WaitAll(tasks.ToArray())
Console.WriteLine()
Console.WriteLine("Total midpoint values: {0,10:N0} ({1:P3})",
totalMidpoint, totalMidpoint/totalCount)
Console.WriteLine("Total number of values: {0,10:N0}",
totalCount)
End Sub
End Module
' The example displays output like the following:
' Task 1:
' Random Numbers: 24,530,624
' Midpoint values: 24,675 (0.101 %)
' Task 2:
' Random Numbers: 7,079,718
' Midpoint values: 7,093 (0.100 %)
' Task 3:
' Random Numbers: 18,284,617
' Midpoint values: 18,232 (0.100 %)
'
' Total midpoint values: 50,000 (0.100 %)
' Total number of values: 49,894,959
Açıklamalar
Bu yöntem, bir taşma koşulunu sarmalayarak işler: If location = Int32.MinValue, location - 1 = Int32.MaxValue. Özel durum oluşturulmaz.
Ayrıca bkz.
Şunlara uygulanır
Decrement(UInt32)
- Kaynak:
- Interlocked.cs
- Kaynak:
- Interlocked.cs
- Kaynak:
- Interlocked.cs
Önemli
Bu API, CLS uyumlu değildir.
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama.
public:
static System::UInt32 Decrement(System::UInt32 % location);[System.CLSCompliant(false)]
public static uint Decrement (ref uint location);[<System.CLSCompliant(false)>]
static member Decrement : uint32 -> uint32Public Shared Function Decrement (ByRef location As UInteger) As UIntegerParametreler
- location
- UInt32
Değeri azalan değişken.
Döndürülenler
Azaltma işlemi tamamlandıktan hemen sonra değişkeninin değeri.
- Öznitelikler
Özel durumlar
adresi location bir null işaretçidir.
Şunlara uygulanır
Decrement(UInt64)
- Kaynak:
- Interlocked.cs
- Kaynak:
- Interlocked.cs
- Kaynak:
- Interlocked.cs
Önemli
Bu API, CLS uyumlu değildir.
Belirtilen bir değişkeni azaltma ve sonucu atomik işlem olarak depolama.
public:
static System::UInt64 Decrement(System::UInt64 % location);[System.CLSCompliant(false)]
public static ulong Decrement (ref ulong location);[<System.CLSCompliant(false)>]
static member Decrement : uint64 -> uint64Public Shared Function Decrement (ByRef location As ULong) As ULongParametreler
- location
- UInt64
Değeri azalan değişken.
Döndürülenler
Azaltma işlemi tamamlandıktan hemen sonra değişkeninin değeri.
- Öznitelikler
Özel durumlar
adresi location bir null işaretçidir.
Şunlara uygulanır
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin