6776518bea
This refactoring takes a careful approach to avoid rushing the change: * stub headers are left in all the old locations of webrtc/base * existing GN targets are kept and now just forward to the moved ones using public_deps. The only exception to the above is the base_java target and its .java files, which were moved to webrtc/rtc_base right away since it's not possible to use public_deps for android_library. To avoid breaking builds, a temporary Dummy.java file was added to the new intermediate target in webrtc/rtc_base:base_java as well to avoid hitting a GN assert in the android_library template. The above approach should make the transition smooth without breaking downstream. A helper script was created (https://codereview.webrtc.org/2879203002/) and was run like this: stub-headers.py -s webrtc/base -d webrtc/rtc_base -i 7634 stub-headers.py -s webrtc/base/numerics -d webrtc/rtc_base/numerics -i 7634 Fixed invalid header guards in the following files: webrtc/base/base64.h webrtc/base/cryptstring.h webrtc/base/event.h webrtc/base/flags.h webrtc/base/httpbase.h webrtc/base/httpcommon-inl.h webrtc/base/httpcommon.h webrtc/base/httpserver.h webrtc/base/logsinks.h webrtc/base/macutils.h webrtc/base/nattypes.h webrtc/base/openssladapter.h webrtc/base/opensslstreamadapter.h webrtc/base/pathutils.h webrtc/base/physicalsocketserver.h webrtc/base/proxyinfo.h webrtc/base/sigslot.h webrtc/base/sigslotrepeater.h webrtc/base/socket.h webrtc/base/socketaddresspair.h webrtc/base/socketfactory.h webrtc/base/stringutils.h webrtc/base/testbase64.h webrtc/base/testutils.h webrtc/base/transformadapter.h webrtc/base/win32filesystem.h Added new header guards to: sslroots.h testbase64.h BUG=webrtc:7634 NOTRY=True NOPRESUBMIT=True R=kwiberg@webrtc.org Review-Url: https://codereview.webrtc.org/2877023002 . Cr-Commit-Position: refs/heads/master@{#18816}
70 lines
2.5 KiB
C
70 lines
2.5 KiB
C
/*
|
|
* Copyright 2012 The WebRTC Project Authors. All rights reserved.
|
|
*
|
|
* Use of this source code is governed by a BSD-style license
|
|
* that can be found in the LICENSE file in the root of the source
|
|
* tree. An additional intellectual property rights grant can be found
|
|
* in the file PATENTS. All contributing project authors may
|
|
* be found in the AUTHORS file in the root of the source tree.
|
|
*/
|
|
|
|
// Bind() is an overloaded function that converts method calls into function
|
|
// objects (aka functors). The method object is captured as a scoped_refptr<> if
|
|
// possible, and as a raw pointer otherwise. Any arguments to the method are
|
|
// captured by value. The return value of Bind is a stateful, nullary function
|
|
// object. Care should be taken about the lifetime of objects captured by
|
|
// Bind(); the returned functor knows nothing about the lifetime of a non
|
|
// ref-counted method object or any arguments passed by pointer, and calling the
|
|
// functor with a destroyed object will surely do bad things.
|
|
//
|
|
// To prevent the method object from being captured as a scoped_refptr<>, you
|
|
// can use Unretained. But this should only be done when absolutely necessary,
|
|
// and when the caller knows the extra reference isn't needed.
|
|
//
|
|
// Example usage:
|
|
// struct Foo {
|
|
// int Test1() { return 42; }
|
|
// int Test2() const { return 52; }
|
|
// int Test3(int x) { return x*x; }
|
|
// float Test4(int x, float y) { return x + y; }
|
|
// };
|
|
//
|
|
// int main() {
|
|
// Foo foo;
|
|
// cout << rtc::Bind(&Foo::Test1, &foo)() << endl;
|
|
// cout << rtc::Bind(&Foo::Test2, &foo)() << endl;
|
|
// cout << rtc::Bind(&Foo::Test3, &foo, 3)() << endl;
|
|
// cout << rtc::Bind(&Foo::Test4, &foo, 7, 8.5f)() << endl;
|
|
// }
|
|
//
|
|
// Example usage of ref counted objects:
|
|
// struct Bar {
|
|
// int AddRef();
|
|
// int Release();
|
|
//
|
|
// void Test() {}
|
|
// void BindThis() {
|
|
// // The functor passed to AsyncInvoke() will keep this object alive.
|
|
// invoker.AsyncInvoke(RTC_FROM_HERE,rtc::Bind(&Bar::Test, this));
|
|
// }
|
|
// };
|
|
//
|
|
// int main() {
|
|
// rtc::scoped_refptr<Bar> bar = new rtc::RefCountedObject<Bar>();
|
|
// auto functor = rtc::Bind(&Bar::Test, bar);
|
|
// bar = nullptr;
|
|
// // The functor stores an internal scoped_refptr<Bar>, so this is safe.
|
|
// functor();
|
|
// }
|
|
//
|
|
|
|
#ifndef WEBRTC_BASE_BIND_H_
|
|
#define WEBRTC_BASE_BIND_H_
|
|
|
|
|
|
// This header is deprecated and is just left here temporarily during
|
|
// refactoring. See https://bugs.webrtc.org/7634 for more details.
|
|
#include "webrtc/rtc_base/bind.h"
|
|
|
|
#endif // WEBRTC_BASE_BIND_H_
|