Struct UserDefinedFunction

pub struct UserDefinedFunction {
    pub name: PlSmallStr,
    pub input_fields: Vec<Field>,
    pub return_type: SpecialEq<Arc<dyn FunctionOutputField>>,
    pub fun: LazySerde<SpecialEq<Arc<dyn ColumnsUdf>>>,
    pub options: FunctionOptions,
}

Represents a user-defined function

Fields

name: PlSmallStr

name

input_fields: Vec<Field>

The function signature.

return_type: SpecialEq<Arc<dyn FunctionOutputField>>

The function output type.

fun: LazySerde<SpecialEq<Arc<dyn ColumnsUdf>>>

The function implementation.

options: FunctionOptions

Options for the function.

Implementations

impl UserDefinedFunction

pub fn new( name: PlSmallStr, input_fields: Vec<Field>, return_type: SpecialEq<Arc<dyn FunctionOutputField>>, fun: impl ColumnsUdf + 'static, ) -> UserDefinedFunction

Create a new UserDefinedFunction

pub fn call(self, args: Vec<Expr>) -> Result<Expr, PolarsError>

creates a logical expression with a call of the UDF This utility allows using the UDF without requiring access to the registry. The schema is validated and the query will fail if the schema is invalid.

pub fn call_unchecked(self, args: Vec<Expr>) -> Expr

creates a logical expression with a call of the UDF This does not do any schema validation and is therefore faster.

Only use this if you are certain that the schema is correct. If the schema is invalid, the query will fail at runtime.

Trait Implementations

impl Clone for UserDefinedFunction

fn clone(&self) -> UserDefinedFunction

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UserDefinedFunction

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.