搜尋套件、儲存庫與 APP 分類

套件詳情v1.0.5

num_utilities

一組用於數字、整數和雙精確浮點數的擴展方法;以及數字、整數和雙精確浮點數的可迭代集合。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
3240
喜歡數
2
Pub 分數
150

安裝套件

flutter pub add num_utilities

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

num_utilities 是一個 Dart 套件,透過有用的擴展方法增強數值類型(int、double)及其可迭代物件。它提供方便的數學運算、轉換和資料處理工具,提升程式碼可讀性並減少重複程式碼。此套件輕量級,設計用於無縫整合至所有主要平台上的 Flutter 與 Dart 專案。非常適合需要進行計算或統計處理之應用程式的數值資料開發。

適用情境

  • 對數字列表執行批量數學運算
  • 簡化數值類型轉換
  • 增強算術表達式的可讀性
  • 處理數值計算中的邊緣情況
  • 在集合上實現統計函數
  • 簡化資料預處理

主要特色

  • int 和 double 的擴展方法
  • 數值集合的 Iterable 支援
  • 簡潔、可鏈式呼叫的語法
  • 跨平台相容性
  • 最小依賴
  • 透過 pub add 輕鬆整合

適合對象

  • 需要數學輔助工具的 Flutter 開發人員
  • 行動與Web應用中的資料處理
  • 涉及數值分析的專案
  • 重視程式碼乾淨、易讀的團隊
  • 教育類或原型應用

使用建議

  • 僅限數值類型
  • 沒有針對極端值的內建錯誤處理
  • 未針對大規模數值計算進行優化
  • 需要手動測試邊緣情況
  • 不取代完整的數學函式庫,例如 'math_expressions'
  • 最適合簡單到中等的數值任務

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

num_utilities

A collection of extension methods for [num]s, [int]s, and [double]s; and iterables of [num]s, [int]s, and [double]s.

See: list_utilities

Usage

import 'package:num_utilities/num_utilities.dart';

Numbers

[num]s, [int]s, and [double]s were extended with the following methods/getters:

isPositive

[isPositive] returns true if the number's sign is positive.

final numA = 5;
print(numA.isPositive); // true

final numB = -5;
print(numB.isPositive); // false
equals

[equals] is equivalent to the == operator, but has an optional parameter to round the numbers before comparing them, by calling [roundTo] (see below.)

final numA = 5.556;
final numB = 5.557;
print(numA.equals(numB)); // false
print(numA.equals(numB, 100)); // true
isWithin

[isWithin] returns true if the number matches or is within the range of any of the parts defined in the provided [expression].

The provided [expression] must be a string of numbers and/or ranges separated by commas.

final value = 7;
print(value.isWithin('0,2,4,6')); // false
print(value.isWithin('1,2,6-8,10')); // true
print(value.isWithin('0-4,7,12-15')); // true
isWithinRange

[isWithinRange] returns true if this number is within the range of the provided [start] and [end] values.

final value = 7;
print(value.isWithinRange(4, 8)); // true
print(value.isWithinRange(8, 4)); // true
print(value.isWithinRange(2, 6)); // false
roundTo

[roundTo] rounds the number by the value: (number * value).round() / value

final number = 5.556;
print(number.roundTo(10)); // 5.6
roundToPrecision

[roundToPrecision] rounds the number to the specified number of decimal points.

final number = 5.5567893;
print(number.roundToPrecision(3)); // 5.557

Iterables

Iterables of [num]s, [int]s, and [double]s were extended with the following methods:

sum

The [sum] method returns the sum of all of the values in the iterable.

final list = [1, 2, 3, 4, 5];
print(list.sum()); // 15
absSum

The [absSum] method returns the sum of all of the absolute values in the iterable.

[absSum] has an optional parameter to invert the returned value.

final list = [1, -2, 3, -4, 5];
print(list.absSum()); // 15
print(list.absSum(false)); // 15
print(list.absSum(true)); // -15
print(list.sum()); // 3
highest

The [highest] getter returns the highest value in the iterable.

final list = [1, 2, 3, 4, 5];
print(list.highest); // 5
lowest

The [lowest] getter returns the lowest value in the iterable.

final list = [1, 2, 3, 4, 5];
print(list.lowest); // 1

Range

The [Range] object defines a range of numbers between specified [min] and [max] values, and has convienence methods for generating numbers within the range and for interpolating values within the range.

final range = Range(5, 15);
print(range.min); // 5
print(range.max); // 15

span

The [span] getter returns the difference between the [min] and [max] values.

print(range.span); // 10

random

The [random] method will output a number between the [min] value, inclusive, and the [max] value, exclusive.

[random] accepts an optional [seed] value.

print(range.random());
print(range.random(seed));

secureRandom

The [secureRandom] method will output a cryptographically secure number between the [min] value, inclusive, and [max] value, exclusive.

print(range.secureRandom());

interpolate

The [interpolate] method returns a [List] of numbers spanning a defined number of [steps] between the [min] and [max] values.

print(range.interpolate(5)); // [5.0, 7.0, 9.0, 11.0, 13.0]
inclusive

[interpolate]'s inclusive parameter can be used to include the [max] number within the output [List].

print(range.interpolate(5, inclusive: true)); // [5.0, 7.0, 9.0, 11.0, 13.0, 15.0]
randomize

[interpolate]'s randomize parameter can be used to apply randomness to the output numbers, where a value of 0.0 doesn't apply any randomness to the numbers, while a value of 1.0 will randomize the output numbers within the entire range of the radius around each step.

print(range.interpolate(5, randomize: 1.0)); // [5.23, 6.18, 8.27, 10.27, 13.46]

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。