Documentation on how to use Try<T>

I’m not sure how to use it, how to create a Try, what implicitly converts to them and how exactly they work.

e.g. will this create a Try or break out of it:

                catch (Exception e)
                {
                    if (e is MailAddressException || e is MailServiceException)
                    {
                         throw e;
                    }
                }

[louthy]

@fazouane-marouane

irrelevant to the issue: @louthy Thanks for your awesome work! I’ve just discovered LanguageExt an hour ago. This project implements all the most needed/helpful paradigms seen in other systems & languages. Thanks for bringing in this into C#

Thank you, that’s very nice to hear! 😃

[louthy]

Try<T> is a delegate, so you should use it like so:

In C# 6

    Try<int> Divide(int x, int y) => () => 
        x / y;

In C# 5 or older

    Try<int> Divide(int x, int y)
    { 
        return () => x / y;
    }

Calling Divide with zero for y will return a Try<int> which when matched upon will give a Fail state, otherwise a Succ state, i.e.:

    var res = match( Divide(10,0),
                     Succ: v => v,
                     Fail: 0 );

The primary benefit is that the exception is treated as a return value like anything else, and you can chain the Trys together in a LINQ statement where an exception will cause the expression to ‘early out’

Take a look at the unit tests for more examples: https://github.com/louthy/language-ext/blob/master/LanguageExt.Tests/TryMonadTests.cs

TryOption<T> gives the 3 possible states a function can return:

• Some value
• No value (usually null is used for this)
• Exceptional value

https://github.com/louthy/language-ext/blob/master/LanguageExt.Tests/TryOptionMonadTests.cs