Какой тип C# выбрать для числа

Введите число или минимум и максимум, и подборщик покажет, в каких целых и вещественных типах C# они поместятся. Минимальный по размеру тип выделяется в таблице, для каждого подходящего типа выводится объявление с правильным суффиксом литерала. Расчёт идёт в браузере с точными целыми числами.

Содержание
  1. Как пользоваться подборщиком
  2. Целые типы и их диапазоны
  3. Вещественные типы и точность
  4. Суффиксы литералов
  5. Как выбрать тип на практике
  6. Что будет при переполнении
  7. Частые вопросы

Как пользоваться подборщиком

Введите число в первое поле и посмотрите, какие типы C# способны его хранить. Если нужно проверить диапазон значений, например счётчик от 0 до 5 000 000 000, заполните и второе поле: подойдут только те типы, которые вмещают и минимум, и максимум. Дробные числа можно записывать с точкой или запятой, допустима и запись 1e10.

В таблице для каждого типа показаны размер, диапазон и результат проверки. Слова "Да, но с потерей точности" означают, что число по величине подходит, но в типе не хватает значащих цифр, и часть младших разрядов будет округлена. Строка с минимальным по размеру типом выделена цветом. Ниже выводятся готовые объявления с нужными суффиксами литералов.

Целые типы и их диапазоны

Целых типов в C# девять. Знаковые хранят отрицательные и положительные числа, беззнаковые (с буквой u в названии, а также byte) только неотрицательные, зато вмещают вдвое большее максимальное значение при том же размере.

ТипРазмерМинимумМаксимум
sbyte1 байт-128127
byte1 байт0255
short2 байта-32 76832 767
ushort2 байта065 535
int4 байта-2 147 483 6482 147 483 647
uint4 байта04 294 967 295
long8 байт-9 223 372 036 854 775 8089 223 372 036 854 775 807
ulong8 байт018 446 744 073 709 551 615
Int12816 байтоколо -1,7 x 10^38около 1,7 x 10^38

Тип Int128 появился в .NET 7 вместе с C# 11 и пригодится, когда не хватает long, но не хочется переходить на BigInteger. Более подробный обзор всех встроенных типов есть в статье о типах данных C#.

Вещественные типы и точность

У вещественных типов главный параметр не только диапазон, но и число верных значащих цифр. float занимает 4 байта и даёт около 7 цифр, double занимает 8 байт и даёт 15-17 цифр, decimal занимает 16 байт и хранит 28-29 цифр. Максимум float около 3,4 x 10^38, double около 1,8 x 10^308, decimal около 7,9 x 10^28.

Целое число можно сохранить во float точно, только если оно помещается в 24-битную мантиссу: например, 16 777 216 хранится верно, а 16 777 217 превратится в соседнее значение. Для double граница равна 2^53, то есть 9 007 199 254 740 992. Подборщик учитывает это и помечает такие случаи.

ТипОсноваЗначащих цифрГде применять
floatдвоичная6-9графика, игры, большие массивы данных
doubleдвоичная15-17физика, статистика, общий случай
decimalдесятичная28-29деньги, цены, налоги

Почему выражение 0.1 + 0.2 == 0.3 для double даёт false, разобрано в материале о неточности вещественной арифметики, а выбор между двумя основными типами подробно описан в статье decimal против double.

Суффиксы литералов

Число в коде без суффикса получает первый подходящий тип из списка int, uint, long, ulong, если оно целое, и тип double, если у него есть дробная часть или экспонента. Поэтому запись float x = 3.14; не скомпилируется: двойной литерал нельзя неявно сузить до float. Нужен суффикс f.

СуффиксТип литералаПример
u или Uuint3000000000u
Llong5000000000L
ULulong18446744073709551615UL
f или Ffloat3.14f
d или Ddouble7d
m или Mdecimal19.99m

Для sbyte, byte, short и ushort суффиксов нет. Значения этих типов можно присваивать из целой константы, если она в диапазоне: byte b = 200; работает, а byte b = 256; даёт ошибку компиляции. Для Int128 суффикса тоже нет, а числа больше ulong записывают через Int128.Parse.

Как выбрать тип на практике

Для обычных счётчиков, индексов и размеров коллекций берите int: это тип по умолчанию, с ним работают индексаторы, LINQ и большинство методов библиотеки. Меньшие типы экономят память только в больших массивах и структурах, а в локальных переменных выгоды почти нет.

Когда значение может превысить два миллиарда, например размер файла, число миллисекунд или идентификатор в базе, выбирайте long. Беззнаковые типы нужны для битовых масок, хешей и данных протоколов. Для денег всегда decimal, для измерений и вычислений double, а float оставьте для случаев, когда важен объём памяти или этого требует графический API.

int count = 1_500_000;          // обычный счётчик
long bytes = 5_000_000_000L;    // размер файла больше 2 ГБ
byte red = 200;                 // канал цвета 0-255
decimal price = 1999.90m;       // цена
double angle = 0.5235987756;    // измерение
float speed = 12.5f;            // координаты в игре

Что будет при переполнении

По умолчанию арифметика целых чисел в C# не проверяет выход за границы: значение просто "заворачивается". Если int.MaxValue увеличить на единицу, получится int.MinValue. Это не исключение, и ошибка может остаться незамеченной.

int x = int.MaxValue;
x++;                              // x стал -2147483648

int y = int.MaxValue;
try
{
    y = checked(y + 1);           // OverflowException
}
catch (OverflowException)
{
    Console.WriteLine("Переполнение");
}

Ключевое слово checked включает проверку для выражения или блока. Если сомневаетесь в диапазоне, берите тип пошире: подборщик подскажет, какой именно. Приведения между типами и их риски описаны в статье о приведении типов.

Частые вопросы

Чем отличается int от Int32?

Ничем. int - ключевое слово C#, псевдоним для типа System.Int32. То же верно для остальных типов: long это System.Int64, double это System.Double, и так далее. В коде принято использовать короткие ключевые слова.

Почему число 3000000000 не помещается в int?

Максимум int равен 2 147 483 647, а значение три миллиарда больше. Подойдут uint, если число неотрицательное, или long. Литерал 3000000000 компилятор сам считает типом uint, поэтому для переменной int он даст ошибку.

Когда использовать decimal вместо double?

Если нужна точность в десятичных долях: цены, суммы, налоги. decimal хранит 0.1 без погрешности, а double нет. Платой становится скорость: операции с decimal заметно медленнее, и он занимает вдвое больше памяти.

Что делать, если число не влезает ни в один тип?

Используйте System.Numerics.BigInteger для целых значений любой длины. Для дробных чисел с очень большой точностью есть сторонние библиотеки, но чаще достаточно decimal или double.