 |
v8
3.14.5 (node 0.10.48)
V8 is Google's open source JavaScript engine
|
|
v8
3.14.5 (node 0.10.48)
V8 is Google's open source JavaScript engine
|
#include <v8.h>
Data Structures | |
| class | AsciiValue |
| class | ExternalAsciiStringResource |
| class | ExternalStringResource |
| class | ExternalStringResourceBase |
| class | Utf8Value |
| class | Value |
Public Types | |
| enum | Encoding { UNKNOWN_ENCODING = 0x1 , TWO_BYTE_ENCODING = 0x0 , ASCII_ENCODING = 0x4 } |
| enum | WriteOptions { NO_OPTIONS = 0 , HINT_MANY_WRITES_EXPECTED = 1 , NO_NULL_TERMINATION = 2 , PRESERVE_ASCII_NULL = 4 } |
Static Public Member Functions | |
| static V8EXPORT v8::Local< v8::String > | Empty () |
| static v8::Local< v8::String > | Empty (Isolate *isolate) |
| static String * | Cast (v8::Value *obj) |
| static V8EXPORT Local< String > | New (const char *data, int length=-1) |
| static V8EXPORT Local< String > | New (const uint16_t *data, int length=-1) |
| static V8EXPORT Local< String > | NewSymbol (const char *data, int length=-1) |
| static V8EXPORT Local< String > | Concat (Handle< String > left, Handle< String > right) |
| static V8EXPORT Local< String > | NewExternal (ExternalStringResource *resource) |
| static V8EXPORT Local< String > | NewExternal (ExternalAsciiStringResource *resource) |
| static V8EXPORT Local< String > | NewUndetectable (const char *data, int length=-1) |
| static V8EXPORT Local< String > | NewUndetectable (const uint16_t *data, int length=-1) |
| enum Encoding |
| enum WriteOptions |
Write the contents of the string to an external buffer. If no arguments are given, expects the buffer to be large enough to hold the entire string and NULL terminator. Copies the contents of the string and the NULL terminator into the buffer.
WriteUtf8 will not write partial UTF-8 sequences, preferring to stop before the end of the buffer.
Copies up to length characters into the output buffer. Only null-terminates if there is enough space in the buffer.
| buffer | The buffer into which the string will be copied. |
| start | The starting position within the string at which copying begins. |
| length | The number of characters to copy from the string. For WriteUtf8 the number of bytes in the buffer. |
| nchars_ref | The number of characters written, can be NULL. |
| options | Various options that might affect performance of this or subsequent operations. |
| Enumerator | |
|---|---|
| NO_OPTIONS | |
| HINT_MANY_WRITES_EXPECTED | |
| NO_NULL_TERMINATION | |
| PRESERVE_ASCII_NULL | |
| V8EXPORT bool CanMakeExternal | ( | ) |
Returns true if this string can be made external.
Creates a new string by concatenating the left and the right strings passed in as parameters.
|
static |
A zero length string.
Referenced by String::Empty().
Definition at line 4425 of file v8.h.
References String::Empty(), Internals::GetRoot(), Internals::IsInitialized(), Internals::kEmptySymbolRootIndex, and V8::Local.
| V8EXPORT const ExternalAsciiStringResource* GetExternalAsciiStringResource | ( | ) | const |
Get the ExternalAsciiStringResource for an external ASCII string. Returns NULL if IsExternalAscii() doesn't return true.
|
inline |
Get the ExternalStringResource for an external string. Returns NULL if IsExternal() doesn't return true.
Definition at line 4434 of file v8.h.
References Internals::GetInstanceType(), Internals::IsExternalTwoByteString(), Internals::kStringResourceOffset, and Internals::ReadField().
|
inline |
If the string is an external string, return the ExternalStringResourceBase regardless of the encoding, otherwise return NULL. The encoding of the string is returned in encoding_out.
Definition at line 4452 of file v8.h.
References Internals::GetInstanceType(), Internals::kExternalAsciiRepresentationTag, Internals::kExternalTwoByteRepresentationTag, Internals::kFullStringRepresentationMask, Internals::kStringEncodingMask, Internals::kStringResourceOffset, and Internals::ReadField().
| V8EXPORT bool IsExternal | ( | ) | const |
Returns true if the string is external
| V8EXPORT bool IsExternalAscii | ( | ) | const |
Returns true if the string is both external and ASCII
| V8EXPORT int Length | ( | ) | const |
Returns the number of characters in this string.
| V8EXPORT bool MakeExternal | ( | ExternalAsciiStringResource * | resource | ) |
Associate an external string resource with this string by transforming it in place so that existing references to this string in the JavaScript heap will use the external string resource. The external string resource's character contents need to be equivalent to this string. Returns true if the string has been changed to be an external string. The string is not modified if the operation fails. See NewExternal for information on the lifetime of the resource.
| V8EXPORT bool MakeExternal | ( | ExternalStringResource * | resource | ) |
Associate an external string resource with this string by transforming it in place so that existing references to this string in the JavaScript heap will use the external string resource. The external string resource's character contents need to be equivalent to this string. Returns true if the string has been changed to be an external string. The string is not modified if the operation fails. See NewExternal for information on the lifetime of the resource.
| V8EXPORT bool MayContainNonAscii | ( | ) | const |
A fast conservative check for non-ASCII characters. May return true even for ASCII strings, but if it returns false you can be sure that all characters are in the range 0-127.
Allocates a new string from either UTF-8 encoded or ASCII data. The second parameter 'length' gives the buffer length. If the data is UTF-8 encoded, the caller must be careful to supply the length parameter. If it is not given, the function calls 'strlen' to determine the buffer length, it might be wrong if 'data' contains a null character.
Referenced by Template::Set().
Allocates a new string from 16-bit character codes.
|
static |
Creates a new external string using the ASCII data defined in the given resource. When the external string is no longer live on V8's heap the resource will be disposed by calling its Dispose method. The caller of this function should not otherwise delete or modify the resource. Neither should the underlying buffer be deallocated or modified except through the destructor of the external string resource.
|
static |
Creates a new external string using the data defined in the given resource. When the external string is no longer live on V8's heap the resource will be disposed by calling its Dispose method. The caller of this function should not otherwise delete or modify the resource. Neither should the underlying buffer be deallocated or modified except through the destructor of the external string resource.
Creates a symbol. Returns one if it exists already.
Creates an undetectable string from the supplied ASCII or UTF-8 data.
Creates an undetectable string from the supplied 16-bit character codes.
| V8EXPORT int Utf8Length | ( | ) | const |
Returns the number of bytes in the UTF-8 encoded representation of this string.
| V8EXPORT int Write | ( | uint16_t * | buffer, |
| int | start = 0, |
||
| int | length = -1, |
||
| int | options = NO_OPTIONS |
||
| ) | const |
| V8EXPORT int WriteAscii | ( | char * | buffer, |
| int | start = 0, |
||
| int | length = -1, |
||
| int | options = NO_OPTIONS |
||
| ) | const |
| V8EXPORT int WriteUtf8 | ( | char * | buffer, |
| int | length = -1, |
||
| int * | nchars_ref = NULL, |
||
| int | options = NO_OPTIONS |
||
| ) | const |
1.9.1 
Public Member Functions inherited from