Dart: Dart 変数とデータ型 — 5 つの宣言方法

// DataPipeline 設定のベストプラクティス
const int maxRecords = 1000000;       // コンパイル時定数
final String pipelineName;             // 実行時定数（1 回だけ設定）
var processedCount = 0;                // int として推論、ミュータブル
late String outputPath;                // 後で初期化
// dynamic は可能な限り避ける

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  var name = 'DataPipeline';   // String として推論
  var count = 1000;            // int として推論
  var rate = 0.08;             // double として推論

  // 同じ型で再代入可能
  name = 'Analytics';          // OK - String のまま
  count = 2000;                // OK - int のまま

  // 型は変更できない
  // count = 'two thousand';   // コンパイルエラー！
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  // 実行時に 1 回だけ設定
  final DateTime startTime = DateTime.now();
  final String configPath = '/etc/datapipeline/config.yaml';

  // 再代入不可
  // configPath = '/other/path';  // コンパイルエラー！

  // コレクションの final - 中身は変更可能
  final List<String> sources = ['orders.csv', 'products.csv'];
  sources.add('customers.csv');   // OK - 中身の変更
  // sources = ['new_list'];       // エラー - 参照の再代入不可
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  // コンパイル時に判明している必要がある
  const int maxRecords = 1000000;
  const double taxRate = 0.08;
  const String version = '1.0.0';

  // const コレクションは深くイミュータブル
  const List<String> formats = ['json', 'csv', 'html'];
  // formats.add('xml');  // エラー！const リストは変更不可

  // const コンストラクタ
  const config = PipelineConfig(batchSize: 10000);
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

class DataPipeline {
  late String outputPath;  // 後で設定

  void configure(String path) {
    outputPath = path;
  }

  late final int maxRecords = _loadMaxRecords();  // 初回アクセス時に計算

  int _loadMaxRecords() {
    print('Loading max records config...');
    return 1000000;
  }
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  dynamic value = 'hello';   // String
  value = 42;                // OK - int になる
  value = [1, 2, 3];        // OK - List になる

  // コンパイル時の型チェックなし - 危険！
  // value.nonExistentMethod();  // コンパイルエラーなし、ランタイムクラッシュ

  // 柔軟性が必要なときは dynamic より Object? を推奨
  Object? safeValue = 'test';
  // safeValue.nonExistentMethod();  // コンパイルエラー - より安全
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  int orderCount = 1500;
  double totalAmount = 52500.75;
  num genericNum = 42;      // num は int と double のスーパークラス
  genericNum = 3.14;        // OK - num は両方を受け入れる

  // 算術演算
  double avgOrderValue = totalAmount / orderCount;
  int roundedDown = totalAmount.toInt();

  // 便利なメソッド
  print(totalAmount.toStringAsFixed(2));  // 52500.75
  print(orderCount.isEven);              // false (1500 は偶数、true)
  print(orderCount.clamp(0, 1000));      // 1000 (最大値にクランプ)
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  // 文字列補間
  String product = 'DataPipeline';
  int users = 5000;
  print('$product has $users users');               // 単純な補間
  print('Revenue: ${users * 99} USD');              // 式の補間
  print('Average: ${(125000 / users).toStringAsFixed(2)} USD');

  // 複数行文字列
  String description = '''
  DataPipeline - E-Commerce Analytics Tool
  Processes up to 1,000,000 orders per batch
  Supports JSON, CSV, and HTML output formats
  ''';

  // ロー文字列（エスケープ処理なし）
  String path = r'C:\Users\Bob\data\orders.csv';
  String regex = r'\d{4}-\d{2}-\d{2}';  // 日付パターン

  // 便利なメソッド
  String raw = '  Hello, World!  ';
  print(raw.trim());                  // 'Hello, World!'
  print(raw.toUpperCase());           // '  HELLO, WORLD!  '
  print('USD 1,500.00'.replaceAll(',', ''));  // 'USD 1500.00'
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

void main() {
  bool isProduction = true;
  bool isDebug = false;

  // Dart は条件に明示的な bool を要求する
  int count = 0;
  // if (count) {}  // エラー！bool 必須
  if (count > 0) {  // OK - 明示的な比較
    print('Has records');
  }

  // 論理演算子
  bool shouldProcess = isProduction && !isDebug;
  bool hasData = count > 0 || isProduction;
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

// 良い - ローカル変数はコンパイラに推論させる
var name = 'DataPipeline';     // String と推論
var count = 100;               // int と推論
var items = <String>[];        // 明示的なジェネリック、List と推論

// 良い - 公開 API は明示的に型付け
String get displayName => name;
int get maxCapacity => 1000000;

// 良い - 変更されない値には final を使う
final startTime = DateTime.now();

// 避ける - ローカル変数に不要な明示型
// String name = 'DataPipeline';  // 冗長
// int count = 100;               // 冗長

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

// DataPipeline 設定定数
const String appName = 'DataPipeline';
const int defaultBatchSize = 10000;
const double defaultTaxRate = 0.08;

// ランタイム設定
class PipelineConfig {
  final String version;
  final int batchSize;
  final String outputFormat;

  PipelineConfig({
    this.version = '1.0.0',
    this.batchSize = defaultBatchSize,
    this.outputFormat = 'json',
  });

  @override
  String toString() =>
      '$appName v$version | Batch: $batchSize | Format: $outputFormat';
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

// ============================================
// DataPipeline 変数宣言デモ
// すべての宣言型の正しい使い方を示す
// ============================================

// コンパイル時定数 - 実行間で決して変わらない
const String appName = 'DataPipeline';
const int maxRecords = 1000000;
const double taxRate = 0.08;
const List<String> supportedFormats = ['json', 'csv', 'html'];

class Order {
  final String id;          // 構築後にランタイム定数
  final double amount;      // 構築後にランタイム定数
  late String status;       // 処理ロジックで設定

  Order({required this.id, required this.amount});

  double get tax => amount * taxRate;
  double get total => amount + tax;

  String get formattedAmount =>
      '\$${amount.toStringAsFixed(2)} USD';
}

class DataPipeline {
  final String name;
  var processedCount = 0;              // ミュータブルカウンター
  late final DateTime startTime;       // 初回実行時に設定

  DataPipeline({required this.name});

  void start() {
    startTime = DateTime.now();
    print('$appName started at $startTime');
  }

  void processOrder(Order order) {
    processedCount++;
    order.status = 'processed';
    print('Order ${order.id}: ${order.formattedAmount} '
        '(tax: \$${order.tax.toStringAsFixed(2)} USD)');
  }

  void printSummary() {
    print('\n=== Summary ===');
    print('Pipeline: $name');
    print('Processed: $processedCount orders');
    print('Capacity: $processedCount / $maxRecords');
  }
}

void main() {
  final pipeline = DataPipeline(name: 'E-Commerce Analytics');
  pipeline.start();

  final orders = [
    Order(id: 'ORD-001', amount: 1500.00),
    Order(id: 'ORD-002', amount: 3250.50),
    Order(id: 'ORD-003', amount: 890.25),
  ];

  for (final order in orders) {
    pipeline.processOrder(order);
  }

  pipeline.printSummary();
}

> **出力：** ローカルの DartPad または `dart run` で実行してください。この Dart コースの全例は Dart 3.x / Flutter 3.x ベースです。SDK バージョンにより結果が多少異なる場合があります。

DataPipeline started at 2024-01-15 10:30:00.000
Order ORD-001: $1500.00 USD (tax: $120.00 USD)
Order ORD-002: $3250.50 USD (tax: $260.04 USD)
Order ORD-003: $890.25 USD (tax: $71.22 USD)

=== Summary ===
Pipeline: E-Commerce Analytics
Processed: 3 orders
Capacity: 3 / 1000000