# setFailure

Set the current state of a RefResult to Failure(error).

## Signatures

```ts
export declare const setFailure: {
    <ResultE>(error: ResultE): <A, Err, R>(ref: RefResult<A, ResultE, Err, R>) => Effect.Effect<Result.Result<A, ResultE>, Err, R>;
    <A, ResultE, Err, R>(ref: RefResult<A, ResultE, Err, R>, error: ResultE): Effect.Effect<Result.Result<A, ResultE>, Err, R>;
};
```

## Why

Keeps set failure atomic with respect to competing RefSubject writes instead of splitting the
read and replacement into separate effects.

## Ownership and lifetime

Running set failure performs one serialized result transition and resolves with its committed
value. It acquires no resource; failures and services remain those of the source ref.