45 lines
1.4 KiB
Markdown
45 lines
1.4 KiB
Markdown
# Symbol
|
|
|
|
## Methods
|
|
|
|
### Constructor
|
|
|
|
Instantiates a new `Napi::Symbol` value.
|
|
|
|
```cpp
|
|
Napi::Symbol::Symbol();
|
|
```
|
|
|
|
Returns a new empty `Napi::Symbol`.
|
|
|
|
### New
|
|
```cpp
|
|
Napi::Symbol::New(napi_env env, const std::string& description);
|
|
Napi::Symbol::New(napi_env env, const char* description);
|
|
Napi::Symbol::New(napi_env env, Napi::String description);
|
|
Napi::Symbol::New(napi_env env, napi_value description);
|
|
```
|
|
|
|
- `[in] env`: The `napi_env` environment in which to construct the `Napi::Symbol` object.
|
|
- `[in] value`: The C++ primitive which represents the description hint for the `Napi::Symbol`.
|
|
`description` may be any of:
|
|
- `std::string&` - ANSI string description.
|
|
- `const char*` - represents a UTF8 string description.
|
|
- `String` - Node addon API String description.
|
|
- `napi_value` - N-API `napi_value` description.
|
|
|
|
If an error occurs, a `Napi::Error` will get thrown. If C++ exceptions are not
|
|
being used, callers should check the result of `Napi::Env::IsExceptionPending` before
|
|
attempting to use the returned value.
|
|
|
|
### Utf8Value
|
|
```cpp
|
|
static Napi::Symbol Napi::Symbol::WellKnown(napi_env env, const std::string& name);
|
|
```
|
|
|
|
- `[in] env`: The `napi_env` environment in which to construct the `Napi::Symbol` object.
|
|
- `[in] name`: The C++ string representing the `Napi::Symbol` to retrieve.
|
|
|
|
Returns a `Napi::Symbol` representing a well-known `Symbol` from the
|
|
`Symbol` registry.
|