Aracılığıyla paylaş

Tam sayı türleri (C# başvurusu)

Tamsayı sayısal türleri tamsayı sayılarını gösterir. Tüm tam sayı sayısal türleri değer türleridir. Bunlar ayrıca basit türlerdir ve literaller ile başlatılabilir. Tüm tam sayı sayısal türleri aritmetik, bit düzeyinde mantıksal, karşılaştırma ve eşitlik işleçlerini destekler.

İntegral türlerinin özellikleri

C# aşağıdaki önceden tanımlanmış tam sayı türlerini destekler:

C# türü/anahtar sözcüğü Aralık Boyut .NET türü
sbyte -128 - 127 İmzalı 8 bit tamsayı System.SByte
byte 0 - 255 İşaretsiz 8 bit tamsayı System.Byte
short -32.768 - 32.767 İmzalı 16 bit tamsayı System.Int16
ushort 0 - 65.535 İşaretsiz 16 bit tamsayı System.UInt16
int -2.147.483.648 ile 2.147.483.647 İmzalı 32 bit tam sayı System.Int32
uint 0 - 4.294.967.295 İşaretsiz 32 bit tamsayı System.UInt32
long -9,223,372,036,854,775,808 - 9,223,372,036,854,775,807 İmzalı 64 bit tamsayı System.Int64
ulong 0 - 18.446.744.073.709.551.615 İşaretsiz 64 bit tamsayı System.UInt64
nint Platforma bağlıdır (çalışma zamanında hesaplanır) İmzalı 32-bit veya 64-bit tamsayı System.IntPtr
nuint Platforma bağlıdır (çalışma zamanında hesaplanır) İşaretsiz 32 bit veya 64 bit tamsayı System.UIntPtr

Son ikisi dışındaki tüm tablo satırlarında, en soldaki sütundaki her C# türü anahtar sözcüğü, karşılık gelen .NET türü için bir diğer addır. Anahtar sözcük ve .NET tür adı birbirinin yerine kullanılabilir. Örneğin, aşağıdaki bildirimler aynı türdeki değişkenleri bildirir:

int a = 123;
System.Int32 b = 123;

nint Tablonun son iki satırındaki ve nuint türleri yerel boyutlu tamsayılardır. nint tanımlamak için ve nuint bağlamsal anahtar sözcüklerini kullanabilirsiniz. Bunlar 32 bit işlemde çalıştırılırken 32 bit tamsayılar veya 64 bit işlemde çalıştırılırken 64 bit tamsayılardır. Bunlar birlikte çalışma senaryoları, düşük düzeyli kitaplıklar için ve tamsayı matematiğin yoğun olarak kullanıldığı senaryolarda performansı iyileştirmek için kullanılabilir.

Yerel boyutlu tamsayı türleri dahili olarak .NET türleri System.IntPtr ve System.UIntPtrolarak temsil edilir. C# 11'den başlayarak, nint ve nuint türleri, temel türlerin diğer adlarıdır.

Her integral türünün varsayılan değeri sıfırdır 0.

Tamsayı türlerinin her biri, o türün en düşük ve en yüksek değerlerini sağlayan MinValue ve MaxValue özelliklerine sahiptir. Bu özellikler, yerel boyutlu türlerin (nint ve nuint) durumu dışında derleme zamanı sabitleridir. MinValue ve MaxValue özellikleri yerel boyutlu türler için çalışma zamanında hesaplanır. Bu türlerin boyutları işlem ayarlarına bağlıdır.

System.Numerics.BigInteger Üst veya alt sınırları olmayan imzalı bir tamsayıyı temsil etmek için yapısını kullanın.

Tamsayı değişmez değerleri

Tamsayı sabit değerler

  • decimal: ön ek olmadan
  • onaltılık: 0x veya 0X ön ekiyle
  • ikili sayı sistemi: 0b veya 0B ön eki ile

Aşağıdaki kod, her birinin bir örneğini gösterir:

var decimalLiteral = 42;
var hexLiteral = 0x2A;
var binaryLiteral = 0b_0010_1010;

Yukarıdaki örnekte _'nin basamak ayırıcısı olarak kullanımı da görülmektedir. Basamak ayırıcısını her türlü sayı sabitiyle kullanabilirsiniz.

Bir tamsayı literali türü, soneki ile aşağıdaki şekilde belirlenir.

  • Değişmez değerde sonek yoksa, türü değerinin temsil edilebileceği aşağıdaki türlerden ilkidir: int, uint, long, ulong.

    Uyarı

    Literaller pozitif değerler olarak yorumlanır. Örneğin, literal 0xFF_FF_FF_FF, 4294967295 türü için uint sayısını temsil eder, ancak -1 türü için int sayısıyla aynı bit temsilini paylaşır. Belirli bir türde bir değere ihtiyacınız varsa, bir sabiti o türe dökün. Eğer bir sabit değer hedef türde temsil edilemiyorsa unchecked operatörünü kullanın. Örneğin, unchecked((int)0xFF_FF_FF_FF) üretir -1.

  • Eğer değişmez, U veya u ile soneklenmişse, değeri temsil edebileceği aşağıdaki türlerden ilki olarak kabul edilir: uint, ulong.

  • Eğer değişmez, L veya l ile soneklenmişse, değeri temsil edebileceği aşağıdaki türlerden ilki olarak kabul edilir: long, ulong.

    Uyarı

    Küçük harfi l sonek olarak kullanabilirsiniz. Ancak, bu bir derleyici uyarısı oluşturur çünkü harf l ile basamak 1karıştırılabilir. Netlik için kullanın L .

  • Değişmez değer UL, Ul, uL, ul, LU, Lu, lU, veya lu ile soneklenmişse türü ulong olur.

Bir tamsayı değişmez ile temsil edilen değer UInt64.MaxValue'i aşarsa, CS1021 derleyici hatası oluşur.

Bir tamsayı değişmezinin belirlenen türü int ise ve değişmez tarafından temsil edilen değer hedef türün aralığındaysa, değer örtük olarak sbyte, byte, short, ushort, uint, ulong, nint veya nuint öğesine dönüştürülebilir.

byte a = 17;
byte b = 300;   // CS0031: Constant value '300' cannot be converted to a 'byte'

Önceki örnekte gösterildiği gibi, değişmez değer hedef türün sınırları içinde değilse CS0031 derleyici hatası verilir.

Bir tamsayı değişmezi ile temsil edilen değeri, değişmez değerin belirlenen türünden başka bir türe dönüştürmek için de bir dönüştürme kullanabilirsiniz.

var signedByte = (sbyte)42;
var longVariable = (long)42;

Dönüşümler

Herhangi bir tam sayı sayısal türünü başka bir tam sayı sayısal türüne dönüştürebilirsiniz. Hedef türü kaynak türün tüm değerlerini depolayabilirse, dönüştürme örtük olur. Aksi takdirde, açık dönüştürme gerçekleştirmek için bir atama ifadesi kullanmanız gerekir. Daha fazla bilgi için bkz. Yerleşik sayısal dönüştürmeler.

Yerel boyutlu tamsayılar

Depolama alanı hedef makinedeki doğal tamsayı boyutuna göre belirlendiğinden, yerel boyutlu tamsayı türleri özel davranışa sahiptir.

  • Çalışma zamanında yerel boyutlu bir tamsayı boyutunu almak için kullanabilirsiniz sizeof(). Ancak, kodun güvenli olmayan bir bağlamda derlenmiş olması gerekir. Örneğin:

    Console.WriteLine($"size of nint = {sizeof(nint)}");
Console.WriteLine($"size of nuint = {sizeof(nuint)}");

// output when run in a 64-bit process
//size of nint = 8
//size of nuint = 8

// output when run in a 32-bit process
//size of nint = 4
//size of nuint = 4

    Statik IntPtr.Size ve UIntPtr.Size özelliklerinden eşdeğer değeri de alabilirsiniz.

  • Çalışma zamanında yerel boyutlu tamsayıların en düşük ve en yüksek değerlerini almak için MinValue ve MaxValue anahtar sözcüklerini nint ve nuint statik özellikler olarak, aşağıdaki örnekte olduğu gibi kullanın:

    Console.WriteLine($"nint.MinValue = {nint.MinValue}");
Console.WriteLine($"nint.MaxValue = {nint.MaxValue}");
Console.WriteLine($"nuint.MinValue = {nuint.MinValue}");
Console.WriteLine($"nuint.MaxValue = {nuint.MaxValue}");

// output when run in a 64-bit process
//nint.MinValue = -9223372036854775808
//nint.MaxValue = 9223372036854775807
//nuint.MinValue = 0
//nuint.MaxValue = 18446744073709551615

// output when run in a 32-bit process
//nint.MinValue = -2147483648
//nint.MaxValue = 2147483647
//nuint.MinValue = 0
//nuint.MaxValue = 4294967295

  • nint ve nuint aralıklarının tamamı daha geniş olsa da derleme zamanı sabitleri 32 bitlik bir aralıkla sınırlıdır.

  • Derleyici, diğer sayısal türlere örtük ve açık dönüştürmeler sağlar. Daha fazla bilgi için bkz. Yerleşik sayısal dönüştürmeler.

  • Yerel boyutlu tamsayı sabitleri için belirli bir söz dizimi mevcut değildir. Yerel boyutlu bir tamsayının bir değişmez değer olduğunu belirten bir sonek yoktur. Örneğin L, bir long işaret etmek içindir. Bunun yerine diğer tamsayı değerlerinin örtük veya açık atamalarını kullanabilirsiniz. Örneğin:

    nint a = 42
nint a = (nint)42;

C# dil belirtimi

Daha fazla bilgi için C# dil belirtimininaşağıdaki bölümlerine bakın:

Ayrıca bakınız

  • Last updated on