v8  10.1.124 (node 18.2.0)
V8 is Google's open source JavaScript engine
String::ExternalOneByteStringResource Class Referenceabstract

#include <v8-primitive.h>

Inheritance diagram for String::ExternalOneByteStringResource:
Collaboration diagram for String::ExternalOneByteStringResource:

Public Member Functions

 ~ExternalOneByteStringResource () override=default
 
virtual const char * data () const =0
 
virtual size_t length () const =0
 
const char * cached_data () const
 
void UpdateDataCache ()
 
- Public Member Functions inherited from String::ExternalStringResourceBase
virtual ~ExternalStringResourceBase ()=default
 
virtual bool IsCacheable () const
 
 ExternalStringResourceBase (const ExternalStringResourceBase &)=delete
 
void operator= (const ExternalStringResourceBase &)=delete
 

Protected Member Functions

 ExternalOneByteStringResource ()=default
 
- Protected Member Functions inherited from String::ExternalStringResourceBase
 ExternalStringResourceBase ()=default
 
virtual void Dispose ()
 
virtual void Lock () const
 
virtual void Unlock () const
 

Detailed Description

An ExternalOneByteStringResource is a wrapper around an one-byte string buffer that resides outside V8's heap. Implement an ExternalOneByteStringResource to manage the life cycle of the underlying buffer. Note that the string data must be immutable and that the data must be Latin-1 and not UTF-8, which would require special treatment internally in the engine and do not allow efficient indexing. Use String::New or convert to 16 bit data for non-Latin1.

Definition at line 335 of file v8-primitive.h.

Constructor & Destructor Documentation

◆ ~ExternalOneByteStringResource()

~ExternalOneByteStringResource ( )
overridedefault

Override the destructor to manage the life cycle of the underlying buffer.

◆ ExternalOneByteStringResource()

ExternalOneByteStringResource ( )
protecteddefault

Member Function Documentation

◆ cached_data()

const char* cached_data ( ) const
inline

Returns the cached data from the underlying buffer. If the resource is uncacheable or if UpdateDataCache() was not called before, it has undefined behaviour.

Definition at line 358 of file v8-primitive.h.

◆ data()

virtual const char* data ( ) const
pure virtual

The string data from the underlying buffer. If the resource is cacheable then data() must return the same value for all invocations.

◆ length()

virtual size_t length ( ) const
pure virtual

The number of Latin-1 characters in the string.

◆ UpdateDataCache()

void UpdateDataCache ( )

Update {cached_data_} with the data from the underlying buffer. This can be called only for cacheable resources.


The documentation for this class was generated from the following file: