Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(1138)

Unified Diff: third_party/WebKit/Source/wtf/Functional.h

Issue 2386843002: reflow comments in wtf (Closed)
Patch Set: comments (heh!) Created 4 years, 2 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: third_party/WebKit/Source/wtf/Functional.h
diff --git a/third_party/WebKit/Source/wtf/Functional.h b/third_party/WebKit/Source/wtf/Functional.h
index 84a690f42afae7d8ec0ad04465eea198717eb69c..cce5b6a9410b0e2dae7589ce8e11ade09afe8862 100644
--- a/third_party/WebKit/Source/wtf/Functional.h
+++ b/third_party/WebKit/Source/wtf/Functional.h
@@ -46,8 +46,9 @@ class WeakMember;
namespace WTF {
-// Functional.h provides a very simple way to bind a function pointer and arguments together into a function object
-// that can be stored, copied and invoked, similar to how boost::bind and std::bind in C++11.
+// Functional.h provides a very simple way to bind a function pointer and
+// arguments together into a function object that can be stored, copied and
+// invoked, similar to boost::bind and std::bind in C++11.
// Thread Safety:
//
@@ -60,28 +61,34 @@ namespace WTF {
// WTF::bind() and move semantics
// ==============================
//
-// For unbound parameters (arguments supplied later on the bound functor directly), there are two ways to pass movable
-// arguments:
+// For unbound parameters (arguments supplied later on the bound functor
+// directly), there are two ways to pass movable arguments:
//
// 1) Pass by rvalue reference.
//
// void yourFunction(Argument&& argument) { ... }
-// std::unique_ptr<Function<void(Argument&&)>> functor = bind<Argument&&>(yourFunction);
+// std::unique_ptr<Function<void(Argument&&)>> functor =
+// bind<Argument&&>(yourFunction);
//
// 2) Pass by value.
//
// void yourFunction(Argument argument) { ... }
-// std::unique_ptr<Function<void(Argument)>> functor = bind<Argument>(yourFunction);
+// std::unique_ptr<Function<void(Argument)>> functor =
+// bind<Argument>(yourFunction);
//
-// Note that with the latter there will be *two* move constructions happening, because there needs to be at least one
-// intermediary function call taking an argument of type "Argument" (i.e. passed by value). The former case does not
+// Note that with the latter there will be *two* move constructions happening,
+// because there needs to be at least one intermediary function call taking an
+// argument of type "Argument" (i.e. passed by value). The former case does not
// require any move constructions inbetween.
//
-// For bound parameters (arguments supplied on the creation of a functor), you can move your argument into the internal
-// storage of the functor by supplying an rvalue to that argument (this is done in wrap() of ParamStorageTraits).
-// However, to make the functor be able to get called multiple times, the stored object does not get moved out
-// automatically when the underlying function is actually invoked. If you want to make an argument "auto-passed",
-// you can do so by wrapping your bound argument with passed() function, as shown below:
+// For bound parameters (arguments supplied on the creation of a functor), you
+// can move your argument into the internal storage of the functor by supplying
+// an rvalue to that argument (this is done in wrap() of ParamStorageTraits).
+// However, to make the functor be able to get called multiple times, the
+// stored object does not get moved out automatically when the underlying
+// function is actually invoked. If you want to make an argument "auto-passed",
+// you can do so by wrapping your bound argument with passed() function, as
+// shown below:
//
// void yourFunction(Argument argument)
// {
@@ -90,14 +97,16 @@ namespace WTF {
// }
//
// ...
-// std::unique_ptr<Function<void()>> functor = bind(yourFunction, passed(Argument()));
+// std::unique_ptr<Function<void()>> functor = bind(yourFunction,
+// passed(Argument()));
// ...
// (*functor)();
//
-// The underlying function must receive the argument wrapped by passed() by rvalue reference or by value.
+// The underlying function must receive the argument wrapped by passed() by
+// rvalue reference or by value.
//
-// Obviously, if you create a functor this way, you shouldn't call the functor twice or more; after the second call,
-// the passed argument may be invalid.
+// Obviously, if you create a functor this way, you shouldn't call the functor
+// twice or more; after the second call, the passed argument may be invalid.
enum FunctionThreadAffinity { CrossThreadAffinity, SameThreadAffinity };
« no previous file with comments | « third_party/WebKit/Source/wtf/DynamicAnnotations.h ('k') | third_party/WebKit/Source/wtf/FunctionalTest.cpp » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698