OOJSFunction Class Reference

#include <OOJSFunction.h>

Inheritance diagram for OOJSFunction:

Collaboration diagram for OOJSFunction:

Instance Methods
(id)	- initWithFunction:context:
(id)	- initWithName:scope:code:argumentCount:argumentNames:fileName:lineNumber:context:
(NSString *)	- name
(JSFunction *)	- function
(jsval)	- functionValue
(BOOL)	- evaluateWithContext:scope:argc:argv:result:
(id)	- evaluateWithContext:scope:arguments:
(BOOL)	- evaluatePredicateWithContext:scope:arguments:
(void)	- deleteJSValue [implementation]
(void)	- dealloc [implementation]
(NSString *)	- descriptionComponents [implementation]
(BOOL)	- evaluateWithContext:scope:arguments:result: [implementation]

Private Attributes
JSFunction *	_function
NSString *	_name

Detailed Description

Definition at line 33 of file OOJSFunction.h.

Method Documentation

dealloc

- (void) dealloc

implementation

Definition at line 1 of file OOJSFunction.m.

{
    [self deleteJSValue];
    DESTROY(_name);
    
    [super dealloc];
}

References _function, _name, nil, OOJSAddGCObjectRoot, and OOJavaScriptEngine::sharedEngine.

Here is the call graph for this function:

deleteJSValue

- (void) deleteJSValue

implementation

Definition at line 1 of file OOJSFunction.m.

{
    if (_function != NULL)
    {
        JSContext *context = OOJSAcquireContext();
        JS_RemoveObjectRoot(context, (JSObject **)&_function);
        OOJSRelinquishContext(context);
        
        _function = NULL;
        [[NSNotificationCenter defaultCenter] removeObserver:self
                                                        name:kOOJavaScriptEngineWillResetNotification
                                                      object:[OOJavaScriptEngine sharedEngine]];
    }
}

descriptionComponents

- (NSString *) descriptionComponents

implementation

Definition at line 1 of file OOJSFunction.m.

{
    NSString *name = [self name];
    if (name == nil)  name = @"<anonymous>";
    return [NSString stringWithFormat:@"%@()", name];
}

evaluatePredicateWithContext:scope:arguments:

- (BOOL) evaluatePredicateWithContext:		(JSContext *)	context
scope:		(id)	jsThis
arguments:		(NSArray *)	arguments

Definition at line 1 of file OOJSFunction.m.

                                     :(JSContext *)context
                                scope:(id)jsThis
                            arguments:(NSArray *)arguments
{
    jsval result;
    BOOL OK = [self evaluateWithContext:context
                                  scope:jsThis
                              arguments:arguments
                                 result:&result];
    JSBool retval = NO;
    if (OK)  OK = JS_ValueToBoolean(context, result, &retval);
    return OK && retval;
}

evaluateWithContext:scope:argc:argv:result:

- (BOOL) evaluateWithContext:		(JSContext *)	context
scope:		(JSObject *)	jsThis
argc:		(uintN)	argc
argv:		(jsval *)	argv
result:		(jsval *)	result

Definition at line 1 of file OOJSFunction.m.

                            :(JSContext *)context
                       scope:(JSObject *)jsThis
                        argc:(uintN)argc
                        argv:(jsval *)argv
                      result:(jsval *)result
{
    [OOJSScript pushScript:nil];
    OOJSStartTimeLimiter();
    BOOL OK = JS_CallFunction(context, jsThis, _function, argc, argv, result);
    OOJSStopTimeLimiter();
    [OOJSScript popScript:nil];
    
    return OK;
}

evaluateWithContext:scope:arguments:

- (id) evaluateWithContext:		(JSContext *)	context
scope:		(id)	jsThis
arguments:		(NSArray *)	arguments

Definition at line 1 of file OOJSFunction.m.

                          :(JSContext *)context
                     scope:(id)jsThis
                 arguments:(NSArray *)arguments
{
    jsval result;
    BOOL OK = [self evaluateWithContext:context
                                  scope:jsThis
                              arguments:arguments
                                 result:&result];
    if (!OK)  return nil;
    
    return OOJSNativeObjectFromJSValue(context, result);
}

evaluateWithContext:scope:arguments:result:

- (BOOL) evaluateWithContext: (JSContext *) context scope: (id) jsThis arguments: (NSArray *) arguments result: (jsval *) result

implementation

Definition at line 1 of file OOJSFunction.m.

                            :(JSContext *)context
                       scope:(id)jsThis
                   arguments:(NSArray *)arguments
                      result:(jsval *)result
{
    NSUInteger i, argc = [arguments count];
    assert(argc < UINT32_MAX);
    jsval argv[argc];
    
    for (i = 0; i < argc; i++)
    {
        argv[i] = [[arguments objectAtIndex:i] oo_jsValueInContext:context];
        OOJSAddGCValueRoot(context, &argv[i], "OOJSFunction argv");
    }
    
    JSObject *scopeObj = NULL;
    BOOL OK = YES;
    if (jsThis != nil)  OK = JS_ValueToObject(context, [jsThis oo_jsValueInContext:context], &scopeObj);
    if (OK)  OK = [self evaluateWithContext:context
                                      scope:scopeObj
                                       argc:(uint32_t)argc
                                       argv:argv
                                     result:result];
    
    for (i = 0; i < argc; i++)
    {
        JS_RemoveValueRoot(context, &argv[i]);
    }
    
    return OK;
}

function

- (JSFunction *) function

Definition at line 1 of file OOJSFunction.m.

{
    return _function;
}

functionValue

- (jsval) functionValue

Definition at line 1 of file OOJSFunction.m.

{
    if (EXPECT(_function != NULL))
    {
        return OBJECT_TO_JSVAL(JS_GetFunctionObject(_function));
    }
    else
    {
        return JSVAL_NULL;
    }
 
}

initWithFunction:context:

- (id) initWithFunction:		(JSFunction *)	function
context:		(JSContext *)	context

Definition at line 1 of file OOJSFunction.m.

                       :(JSFunction *)function context:(JSContext *)context
{
    NSParameterAssert(context != NULL);
    
    if (function == NULL)
    {
        [self release];
        return nil;
    }
    
    if ((self = [super init]))
    {
        _function = function;
        OOJSAddGCObjectRoot(context, (JSObject **)&_function, "OOJSFunction._function");
        _name = [OOStringFromJSString(context, JS_GetFunctionId(function)) retain];
        
        [[NSNotificationCenter defaultCenter] addObserver:self
                                                 selector:@selector(deleteJSValue)
                                                     name:kOOJavaScriptEngineWillResetNotification
                                                   object:[OOJavaScriptEngine sharedEngine]];
    }
    
    return self;
}

initWithName:scope:code:argumentCount:argumentNames:fileName:lineNumber:context:

- (id) initWithName:		(NSString *)	name
scope:		(JSObject *)	scope
code:		(NSString *)	code
argumentCount:		(NSUInteger)	argCount
argumentNames:		(const char **)	argNames
fileName:		(NSString *)	fileName
lineNumber:		(NSUInteger)	lineNumber
context:		(JSContext *)	context

Definition at line 1 of file OOJSFunction.m.

                   :(NSString *)name
              scope:(JSObject *)scope
               code:(NSString *)code
      argumentCount:(NSUInteger)argCount
      argumentNames:(const char **)argNames
           fileName:(NSString *)fileName
         lineNumber:(NSUInteger)lineNumber
            context:(JSContext *)context
{
    BOOL                        OK = YES;
    BOOL                        releaseContext = NO;
    jschar                      *buffer = NULL;
    size_t                      length = 0;
    JSFunction                  *function;
    
    if (context == NULL)
    {
        context = OOJSAcquireContext();
        releaseContext = YES;
    }
    if (scope == NULL)  scope = [[OOJavaScriptEngine sharedEngine] globalObject];
    
    if (code == nil || (argCount > 0 && argNames == NULL))  OK = NO;
    
    if (OK)
    {
        // jschar and unichar are both defined to be 16-bit elements.
        assert(sizeof(jschar) == sizeof(unichar));
        
        length = [code length];
        buffer = malloc(sizeof(jschar) * length);
        if (buffer == NULL)  OK = NO;
    }
    
    if (OK)
    {
        assert(argCount < UINT32_MAX);
        
        [code getCharacters:buffer];
        
        function = JS_CompileUCFunction(context, scope, [name UTF8String], (uint32_t)argCount, argNames, buffer, length, [fileName UTF8String], (uint32_t)lineNumber);
        if (function == NULL)  OK = NO;
        
        free(buffer);
    }
    
    if (OK)
    {
        self = [self initWithFunction:function context:context];
    }
    else
    {
        DESTROY(self);
    }
    
    if (releaseContext)  OOJSRelinquishContext(context);
    
    return self;
}

name

- (NSString *) name

Definition at line 1 of file OOJSFunction.m.

{
    return _name;
}

Member Data Documentation

_function

- (JSFunction*) _function

private

Definition at line 36 of file OOJSFunction.h.

Referenced by dealloc.

_name

- (NSString*) _name

private

Definition at line 37 of file OOJSFunction.h.

Referenced by dealloc.

---

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

• src/Core/Scripting/OOJSFunction.h
• src/Core/Scripting/OOJSFunction.m