Skip to content

Static types useful for dispatch and generated functions.

License

Notifications You must be signed in to change notification settings

SciML/Static.jl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Static

Stable Dev Build Status Coverage

Static defines a set of types (True, False, StaticInt{value::Int}, StaticFloat64{value::Float64}, StaticSymbol{value::Symbol}) that may be dispatched on (similar to Base.Val{value}). Unlike Base.Val, instances of these types provide "static" values (meaning known at compile time) that in many cases work interchangeably with dynamic values (meaning the value is known at runtime but not compile time). This is particularly useful when designing types whose fields may be dynamically or statically known, such as a range whose size may be dynamic or statically known.

Generic conversion to static values, dynamic values, and compile time known values is accomplished with the methods static, dynamic, and known, respectively.

julia> using Static

julia> static(1)
static(1)

julia> dynamic(static(1))
1

julia> dynamic(1)
1

julia> typeof(static(1))
StaticInt{1}

julia> known(typeof(static(1)))
1

julia> known(typeof(1)) === nothing  # `Int`  has no compile time known value
true

Types, Dispatch, Compile-Time, and StaticNumbers.jl

Static.jl does not subtype the Base number types. For example, !(StaticInt <: Integer). The reason for this is that it invalidates all downstream compilation caches. This has a major effect, for example, causing LoopVectorization.jl to not precompile and ultimately giving the ODE solvers >20 second extra compile times. To avoid these invalidations, the dispatches were removed. An alternative library StaticNumbers.jl is more ergonomic but has these invalidations. Use the library that is more appropriate for your use case.

About

Static types useful for dispatch and generated functions.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Languages