739bee71fa
Since C++14, there is a spec'ed attribute for deprecation of methods,
functions, types, aliases or anything else.
This CL switches from the GCC __attribute__ to this standard attribute.
This allows to use the V8_DEPRECATED and V8_DEPRECATE_SOON macros on
anything where the standard attribute can be used (including {using}
statements that were not working before). It also avoids the need to
nest the whole declaration in the macro, making the code more readable.
R=adamk@chromium.org
Bug: v8:9810
Change-Id: I7adab7694af75423fb31ade2fc982dbf9c9bc699
Reviewed-on: https://chromium-review.googlesource.com/c/v8/v8/+/1847361
Reviewed-by: Adam Klein <adamk@chromium.org>
Commit-Queue: Clemens Backes <clemensb@chromium.org>
Cr-Commit-Position: refs/heads/master@{#64174}
84 lines
3.0 KiB
C++
84 lines
3.0 KiB
C++
// Copyright 2014 the V8 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.
|
|
|
|
#ifndef V8_LIBPLATFORM_LIBPLATFORM_H_
|
|
#define V8_LIBPLATFORM_LIBPLATFORM_H_
|
|
|
|
#include <memory>
|
|
|
|
#include "libplatform/libplatform-export.h"
|
|
#include "libplatform/v8-tracing.h"
|
|
#include "v8-platform.h" // NOLINT(build/include)
|
|
#include "v8config.h" // NOLINT(build/include)
|
|
|
|
namespace v8 {
|
|
namespace platform {
|
|
|
|
enum class IdleTaskSupport { kDisabled, kEnabled };
|
|
enum class InProcessStackDumping { kDisabled, kEnabled };
|
|
|
|
enum class MessageLoopBehavior : bool {
|
|
kDoNotWait = false,
|
|
kWaitForWork = true
|
|
};
|
|
|
|
/**
|
|
* Returns a new instance of the default v8::Platform implementation.
|
|
*
|
|
* The caller will take ownership of the returned pointer. |thread_pool_size|
|
|
* is the number of worker threads to allocate for background jobs. If a value
|
|
* of zero is passed, a suitable default based on the current number of
|
|
* processors online will be chosen.
|
|
* If |idle_task_support| is enabled then the platform will accept idle
|
|
* tasks (IdleTasksEnabled will return true) and will rely on the embedder
|
|
* calling v8::platform::RunIdleTasks to process the idle tasks.
|
|
* If |tracing_controller| is nullptr, the default platform will create a
|
|
* v8::platform::TracingController instance and use it.
|
|
*/
|
|
V8_PLATFORM_EXPORT std::unique_ptr<v8::Platform> NewDefaultPlatform(
|
|
int thread_pool_size = 0,
|
|
IdleTaskSupport idle_task_support = IdleTaskSupport::kDisabled,
|
|
InProcessStackDumping in_process_stack_dumping =
|
|
InProcessStackDumping::kDisabled,
|
|
std::unique_ptr<v8::TracingController> tracing_controller = {});
|
|
|
|
/**
|
|
* Pumps the message loop for the given isolate.
|
|
*
|
|
* The caller has to make sure that this is called from the right thread.
|
|
* Returns true if a task was executed, and false otherwise. Unless requested
|
|
* through the |behavior| parameter, this call does not block if no task is
|
|
* pending. The |platform| has to be created using |NewDefaultPlatform|.
|
|
*/
|
|
V8_PLATFORM_EXPORT bool PumpMessageLoop(
|
|
v8::Platform* platform, v8::Isolate* isolate,
|
|
MessageLoopBehavior behavior = MessageLoopBehavior::kDoNotWait);
|
|
|
|
/**
|
|
* Runs pending idle tasks for at most |idle_time_in_seconds| seconds.
|
|
*
|
|
* The caller has to make sure that this is called from the right thread.
|
|
* This call does not block if no task is pending. The |platform| has to be
|
|
* created using |NewDefaultPlatform|.
|
|
*/
|
|
V8_PLATFORM_EXPORT void RunIdleTasks(v8::Platform* platform,
|
|
v8::Isolate* isolate,
|
|
double idle_time_in_seconds);
|
|
|
|
/**
|
|
* Attempts to set the tracing controller for the given platform.
|
|
*
|
|
* The |platform| has to be created using |NewDefaultPlatform|.
|
|
*
|
|
*/
|
|
V8_DEPRECATE_SOON("Access the DefaultPlatform directly")
|
|
V8_PLATFORM_EXPORT void SetTracingController(
|
|
v8::Platform* platform,
|
|
v8::platform::tracing::TracingController* tracing_controller);
|
|
|
|
} // namespace platform
|
|
} // namespace v8
|
|
|
|
#endif // V8_LIBPLATFORM_LIBPLATFORM_H_
|