Effect-TS fornece métodos para verificar se uma opção contém um valor específico. Essas funções permitem determinar a presença de um valor em uma Opção, usando uma função de equivalência personalizada ou a equivalência padrão. Neste artigo, exploraremos duas funções principais para verificar elementos em Opções: O.containsWith e O.contains.

Exemplo 1: Verificando Elementos com Equivalência Personalizada usando O.containsWith

Conceito

A função O.containsWith verifica se uma Option contém um valor especificado usando uma função de equivalência personalizada. Esta função retorna verdadeiro se a Opção contiver o valor de acordo com a equivalência fornecida; caso contrário, retornará falso.

Código

function elements_ex01() {
  const numberEquivalence = Eq.number;

  const some1 = O.some(1); // Create an Option containing the value 1
  const none = O.none(); // Create an Option representing no value

  console.log(pipe(some1, O.containsWith(numberEquivalence)(1))); // Output: true (Option contains 1)
  console.log(pipe(some1, O.containsWith(numberEquivalence)(2))); // Output: false (Option does not contain 2)
  console.log(pipe(none, O.containsWith(numberEquivalence)(1))); // Output: false (Option is None)
}

Explicação

• pipe(some1, O.containsWith(numberEquivalence)(1)): A opção contém o valor 1, e a função de equivalência personalizada confirma isso, resultando em verdadeiro.
• pipe(some1, O.containsWith(numberEquivalence)(2)): A opção não contém o valor 2, portanto o resultado é falso.
• pipe(none, O.containsWith(numberEquivalence)(1)): A opção é None, então o resultado é falso independentemente do valor verificado.

Esta função é útil quando você precisa verificar se uma Opção contém um valor específico com uma lógica de comparação personalizada, permitindo mais flexibilidade na determinação da equivalência.

Exemplo 2: Verificando Elementos com Equivalência Padrão usando O.contains

Conceito

A função O.contains verifica se uma Opção contém um valor especificado usando a equivalência padrão. Retorna verdadeiro se a Opção contiver o valor; caso contrário, retornará falso. Esta função é mais simples de usar quando você não precisa de lógica de comparação personalizada.

Código

function elements_ex02() {
  const some1 = O.some(1); // Create an Option containing the value 1
  const none = O.none(); // Create an Option representing no value

  console.log(pipe(some1, O.contains(1))); // Output: true (Option contains 1)
  console.log(pipe(some1, O.contains(2))); // Output: false (Option does not contain 2)
  console.log(pipe(none, O.contains(1))); // Output: false (Option is None)
}

Explicação

• pipe(some1, O.contains(1)): A opção contém o valor 1, então o resultado é verdadeiro.
• pipe(some1, O.contains(2)): A opção não contém o valor 2, então o resultado é falso.
• pipe(none, O.contains(1)): A opção é None, então o resultado é falso independentemente do valor verificado.

Esta função é útil para verificar rapidamente se uma Opção contém um valor específico quando a equivalência padrão é suficiente, tornando-a simples e fácil de usar.

Conclusão

Effect-TS fornece maneiras eficientes de verificar se uma opção contém um valor específico. Com O.containsWith, você pode utilizar funções de equivalência customizadas para definir como a comparação deve ser feita, oferecendo flexibilidade para cenários complexos. Enquanto isso, O.contains fornece uma abordagem mais simples, aproveitando a equivalência padrão para verificações diretas. Essas funções permitem lidar com opções de maneira eficaz, garantindo a verificação da presença de valores de maneira intuitiva e controlada.