Interlocked.Decrement Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna.
Przeciążenia
| Decrement(Int64) |
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna. |
| Decrement(Int32) |
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna. |
| Decrement(UInt32) |
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna. |
| Decrement(UInt64) |
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna. |
Decrement(Int64)
- Źródło:
- Interlocked.CoreCLR.cs
- Źródło:
- Interlocked.CoreCLR.cs
- Źródło:
- Interlocked.CoreCLR.cs
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna.
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 LongParametry
- location
- Int64
Zmienna, której wartość ma zostać zdekrementowana.
Zwraca
Wartość zmiennej bezpośrednio po zakończeniu operacji dekrementacji.
Wyjątki
Adres to locationnull wskaźnik.
Adres to locationnull wskaźnik.
Uwagi
Ta metoda obsługuje warunek przepełnienia przez zawijanie: jeśli location = Int64.MinValue, location - 1 = Int64.MaxValue. Wyjątek nie jest zgłaszany.
Zobacz też
Dotyczy
Decrement(Int32)
- Źródło:
- Interlocked.CoreCLR.cs
- Źródło:
- Interlocked.CoreCLR.cs
- Źródło:
- Interlocked.CoreCLR.cs
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna.
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 IntegerParametry
- location
- Int32
Zmienna, której wartość ma zostać zdekrementowana.
Zwraca
Wartość zmiennej bezpośrednio po zakończeniu operacji dekrementacji.
Wyjątki
Adres to locationnull wskaźnik.
Adres to locationnull wskaźnik.
Przykłady
Poniższy przykład określa liczbę losowych liczb z zakresu od 0 do 1000 do wygenerowania 1000 losowych liczb z wartością punktu środkowego. Aby śledzić liczbę wartości punktu środkowego, zmienna , jest ustawiona na 1000 i dekrementowana za każdym razem, midpointCountgdy generator liczb losowych zwraca wartość punktu środkowego. Ponieważ trzy wątki generują liczby losowe, metoda jest wywoływana w Decrement(Int32) celu zapewnienia, że wiele wątków nie jest aktualizowanych midpointCount współbieżnie. Należy pamiętać, że blokada jest również używana do ochrony generatora liczb losowych i że CountdownEvent obiekt jest używany do zapewnienia, że Main metoda nie kończy wykonywania przed trzema wątkami.
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
Poniższy przykład jest podobny do poprzedniego, z wyjątkiem tego, że używa Task klasy zamiast procedury wątku do generowania 50 000 losowych liczb całkowitych punktu środkowego. W tym przykładzie wyrażenie lambda zastępuje GenerateNumbers procedurę wątku, a wywołanie metody Task.WaitAll eliminuje potrzebę obiektu CountdownEvent .
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
Uwagi
Ta metoda obsługuje warunek przepełnienia przez zawijanie: Jeśli location = Int32.MinValue, location - 1 = Int32.MaxValue. Wyjątek nie jest zgłaszany.
Zobacz też
Dotyczy
Decrement(UInt32)
- Źródło:
- Interlocked.cs
- Źródło:
- Interlocked.cs
- Źródło:
- Interlocked.cs
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją CLS.
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna.
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 UIntegerParametry
- location
- UInt32
Zmienna, której wartość ma zostać zdekrementowana.
Zwraca
Wartość zmiennej bezpośrednio po zakończeniu operacji dekrementacji.
- Atrybuty
Wyjątki
Adres to locationnull wskaźnik.
Dotyczy
Decrement(UInt64)
- Źródło:
- Interlocked.cs
- Źródło:
- Interlocked.cs
- Źródło:
- Interlocked.cs
Ważne
Ten interfejs API nie jest zgodny ze specyfikacją CLS.
Dekrementuje określoną zmienną i przechowuje wynik jako operację niepodzielna.
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 ULongParametry
- location
- UInt64
Zmienna, której wartość ma zostać zdekrementowana.
Zwraca
Wartość zmiennej bezpośrednio po zakończeniu operacji dekrementacji.
- Atrybuty
Wyjątki
Adres to locationnull wskaźnik.
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla