--- parser3/src/main/compile_tools.h	2001/03/11 08:16:34	1.27
+++ parser3/src/main/compile_tools.h	2001/07/25 11:16:57	1.44
@@ -1,30 +1,36 @@
-/*
-	Parser
+/** @file
+	Parser: compiler support helper functions decls.
+
 	Copyright (c) 2001 ArtLebedev Group (http://www.artlebedev.com)
+
 	Author: Alexander Petrosyan <paf@design.ru> (http://design.ru/paf)
 
-	$Id: compile_tools.h,v 1.27 2001/03/11 08:16:34 paf Exp $
+	$Id: compile_tools.h,v 1.44 2001/07/25 11:16:57 parser Exp $
 */
 
 #ifndef COMPILE_TOOLS
 #define COMPILE_TOOLS
 
-#include "code.h"
+#include "pa_config_includes.h"
+#include "pa_opcode.h"
 #include "pa_types.h"
 #include "pa_vstring.h"
 #include "pa_request.h"
 
 enum lexical_state {
 	LS_USER,
+	LS_COMMENT,
 	LS_DEF_NAME,
 	LS_DEF_PARAMS,
 	LS_DEF_LOCALS,
 	LS_DEF_COMMENT,
 	LS_DEF_SPECIAL_BODY,
-	LS_EXPRESSION_STRING,
+	LS_EXPRESSION_STRING_QUOTED,
+	LS_EXPRESSION_STRING_APOSTROFED,
 	LS_EXPRESSION_VAR_NAME,
 	LS_VAR_NAME_SIMPLE,
 	LS_VAR_NAME_CURLY,
+	LS_VAR_NAME_NO_COLON,
 	LS_VAR_ROUND,
 	LS_VAR_SQUARE,
 	LS_VAR_CURLY,
@@ -34,71 +40,87 @@ enum lexical_state {
 	LS_METHOD_ROUND,
 	LS_METHOD_AFTER
 };
+/// compiler status
 struct parse_control {
-	// input
+	//@{
+	/// @name input
 	Pool *pool;
 	Request *request;
-	VClass *vclass;
+	VStateless_class *cclass;
 #ifndef NO_CSTRING_ORIGIN
-	char *source;
-	char *file;
-	int line, col;
+	const char *source;
+	const char *file;
 #endif
-	// state
-	int pending_state; //=0
-	String *string; //=new(pool) String(pool)
+	int line, col;
+	//@}
+	//@{
+	/// @name state; initially
+	bool skipping_bof_empty_lines;
+	int pending_state; ///< i=0
+	String *string; ///< =new(pool) String(pool)
 	
 #define MAX_LEXICAL_STATES 100
-	enum lexical_state ls; //=LS_USER;
-	int sp; //=0
+	enum lexical_state ls; ///< =LS_USER;
+	int sp; ///< =0
 	enum lexical_state stack[MAX_LEXICAL_STATES];
-	int brackets_nestages[MAX_LEXICAL_STATES];
+	int brackets_nestages[MAX_LEXICAL_STATES]; ///< brackets nestage on each state
+	//@}
 	
-	// output: filled input 'methods' and 'error' if any
+	/// output: filled input 'methods' and 'error' if any
 	char error[MAX_STRING];
 };
 
-// New array // return empty array
-inline Array/*<op>*/ *N(Pool& pool) {
-	return new(pool) Array/*<op>*/(pool);
+/// New array // return empty array
+inline Array/*<Operation>*/ *N(Pool& pool) {
+	return new(pool) Array/*<Operation>*/(pool);
 }
 
-// Assembler instruction // append ordinary instruction to ops
-inline void O(Array/*<op>*/ *result, enum OPCODE code) {
+/// Assembler instruction // append ordinary instruction to ops
+inline void O(Array/*<Operation>*/ *result, enum OPCODE code) {
 	Operation op; op.code=code;
 	*result+=op.cast;
 }
 
-// Argument Eval_expression // append eval_expression to ops
-inline void AE(Array/*<op>*/ *result, char *eval_expression) {
+/// Argument Eval_expression // append eval_expression to ops
+inline void AE(Array/*<Operation>*/ *result, char *eval_expression) {
 	*result+=eval_expression;
 }
 
-// aPpend 'code_array' to 'result'
-inline void P(Array/*<op>*/ *result, Array *code_array) {
+/// aPpend 'code_array' to 'result'
+inline void P(Array/*<Operation>*/ *result, Array *code_array) {
 	result->append_array(*code_array);
 }
-// aPpend part of 'code_array', starting from offset, to 'result'
-inline void P(Array/*<op>*/ *result, Array *code_array, int offset) {
+/// aPpend part of 'code_array', starting from offset, to 'result'
+inline void P(Array/*<Operation>*/ *result, Array *code_array, int offset) {
 	result->append_array(*code_array, offset);
 }
-// aPpend 'vstring' to 'result'
-void PV(Array/*<op>*/ *result, VString *vstring);
-// aPpend 'Code_Array' to result
-void PCA(Array/*<op>*/ *result, Array/*<op>*/ *code_array);
-
-
-// Value Literal // returns array with 
-// first: OP_VALUE instruction
-// second op: string itself
+/// aPpend 'vstring' to 'result'
+void PV(Array/*<Operation>*/ *result, VString *vstring);
+/// Parameter 'simple Code_Array'
+void PCA(Array/*<Operation>*/ *result, Array/*<Operation>*/ *code_array);
+/// Parameter 'Expression code_Array'
+void PEA(Array/*<Operation>*/ *result, Array/*<Operation>*/ *code_array);
+/// Construct 'simple Code_Array'
+void CCA(Array/*<Operation>*/ *result, Array/*<Operation>*/ *code_array);
+
+/**
+	Value Literal // returns array with 
+	- first: OP_VALUE instruction
+	- second op: string itself
+*/
 Array *VL(Value *value);
-// Literal Array to(2) String // return string value from literal array OP+string array
-const String *SLA2S(Array *literal_string_array, int offset=0);
-
+/// Literal Array to(2) Value @return Value from literal Array OP+Value
+Value *LA2V(Array *literal_string_array, int offset=0);
+/// Literal Array to(2) String  @return String value from literal Array OP+String array
+inline const String *LA2S(Array *literal_string_array, int offset=0) {
+	if(Value *value=LA2V(literal_string_array, offset))
+		return value->get_string();
+	return 0;
+}
 void change_string_literal_to_double_literal(Array *literal_string_array);
 void change_string_literal_to_write_string_literal(Array *literal_string_array);
 
-void push_LS(struct parse_control *pc, lexical_state new_state);
-void pop_LS(struct parse_control *pc);
+void push_LS(parse_control& pc, lexical_state new_state);
+void pop_LS(parse_control& pc);
 
 #endif