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. İntegral türleri basit türlerdir ve değişmez değerlerle 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. Yerel boyutlu tamsayılar, 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. nint ve nuint türleri, temel alınan 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.

Soneki, tamsayı değişmez değeri türünü aşağıdaki gibi belirler:

  • 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. unchecked Sabit değer hedef türde gösterilemiyorsa işlecini kullanın. Örneğin, unchecked((int)0xFF_FF_FF_FF) üretir -1.

  • Değişmez değer veya u son ekini U içeriyorsa, türü değerinin temsil edilebileceği aşağıdaki türlerden ilkidir: uint, ulong.

  • Değişmez değer veya l son ekini L içeriyorsa, türü değerinin temsil edilebileceği aşağıdaki türlerden ilkidir: long, ulong.

    Uyarı

    Küçük harfi l sonek olarak kullanabilirsiniz. Bununla birlikte, l harfin l rakamı 1ile karıştırılabildiği için derleyici uyarısı oluşturur. Netlik için kullanın L .

  • Değişmez değer , , , , , ul, LULu, lU, veya lu soneklerinden ULbirini içeriyorsa, türü olurulong. uLUl

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

Bir tamsayı değişmez değerinin belirlenen türü ise int ve değişmez değer tarafından temsil edilen değer hedef türün aralığındaysa, değer örtük olarak , , byte, shortushort, , uint, , ulongnint, veya nuintöğesine sbytedö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ı boyutuyla eşleştiğ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

  • ve nuint aralığının nint tamamı daha büyük olsa da derleme zamanı sabitleri 32 bitlik bir aralıkla sınırlandırılı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