15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$ This is a pump file for generating file templates.  Pump is a python
25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$ script that is part of the Google Test suite of utilities.  Description
35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$ can be found here:
45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$
55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$ http://code.google.com/p/googletest/wiki/PumpManual
65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$
75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$$ See comment for MAX_ARITY in base/bind.h.pump.
95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$var MAX_ARITY = 7
105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved.
125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be
135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file.
145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
155d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#ifndef MEDIA_BASE_BIND_TO_CURRENT_LOOP_H_
165d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#define MEDIA_BASE_BIND_TO_CURRENT_LOOP_H_
175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/bind.h"
195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/location.h"
20868fa2fe829687343ffae624259930155e16dbd8Torne (Richard Coles)#include "base/message_loop/message_loop_proxy.h"
215d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#include "base/single_thread_task_runner.h"
225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
235d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// This is a helper utility for base::Bind()ing callbacks to the current
245d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// MessageLoop. The typical use is when |a| (of class |A|) wants to hand a
255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// callback such as base::Bind(&A::AMethod, a) to |b|, but needs to ensure that
265d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// when |b| executes the callback, it does so on |a|'s current MessageLoop.
275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Typical usage: request to be called back on the current thread:
295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// other->StartAsyncProcessAndCallMeBack(
305d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)//    media::BindToCurrentLoop(base::Bind(&MyClass::MyMethod, this)));
315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)//
325d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// Note that like base::Bind(), BindToCurrentLoop() can't bind non-constant
335d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// references, and that *unlike* base::Bind(), BindToCurrentLoop() makes copies
345d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)// of its arguments, and thus can't be used with arrays.
355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace media {
375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Mimic base::internal::CallbackForward, replacing p.Pass() with
395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// base::Passed(&p) to account for the extra layer of indirection.
405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace internal {
415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template <typename T>
425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)T& TrampolineForward(T& t) { return t; }
435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template <typename T, typename R>
45a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)base::internal::PassedWrapper<scoped_ptr<T, R> > TrampolineForward(
46a1401311d1ab56c4ed0a474bd38c108f75cb0cd9Torne (Richard Coles)    scoped_ptr<T, R>& p) { return base::Passed(&p); }
475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template <typename T>
495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)base::internal::PassedWrapper<ScopedVector<T> > TrampolineForward(
505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)    ScopedVector<T>& p) { return base::Passed(&p); }
515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template <typename T> struct TrampolineHelper;
535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$range ARITY 0..MAX_ARITY
555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$for ARITY [[
565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$range ARG 1..ARITY
575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template <$for ARG , [[typename A$(ARG)]]>
595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)struct TrampolineHelper<void($for ARG , [[A$(ARG)]])> {
605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  static void Run(
615d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)      const scoped_refptr<base::SingleThreadTaskRunner>& task_runner,
625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)      const base::Callback<void($for ARG , [[A$(ARG)]])>& cb
635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$if ARITY != 0 [[, ]]
645821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$for ARG , [[A$(ARG) a$(ARG)]]
655821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)) {
665d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)    task_runner->PostTask(FROM_HERE, base::Bind(cb
675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$if ARITY != 0 [[, ]]
685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)$for ARG , [[internal::TrampolineForward(a$(ARG))]]));
695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)  }
705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)};
715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)]]  $$ for ARITY
745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
755821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace internal
765821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)template<typename T>
782a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)static base::Callback<T> BindToCurrentLoop(
792a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)    const base::Callback<T>& cb) {
805d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)  return base::Bind(&internal::TrampolineHelper<T>::Run,
815d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)                    base::MessageLoopProxy::current(), cb);
822a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)}
832a99a7e74a7f215066514fe81d2bfa6639d9edddTorne (Richard Coles)
845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}  // namespace media
855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)
865d1f7b1de12d16ceb2c938c56701a3e8bfa558f7Torne (Richard Coles)#endif  // MEDIA_BASE_BIND_TO_CURRENT_LOOP_H_
87