|
1
|
## Converters
|
|
2
|
|
|
3
|
NAN contains functions that convert `v8::Value`s to other `v8::Value` types and native types. Since type conversion is not guaranteed to succeed, they return `Nan::Maybe` types. These converters can be used in place of `value->ToX()` and `value->XValue()` (where `X` is one of the types, e.g. `Boolean`) in a way that provides a consistent interface across V8 versions. Newer versions of V8 use the new `v8::Maybe` and `v8::MaybeLocal` types for these conversions, older versions don't have this functionality so it is provided by NAN.
|
|
4
|
|
|
5
|
- <a href="#api_nan_to"><b><code>Nan::To()</code></b></a>
|
|
6
|
|
|
7
|
<a name="api_nan_to"></a>
|
|
8
|
### Nan::To()
|
|
9
|
|
|
10
|
Converts a `v8::Local<v8::Value>` to a different subtype of `v8::Value` or to a native data type. Returns a `Nan::MaybeLocal<>` or a `Nan::Maybe<>` accordingly.
|
|
11
|
|
|
12
|
See [maybe_types.md](./maybe_types.md) for more information on `Nan::Maybe` types.
|
|
13
|
|
|
14
|
Signatures:
|
|
15
|
|
|
16
|
```c++
|
|
17
|
// V8 types
|
|
18
|
Nan::MaybeLocal<v8::Boolean> Nan::To<v8::Boolean>(v8::Local<v8::Value> val);
|
|
19
|
Nan::MaybeLocal<v8::Int32> Nan::To<v8::Int32>(v8::Local<v8::Value> val);
|
|
20
|
Nan::MaybeLocal<v8::Integer> Nan::To<v8::Integer>(v8::Local<v8::Value> val);
|
|
21
|
Nan::MaybeLocal<v8::Object> Nan::To<v8::Object>(v8::Local<v8::Value> val);
|
|
22
|
Nan::MaybeLocal<v8::Number> Nan::To<v8::Number>(v8::Local<v8::Value> val);
|
|
23
|
Nan::MaybeLocal<v8::String> Nan::To<v8::String>(v8::Local<v8::Value> val);
|
|
24
|
Nan::MaybeLocal<v8::Uint32> Nan::To<v8::Uint32>(v8::Local<v8::Value> val);
|
|
25
|
|
|
26
|
// Native types
|
|
27
|
Nan::Maybe<bool> Nan::To<bool>(v8::Local<v8::Value> val);
|
|
28
|
Nan::Maybe<double> Nan::To<double>(v8::Local<v8::Value> val);
|
|
29
|
Nan::Maybe<int32_t> Nan::To<int32_t>(v8::Local<v8::Value> val);
|
|
30
|
Nan::Maybe<int64_t> Nan::To<int64_t>(v8::Local<v8::Value> val);
|
|
31
|
Nan::Maybe<uint32_t> Nan::To<uint32_t>(v8::Local<v8::Value> val);
|
|
32
|
```
|
|
33
|
|
|
34
|
### Example
|
|
35
|
|
|
36
|
```c++
|
|
37
|
v8::Local<v8::Value> val;
|
|
38
|
Nan::MaybeLocal<v8::String> str = Nan::To<v8::String>(val);
|
|
39
|
Nan::Maybe<double> d = Nan::To<double>(val);
|
|
40
|
```
|
|
41
|
|