Squashed 'third_party/boostorg/function/' content from commit feea196

Change-Id: Iaf916451dad887c577d5822d9cf181f90957e080
git-subtree-dir: third_party/boostorg/function
git-subtree-split: feea19660bcac246fc054f0a890415d01e884c4b
diff --git a/example/bind1st.cpp b/example/bind1st.cpp
new file mode 100644
index 0000000..b9622c7
--- /dev/null
+++ b/example/bind1st.cpp
@@ -0,0 +1,32 @@
+// Boost.Function library examples
+
+//  Copyright Douglas Gregor 2001-2003. Use, modification and
+//  distribution is subject to the Boost Software License, Version
+//  1.0. (See accompanying file LICENSE_1_0.txt or copy at
+//  http://www.boost.org/LICENSE_1_0.txt)
+
+// For more information, see http://www.boost.org
+
+#include <iostream>
+#include <boost/function.hpp>
+#include <functional>
+
+struct X {
+  X(int val) : value(val) {}
+
+  int foo(int x) { return x * value; }
+
+  int value;
+};
+
+
+int
+main()
+{
+  boost::function<int (int)> f;
+  X x(7);
+  f = std::bind1st(std::mem_fun(&X::foo), &x);
+
+  std::cout << f(5) << std::endl; // Call x.foo(5)
+  return 0;
+}