docs/book/src/basics/methods_and_associated_functions.md
Methods are similar to functions in that we declare them with the fn keyword and they have parameters and return a value. However, unlike functions, Methods are defined within the context of a struct (or enum), and either refers to that type or mutates it. The first parameter of a method is always self, which represents the instance of the struct (or enum) the method is being called on.
Associated functions are very similar to methods, in that they are also defined in the context of a struct or enum, but they do not actually use any of the data in the struct and as a result do not take self as a parameter. Associated functions could be standalone functions, but they are included in a specific type for organizational or semantic reasons.
Constructors are associated functions that construct, or in other words instantiate, new instances of a type. Their return type is always the type itself. E.g., public structs that have private fields must provide a public constructor, or otherwise they cannot be instantiated outside of the module in which they are declared.
To declare methods and associated functions for a struct or enum, use an impl block. Here, impl is short for implementation.
{{#include ../../../../examples/methods_and_associated_functions/src/main.sw}}
To call a method, simply use dot syntax: foo.iz_baz_true().
Similarly to free functions, methods and associated functions may accept ref mut parameters.
For example:
{{#include ../../../../examples/ref_mut_params/src/main.sw:move_right}}
and when called:
{{#include ../../../../examples/ref_mut_params/src/main.sw:call_move_right}}