~~Title: Efl.Loop_Consumer.future_rejected~~
====== Efl.Loop_Consumer.future_rejected ======

===== Description =====

%%Creates a new future that is already rejected to a specified error using the %%[[:develop:api:efl:loop_consumer:property:loop|Efl.Loop_Consumer.loop.get]]%%.%%

%%This function creates a new future with an already known error, that will be resolved and dispatched by the loop scheduler as usual.%%

%%This is a helper that behaves the same as @ref eina_future_rejected.%%

//Since 1.22//
{{page>:develop:api-include:efl:loop_consumer:method:future_rejected:description&nouser&nolink&nodate}}

===== Signature =====

<code>
future_rejected @const {
    params {
        @in error: Eina.Error;
    }
    return: future<Eina.Error>;
}
</code>

===== C signature =====

<code c>
Eina_Future *efl_loop_future_rejected(const Eo *obj, Eina_Error error);
</code>

===== Parameters =====

  * **error** //(in)// - %%An Eina_Error value%%

===== Implemented by =====

  * [[:develop:api:efl:loop_consumer:method:future_rejected|Efl.Loop_Consumer.future_rejected]]