Subject: Re: [boost] [outcome] success-or-failure objects
From: Niall Douglas (s_sourceforge_at_[hidden])
Date: 2018-01-23 14:44:05
On 23/01/2018 13:52, VinÃcius dos Santos Oliveira via Boost wrote:
> I'm liking what I saw so far. Just a small comment on the documentation.
> I'm curious what the following sentence does even mean? Is it supposed to
> confuse the user or something? It's a sign of bad taste really.
>> Outcomeâs default is to not provide value-or-error objects. It provides
> success-or-failure objects.
> What does that even mean? value-or-error... well, if it is non-error, I
> assume it is success. Both sentences mean just the same. As do their API
> (encapsulate either A or B). The rest of the paragraph is okay. If you just
> remove this comment, confusion will go away. No other changes need to be
> done in this paragraph. Just remove this misleading means-nothing comment.
Literally, straight after what you quoted it says:
"Outcomeâs default is to not provide value-or-error objects. It provides
success-or-failure objects. We define the difference as being âhaving
programmable actions in response to no-value observation other than
throwing a hard coded logic error type exceptionâ."
Can you explain why this is confusing to you?
-- ned Productions Limited Consulting http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/
Boost list run by bdawes at acm.org, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk