Class: Scope
실행 컨텍스트(Execution Context)를 관리하는 클래스입니다. 변수와 함수의 저장, 검색, 수정을 담당하며, 스코프 체인을 통해 렉시컬 스코핑을 구현합니다.
Scope 인스턴스는 계층적인 구조를 가집니다. 각 스코프는 부모 스코프(parent)를 가질 수 있으며, 변수나 함수를 찾을 때 현재 스코프에 없으면 부모 스코프로 거슬러 올라가며 재귀적으로 탐색합니다. 이는 달빛 약속 언어의 클로저와 변수 유효 범위를 결정하는 핵심적인 메커니즘입니다.
Constructors
Scope()
Scope(
config):Scope
Parameters
• config = {}
• config.codeFile?: CodeFile
• config.initialVariable?: Record<string, ValueType>
• config.parent?: Scope
Returns
Defined in
Properties
codeFile?
optionalcodeFile:CodeFile
Defined in
parent
parent:
Scope
Defined in
variables
variables:
Record<string,ValueType>
Defined in
Methods
addFunctionObject()
addFunctionObject(
functionObject):void
현재 스코프에 새로운 함수(약속)를 추가합니다.
Parameters
• functionObject: RunnableObject
추가할 함수를 나타내는 RunnableObject입니다.
Returns
void
Defined in
askSetVariable()
askSetVariable(
name,value):boolean
상위 스코프로 거슬러 올라가며 변수가 존재하는지 확인하고, 존재하면 값을 설정합니다. setVariable 내부에서 호출되는 헬퍼 메서드입니다.
Parameters
• name: string
설정할 변수의 이름입니다.
• value: ValueType
변수에 할당할 값입니다.
Returns
boolean
변수를 성공적으로 설정했는지 여부를 반환합니다.
Defined in
getFunctionObject()
getFunctionObject(
name):RunnableObject
현재 스코프 또는 상위 스코프에서 함수(약속)를 찾아 반환합니다.
변수 검색과 마찬가지로, 스코프 체인을 따라 올라가며 재귀적으로 함수를 찾습니다.
Parameters
• name: string
찾을 함수의 이름입니다.
Returns
RunnableObject
함수를 나타내는 RunnableObject를 반환합니다.
Defined in
getVariable()
getVariable(
name):ValueType
현재 스코프 또는 상위 스코프에서 변수를 찾아 그 값을 반환합니다.
스코프 체인 탐색: 먼저 현재 스코프의 variables에서 변수를 찾습니다. 만약 없다면, parent 스코프의 getVariable을 재귀적으로 호출하여 스코프 체인을 따라 올라가며 변수를 찾습니다. 최상위 스코프에도 변수가 없으면 NotDefinedIdentifierError를 발생시킵니다.
Parameters
• name: string
찾을 변수의 이름입니다.
Returns
변수의 값을 담은 ValueType 객체를 반환합니다.
Defined in
setVariable()
setVariable(
name,value):void
변수를 설정합니다. 이미 상위 스코프에 변수가 존재하면 그 변수의 값을 갱신하고, 그렇지 않으면 현재 스코프에 새로운 변수를 생성합니다.
Parameters
• name: string
설정할 변수의 이름입니다.
• value: ValueType
변수에 할당할 값입니다.
Returns
void