返回值与输出参数比较（return value or out parameter）

0.概述

函数返回处理值有两种方式，一种直接利用函数返回值返回；另一种通过输出参数返回，一般传入的值为引用或者指针。

public Foo Function1(); // 函数返回值的形式
public void Function2(Foo&); // 输出参数的形式

现比较这两种方式的区别及适用情况。

1.返回值 return value 方式

1.1 没有其他值返回时，使用返回值方式总是正确的。

这是函数返回处理后值得最常用的方式，清晰也容易理解。 不过这种方式一般情况下只能返回一个值，当需要返回多个值时，需要把返回值以“打包”的形式返回，比如数组名、指针、结构体等。

1.2 方法链调用。

当要利用返回值立即执行返回值对象的操作时。

Function1().DoSomething();

当然这种情况下只能用返回值的形式。

1.3 函数内部需要构造对象。

因为要返回 Foo 类型的变量，所以需要在函数内部构造一个 Foo 类型的对象。

Foo Function1()
{
    Foo foo; // 构造一个Foo对象
    foo.DoSomething();
    return foo;
}

2.输出参数 out paremeter 方式

2.1 多个返回值。

当需要多个返回值而又不想使用“打包”的形式，则可以使用输出参数方式操作。

public void Function2(Foo& foo, char* s); // 返回Foo类型和char*类型

2.2 out参数返回数据，函数返回值返回是否操作正确的布尔值。

这种情况使用函数返回值表示函数操作是否成功，函数操作后的数据则通过out参数返回。

bool Function2(Foo& foo)
{
    foo.DoSomething(); // 操作后结果通过out param返回
    if(foo.IsDone()) // 操作是否成功通过函数返回值返回
        return true;
    else
        return false;
}

2.3 函数内部不需要构造对象。

因为输出变量先以引用或指针形式插入函数，即在传入函数前已经创建完成，不需要在函数中再次创建一个新对象。

void Function2(Foo& foo)
{
    foo.DoSomething();
}

3.综述

3.1 一般使用情况

一般使用情况使用常规的函数返回值方式，清晰易于理解，也方便使用“方法链”调用，常规的构造所带来的资源消耗也会被编译器优化，不需要考虑。

3.2 时间效率

时间效率上，输出参数总是更快的。

int main()
{
    // New object
    Foo f1 = Function1();
    Foo f2;
    Function2( f2 );

    // Existing object
    Foo f;
    while ( x )
    {
        // Do something
        f = Function1();
        // Do something
        f.clear();
        Function2( f );
    }

    return 0;
}

上述代码中，当用来创建新的对象时，二者的时间差别可以忽略不计；当用来处理已经存在的对象时，明显输出参数的方式更快。

---

参考：
https://codeyarns.com/2010/10/21/c-return-value-versus-output-parameter/
https://stackoverflow.com/questions/810797/which-is-better-return-value-or-out-parameter
https://stackoverflow.com/questions/11212759/c-sharp-out-parameters-vs-returns