Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev6.1.0+1

optional

Uma implementação do tipo Optional, que ajuda a evitar lidar com referências nulas

AndroidiOSWebmacOSWindowsLinux
Downloads em 30 dias
299
Curtidas
38
Pontos Pub
150

Instalar pacote

flutter pub add optional

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote opcional fornece uma abordagem segura e funcional para lidar com valores potencialmente nulos no Dart usando o padrão de tipo Optional. Inspirado no Optional do Java, ele ajuda os desenvolvedores a evitar erros de referência nula ao encapsular valores que podem ou não estar presentes. Em vez de retornar null, os métodos retornam uma instância de Optional, incentivando o tratamento explícito da ausência. Isso promove um código mais limpo e previsível, reduzindo crashes em tempo de execução causados por nulos. O pacote se integra perfeitamente aos recursos de segurança contra nulos do Dart.

Casos de uso

  • Método de tratamento que pode retornar nulo
  • Evitando verificações nulas com operações encadeadas
  • Melhorando a legibilidade do código em pipelines de dados
  • Gerenciando valores de configuração que podem estar ausentes
  • Implementando análise segura de respostas de banco de dados ou API

Principais recursos

  • Envoltório de valor seguro para nulos
  • Encadeamento de métodos com map/flatMap
  • Extração segura com getOrElse
  • Suporte a padrões de programação funcional
  • Design composável e imutável

Indicado para

  • Desenvolvedores usando segurança nula no Dart
  • Equipes que buscam reduzir erros relacionados a nulos
  • Projetos que exigem tratamento de erro limpo
  • Bases de código em estilo funcional do Dart
  • Aplicações com fluxo de dados complexo

Considerações

  • Adiciona um pequeno sobrecarga para casos simples
  • Requer aprendizado de novo padrão
  • Não adequado para caminhos críticos de desempenho
  • Pode aumentar a verbosidade do código em casos triviais
  • Melhor usado em conjunto com segurança nula

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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);
}

Categorias

Dependências

Lista de dependências 1 itens

Repositório-fonte

Projetos que usam este pacote