Interlocked.Decrement Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci.
Přetížení
| Decrement(Int64) |
Sníží zadanou proměnnou a výsledek se uloží jako atomická operace. |
| Decrement(Int32) |
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci. |
| Decrement(UInt32) |
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci. |
| Decrement(UInt64) |
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci. |
Decrement(Int64)
- Zdroj:
- Interlocked.CoreCLR.cs
- Zdroj:
- Interlocked.CoreCLR.cs
- Zdroj:
- Interlocked.CoreCLR.cs
Sníží zadanou proměnnou a výsledek se uloží jako atomická operace.
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
Proměnná, jejíž hodnota má být degradována.
Návraty
Hodnota proměnné bezprostředně po dokončení operace dekrementace
Výjimky
Adresa location je null ukazatel.
Adresa location je null ukazatel.
Poznámky
Tato metoda zpracovává podmínku přetečením zabalením: if location = Int64.MinValue, location - 1 = Int64.MaxValue. Žádná výjimka se nevyvolá.
Viz také
Platí pro
Decrement(Int32)
- Zdroj:
- Interlocked.CoreCLR.cs
- Zdroj:
- Interlocked.CoreCLR.cs
- Zdroj:
- Interlocked.CoreCLR.cs
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci.
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
Proměnná, jejíž hodnota má být degradována.
Návraty
Hodnota proměnné bezprostředně po dokončení operace dekrementace
Výjimky
Adresa location je null ukazatel.
Adresa location je null ukazatel.
Příklady
Následující příklad určuje, kolik náhodných čísel v rozsahu od 0 do 1 000 je potřeba k vygenerování 1 000 náhodných čísel se střední hodnotou. Aby bylo možné sledovat počet hodnot středových bodů, midpointCountje proměnná nastavena na hodnotu 1 000 a vždy, když generátor náhodných čísel vrátí hodnotu střední bodu, se sníží. Vzhledem k tomu, že tři vlákna generují náhodná čísla, Decrement(Int32) volá se metoda, aby se zajistilo, že se současně neaktualizuje midpointCount více vláken. Všimněte si, že zámek slouží také k ochraně generátoru náhodných čísel a že CountdownEvent objekt se používá k zajištění, že Main metoda nedokončí provádění před třemi vlákny.
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
Následující příklad je podobný předchozímu, s tím rozdílem, že používá Task třídu místo procedury vlákna k vygenerování 50 000 náhodných celých čísel střední bod. V tomto příkladu nahradí proceduru GenerateNumbers vlákna výraz lambda a volání Task.WaitAll metody eliminuje potřebu objektu 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
Poznámky
Tato metoda zpracovává podmínku přetečení zabalením: If location = Int32.MinValue, location - 1 = Int32.MaxValue. Žádná výjimka se nevyvolá.
Viz také
Platí pro
Decrement(UInt32)
- Zdroj:
- Interlocked.cs
- Zdroj:
- Interlocked.cs
- Zdroj:
- Interlocked.cs
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci.
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
Proměnná, jejíž hodnota má být degradována.
Návraty
Hodnota proměnné bezprostředně po dokončení operace dekrementace
- Atributy
Výjimky
Adresa location je null ukazatel.
Platí pro
Decrement(UInt64)
- Zdroj:
- Interlocked.cs
- Zdroj:
- Interlocked.cs
- Zdroj:
- Interlocked.cs
Důležité
Toto rozhraní API neodpovídá specifikaci CLS.
Sníží zadanou proměnnou a uloží výsledek jako atomovou operaci.
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
Proměnná, jejíž hodnota má být degradována.
Návraty
Hodnota proměnné bezprostředně po dokončení operace dekrementace
- Atributy
Výjimky
Adresa location je null ukazatel.
Platí pro
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro