パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v6.1.0+1

optional

null参照の取り扱いを回避するためのOptional型の実装

AndroidiOSWebmacOSWindowsLinux
30日間ダウンロード
299
いいね数
38
Pub ポイント
150

パッケージをインストール

flutter pub add optional

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

オプションパッケージは、Dartで可能性のあるnull値を処理するための安全で関数的なアプローチを提供し、Optional型パターンを使用しています。JavaのOptionalにインスパイアされており、存在するかしないか不明な値をカプセル化することで、開発者がnull参照エラーを回避できるようにします。nullを返す代わりに、メソッドはOptionalインスタンスを返すことで、欠損の明示的な処理を促進します。これにより、よりクリーンで予測可能なコードが得られ、nullによる実行時クラッシュを減らします。このパッケージはDartのnull安全性機能とシームレスに統合されています。

用途

  • null を返す可能性のあるメソッドの処理方法
  • チェーンされた操作でnullチェックを回避する
  • データパイプラインにおけるコードの可読性の向上
  • 欠落している可能性のある構成値の管理
  • 安全なデータベースまたはAPI応答のパースを実装する

主な機能

  • null安全な値ラッピング
  • メソッドチェーンと map/flatMap
  • getOrElse を用いた安全な抽出
  • 関数型プログラミングパターンのサポート
  • 合成可能で不変な設計

適している対象

  • Dartでnull安全性を使用する開発者
  • null関連のバグを減らそうとしているチーム
  • クリーンなエラー処理を必要とするプロジェクト
  • 関数型スタイルのDartコードベース
  • 複雑なデータフローを持つアプリケーション

注意事項

  • 簡単なケースに対してわずかなオーバーヘッドを追加します
  • 新しいパターンを学ぶ必要がある
  • パフォーマンスが重要なパスには適していません
  • 単純なケースではコードの冗長性が増す可能性がある
  • null セーフティと併用するのが最適です

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

Coverage Status

Optional.dart

Optional.dart is an implementation of the Optional type, inspired by Java 8's Optional class.

Optional helps avoid null reference errors by wrapping values in an object that holds information regarding whether the value is present or not.

For example, when applying a set of operations to a value, any of which might return null, you can get rid of the null checks by using Optional.map():

String? getString() {
  // ..
  if (condition) {
    return null;
  } else {
    return "12";
  }
}

int? calculateSomething(String str) {
  // ...
  if (someCondition) {
    return null;
  } else {
    return 3 + int.parse(str);
  }
} 

double? calculateSomethingElse(int val) {
  // ...
  if (anotherCondition) {
    return null;
  } else {
    return val * 1.42;
  }
}

void main() {
  
  // before
  
  String? str;
  int? i;
  double? d;
  
  str = getString();
  
  if (str != null) {
    i = calculateSomething(str);
  }
  
  if (i != null) {
    d = calculateSomethingElse(i);
  }
  
  if (d != null) {
    print(d);
  }
  
  // with Optional
  
  Optional.ofNullable(getString())
    .map(calculateSomething)
    .map(calculateSomethingElse)
    .ifPresent(print);
}

カテゴリー

依存関係

依存関係一覧 1 件

ソースリポジトリ

このパッケージを使用しているプロジェクト