parser3/src/classes/string.C - diff

Return to string.C CVS log

Up to [parser3project] / parser3 / src / classes

Diff for /parser3/src/classes/string.C between versions 1.166 and 1.232

version 1.166, 2008/07/18 09:12:17	version 1.232, 2016/10/26 15:44:49
Line 1	Line 1
/** @file	/** @file
Parser: @b string parser class.	Parser: @b string parser class.

Copyright (c) 2001-2005 ArtLebedev Group (http://www.artlebedev.com)	Copyright (c) 2001-2015 Art. Lebedev Studio (http://www.artlebedev.com)
Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
*/	*/

static const char * const IDENT_STRING_C="$Date$";

#include "classes.h"	#include "classes.h"
#include "pa_vmethod_frame.h"	#include "pa_vmethod_frame.h"

Line 19 static const char * const IDENT_STRING_C	Line 17 static const char * const IDENT_STRING_C
#include "pa_sql_connection.h"	#include "pa_sql_connection.h"
#include "pa_dictionary.h"	#include "pa_dictionary.h"
#include "pa_vmethod_frame.h"	#include "pa_vmethod_frame.h"
	#include "pa_vregex.h"
	#include "pa_charsets.h"

	volatile const char * IDENT_STRING_C="$Id$";

// class	// class

class MString: public Methoded {	class MString: public Methoded {
public:	public:
MString();	MString();
public: // Methoded
bool used_directly() { return true; }
};	};

// global variable	// global variable

DECLARE_CLASS_VAR(string, new MString, 0);	DECLARE_CLASS_VAR(string, new MString);

	// void class, inherited from string and thus should be inited afterwards

	class MVoid: public Methoded {
	public:
	MVoid();
	};

	// void global variable should be after string global variable

	DECLARE_CLASS_VAR(void, new MVoid);

// defines for statics	// defines for statics

Line 40 DECLARE_CLASS_VAR(string, new MString, 0	Line 51 DECLARE_CLASS_VAR(string, new MString, 0
#define TRIM_END_OPTION "right"	#define TRIM_END_OPTION "right"
#define TRIM_BOTH_OPTION "both"	#define TRIM_BOTH_OPTION "both"

	#define MODE_APPEND "append"

	#define UNESCAPE_MODE_JS "js"
	#define UNESCAPE_MODE_URI "uri"

// statics	// statics

static const String match_var_name(MATCH_VAR_NAME);	static const String match_var_name(MATCH_VAR_NAME);
Line 54 static void _length(Request& r, MethodPa	Line 70 static void _length(Request& r, MethodPa
static void _int(Request& r, MethodParams& params) {	static void _int(Request& r, MethodParams& params) {
const String& self_string=GET_SELF(r, VString).string();	const String& self_string=GET_SELF(r, VString).string();
int converted;	int converted;
try {
if(self_string.is_empty())	if(self_string.is_empty()) {
throw Exception(PARSER_RUNTIME,
0,
"parameter is empty string, error converting");
converted=self_string.as_int();
} catch(...) { // convert problem
if(params.count()>0)	if(params.count()>0)
converted=params.as_int(0, "default must be int", r); // (default)	converted=params.as_int(0, "default must be int", r); // (default)
else	else
rethrow; // we have a problem when no default	throw Exception(PARSER_RUNTIME, 0, "unable to convert empty string without default specified");
	} else {
	try {
	converted=self_string.as_int();
	} catch(...) { // convert problem
	if(params.count()>0)
	converted=params.as_int(0, "default must be int", r); // (default)
	else
	rethrow; // we have a problem when no default
	}
}	}

r.write_no_lang(*new VInt(converted));	r.write_no_lang(*new VInt(converted));
}	}

static void _double(Request& r, MethodParams& params) {	static void _double(Request& r, MethodParams& params) {
const String& self_string=GET_SELF(r, VString).string();	const String& self_string=GET_SELF(r, VString).string();
double converted;
try {	if(self_string.is_empty()) {
if(self_string.is_empty())
throw Exception(PARSER_RUNTIME,
0,
"parameter is empty string, error converting");
converted=self_string.as_double();
} catch(...) { // convert problem
if(params.count()>0)	if(params.count()>0)
converted=params.as_double(0, "default must be double", r); // (default)	r.write_no_lang(*new VDouble(params.as_double(0, "default must be double", r))); // (default)
else	else
rethrow; // we have a problem when no default	throw Exception(PARSER_RUNTIME, 0, "unable to convert empty string without default specified");
	} else {
	try {
	r.write_no_lang(*new VDouble(self_string.as_double()));
	} catch(...) { // convert problem
	if(params.count()>0)
	r.write_no_lang(*new VDouble(params.as_double(0, "default must be double", r))); // (default)
	else
	rethrow; // we have a problem when no default
	}
}	}

r.write_no_lang(*new VDouble(converted));
}	}

static void _bool(Request& r, MethodParams& params) {	static void _bool(Request& r, MethodParams& params) {
const String& self_string=GET_SELF(r, VString).string();	const String& self_string=GET_SELF(r, VString).string();
bool converted;	bool converted;
try {	const char *str=self_string.cstr();
if(self_string.is_empty())
throw Exception(PARSER_RUNTIME,	if(self_string.is_empty()) {
0,
"parameter is empty string, error converting");

try {
converted=self_string.as_bool();
} catch(...) {
const String& lower_string=self_string.change_case(r.charsets.source(), String::CC_LOWER);
if(lower_string == "true"){
converted=true;
} else if (lower_string == "false"){
converted=false;
} else {
rethrow;
}
}
} catch(...) { // convert problem
if(params.count()>0)	if(params.count()>0)
converted=params.as_bool(0, "default must be bool", r); // (default)	converted=params.as_bool(0, "default must be bool", r); // (default)
else	else
rethrow; // we have a problem when no default	throw Exception(PARSER_RUNTIME, 0, "unable to convert empty string without default specified");
	} else if( (str[0]=='T' \|\| str[0]=='t') && (str[1]=='R' \|\| str[1]=='r') && (str[2]=='U' \|\| str[2]=='u') &&
	(str[3]=='E' \|\| str[3]=='e') && str[4]==0 ) { // "true"
	converted=true;
	} else if( (str[0]=='F' \|\| str[0]=='f') && (str[1]=='A' \|\| str[1]=='a') && (str[2]=='L' \|\| str[2]=='l') &&
	(str[3]=='S' \|\| str[3]=='s') && (str[4]=='E' \|\| str[4]=='e') && str[5]==0 ) { // "false"
	converted=false;
	} else {
	try {
	converted=self_string.as_bool();
	} catch(...) { // convert problem
	if(params.count()>0)
	converted=params.as_bool(0, "default must be bool", r); // (default)
	else
	rethrow; // we have a problem when no default
	}
}	}

r.write_no_lang(*new VBool(converted));	r.write_no_lang(VBool::get(converted));
}	}

/not static/void _string_format(Request& r, MethodParams& params) {	/not static/void _string_format(Request& r, MethodParams& params) {
Line 132 static void _bool(Request& r, MethodPara	Line 153 static void _bool(Request& r, MethodPara

static void _left(Request& r, MethodParams& params) {	static void _left(Request& r, MethodParams& params) {
ssize_t sn=params.as_int(0, "n must be int", r);	ssize_t sn=params.as_int(0, "n must be int", r);
if(sn<0)
throw Exception(PARSER_RUNTIME,
0,
"n(%d) must be >=0", sn);
size_t n=(size_t)sn;

const String& string=GET_SELF(r, VString).string();	const String& string=GET_SELF(r, VString).string();
r.write_assign_lang(string.mid(r.charsets.source(), 0, n));	r.write_pass_lang(sn<0 ? string : string.mid(r.charsets.source(), 0, (size_t)sn));
}	}

static void _right(Request& r, MethodParams& params) {	static void _right(Request& r, MethodParams& params) {
ssize_t sn=(size_t)params.as_int(0, "n must be int", r);	ssize_t sn=params.as_int(0, "n must be int", r);
if(sn<0)	if(sn>0){
throw Exception(PARSER_RUNTIME,	size_t n=(size_t)sn;
0,	const String& string=GET_SELF(r, VString).string();
"n(%d) must be >=0", sn);	size_t length=string.length(r.charsets.source());
size_t n=(size_t)sn;	r.write_pass_lang(n<length ? string.mid(r.charsets.source(), length-n, length, length) : string);
	}
const String& string=GET_SELF(r, VString).string();
size_t length=string.length(r.charsets.source());
r.write_assign_lang(n<length?string.mid(r.charsets.source(), length-n, length, length):string);
}	}

static void _mid(Request& r, MethodParams& params) {	static void _mid(Request& r, MethodParams& params) {
Line 179 static void _mid(Request& r, MethodParam	Line 191 static void _mid(Request& r, MethodParam
end=length;	end=length;
}	}

r.write_assign_lang(string.mid(r.charsets.source(), begin, end, length));	r.write_pass_lang(string.mid(r.charsets.source(), begin, end, length));
}	}

static void _pos(Request& r, MethodParams& params) {	static void _pos(Request& r, MethodParams& params) {
Line 190 static void _pos(Request& r, MethodParam	Line 202 static void _pos(Request& r, MethodParam
if(params.count()>1){	if(params.count()>1){
offset=params.as_int(1, "n must be int", r);	offset=params.as_int(1, "n must be int", r);
if(offset<0)	if(offset<0)
throw Exception(PARSER_RUNTIME,	throw Exception(PARSER_RUNTIME, 0, "n(%d) must be >=0", offset);
0,
"n(%d) must be >=0", offset);
}	}

r.write_no_lang(*new VInt((int)string.pos(r.charsets.source(), substr.as_string(), (size_t)offset)));	r.write_no_lang(*new VInt((int)string.pos(r.charsets.source(), substr.as_string(), (size_t)offset)));
}	}

static void split_list(MethodParams& params, int paramIndex,	static void split_list(MethodParams& params, int paramIndex, const String& string, ArrayString& result) {
const String& string,
ArrayString& result) {
Value& delim_value=params.as_no_junction(paramIndex, "delimiter must not be code");	Value& delim_value=params.as_no_junction(paramIndex, "delimiter must not be code");
	string.split(result, 0, delim_value.as_string());
size_t pos_after=0;
string.split(result, pos_after, delim_value.as_string());
}	}

#define SPLIT_LEFT 0x0001	#define SPLIT_LEFT 0x0001
Line 283 static Table& split_horizontal(ArrayStri	Line 289 static Table& split_horizontal(ArrayStri
static void split_with_options(Request& r, MethodParams& params,	static void split_with_options(Request& r, MethodParams& params,
int bits) {	int bits) {
const String& string=GET_SELF(r, VString).string();	const String& string=GET_SELF(r, VString).string();
	size_t params_count=params.count();

ArrayString pieces;	ArrayString pieces;
split_list(params, 0, string, pieces);	split_list(params, 0, string, pieces);

if(!bits) {	if(!bits) {
const String* options=0;	const String* options=0;
if(params.count()>1)	if(params_count>1)
options=&params.as_string(1, "options must not be code");	options=&params.as_string(1, OPTIONS_MUST_NOT_BE_CODE);

bits=split_options(options);	bits=split_options(options);
}	}
Line 299 static void split_with_options(Request&	Line 306 static void split_with_options(Request&
bool horizontal=(bits & SPLIT_HORIZONTAL) !=0;	bool horizontal=(bits & SPLIT_HORIZONTAL) !=0;

const String* column_name=0;	const String* column_name=0;
if(params.count()>2){	if(params_count>2){
column_name=&params.as_string(2, COLUMN_NAME_MUST_BE_STRING);	column_name=&params.as_string(2, COLUMN_NAME_MUST_BE_STRING);
if (horizontal && column_name->length())	if (horizontal && !column_name->is_empty())
throw Exception(PARSER_RUNTIME,	throw Exception(PARSER_RUNTIME,
column_name,	column_name,
"column name can't be specified with horisontal split");	"column name can't be specified with horisontal split");
}	}
if(!column_name \|\| !column_name->length())	if(!column_name \|\| column_name->is_empty())
column_name=new String("piece");	column_name=new String("piece");

Table& table=horizontal?split_horizontal(pieces, right):split_vertical(pieces, right, column_name);	Table& table=horizontal?split_horizontal(pieces, right):split_vertical(pieces, right, column_name);
Line 330 static void search_action(Table& table,	Line 337 static void search_action(Table& table,

#ifndef DOXYGEN	#ifndef DOXYGEN
struct Replace_action_info {	struct Replace_action_info {
Request* request;	Request* request;
const String* src; String* dest;	const String* src;
	String* dest;
VTable* vtable;	VTable* vtable;
Value* replacement_code;	Value* replacement_code;
};	};
#endif	#endif
/// @todo they can do $global[$result] there, getting pointer to later-invalid local var, kill this	/// @todo they can do $global[$result] there, getting pointer to later-invalid local var, kill this
static void replace_action(Table& table, ArrayString* row,	static void replace_action(Table& table, ArrayString* row,
int prestart, int prefinish,	int prestart, int prefinish,
int poststart, int postfinish,	int poststart, int postfinish,
void *info) {	void *info) {
Replace_action_info& ai=static_cast<Replace_action_info >(info);	Replace_action_info& ai=static_cast<Replace_action_info >(info);
if(row) { // begin&middle	if(row) { // begin&middle
// piece from last match['prestart'] to beginning of this match['prefinish']	// piece from last match['prestart'] to beginning of this match['prefinish']
Line 351 static void replace_action(Table& table,	Line 359 static void replace_action(Table& table,
table.put(0, row);	table.put(0, row);
else // begin	else // begin
table+=row;	table+=row;
{ // execute 'replacement_code' in 'table' context
ai.vtable->set_table(table);

ai.dest << ai.request->process_to_string(ai.replacement_code);	{ // execute 'replacement_code' in 'table' context
	if(ai.replacement_code){
	ai.vtable->set_table(table);
	ai.dest << ai.request->process_to_string(ai.replacement_code);
	}
}	}
} else // end	} else // end
*ai.dest << ai.src->mid(poststart, postfinish);	*ai.dest << ai.src->mid(poststart, postfinish);
}	}

/// @todo use pcre:study somehow
static void _match(Request& r, MethodParams& params) {	static void _match(Request& r, MethodParams& params) {
	size_t params_count=params.count();

Value& regexp=params.as_no_junction(0, "regexp must not be code");	Value& regexp=params.as_no_junction(0, "regexp must not be code");
	Value* options=(params_count>1)?&params.as_no_junction(1, OPTIONS_MUST_NOT_BE_CODE):0;

const String* options=	VRegex* vregex;
params.count()>1?	VRegexCleaner vrcleaner;
&params.as_no_junction(1, "options must not be code").as_string():0;
	if(Value* value=regexp.as(VREGEX_TYPE)){
	if(options && options->is_defined())
	throw Exception(PARSER_RUNTIME,
	0,
	"you can not specify regex-object and options together"
	);
	vregex=static_cast<VRegex*>(value);
	} else {
	vregex=new VRegex(r.charsets.source(),
	&regexp.as_string(),
	(options)?(&options->as_string()):0);
	vregex->study();
	vrcleaner.vregex=vregex;
	}

Temp_lang temp_lang(r, String::L_PASS_APPENDED);
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();
int matches_count=0;	int matches_count=0;
if(params.count()<3) { // search
Table* table=src.match(r.charsets.source(),	if(params_count<3) { // search
regexp.as_string(), options,	Table* table=src.match(vregex,
search_action, 0,	search_action, 0,
matches_count);	matches_count);
// r.write_assign_lang(*new VTable(table));
if(table){	if(table){
r.write_assign_lang(*new VTable(table));	r.write_no_lang(*new VTable(table));
} else {	} else {
r.write_assign_lang(*new VInt(matches_count));	r.write_no_lang(*new VInt(matches_count));
}	}

} else { // replace	} else { // replace
Value& replacement_code=params.as_junction(2, "replacement param must be code");
	Value* replacement_code=0;
	bool is_junction=false;

	Value* replacement=&params[2];
	if(replacement->get_junction()){
	replacement_code=replacement;
	is_junction=true;
	} else if(replacement->is_string()){
	if(replacement->is_defined())
	replacement_code=replacement;
	} else if(!replacement->is_void())
	throw Exception(PARSER_RUNTIME,
	0,
	"replacement option should be junction or string");

	Value* default_code=(params_count==4)?&params.as_junction(3, "default value must be code"):0;

String result;	String result;
VTable* vtable=new VTable;	VTable* vtable=new VTable;
Line 393 static void _match(Request& r, MethodPar	Line 434 static void _match(Request& r, MethodPar
&src,	&src,
&result,	&result,
vtable,	vtable,
&replacement_code	replacement_code
};	};
Temp_value_element temp_match_var(
*replacement_code.get_junction()->method_frame,	if(is_junction){
match_var_name, vtable);	Temp_value_element temp(r, *replacement_code->get_junction()->method_frame, match_var_name, vtable);
src.match(r.charsets.source(),	src.match(vregex, replace_action, &info, matches_count);
r.process_to_string(regexp), options,	} else {
replace_action, &info,	src.match(vregex, replace_action, &info, matches_count);
matches_count);	}
r.write_assign_lang(result);
	if(!matches_count && default_code)
	r.process_write(*default_code);
	else
	r.write_pass_lang(result);
}	}
}	}

Line 410 static void change_case(Request& r, Meth	Line 455 static void change_case(Request& r, Meth
String::Change_case_kind kind) {	String::Change_case_kind kind) {
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();

r.write_assign_lang(src.change_case(r.charsets.source(), kind));	r.write_pass_lang(src.change_case(r.charsets.source(), kind));
}	}
static void _upper(Request& r, MethodParams& params) {	static void _upper(Request& r, MethodParams& params) {
change_case(r, params, String::CC_UPPER);	change_case(r, params, String::CC_UPPER);
Line 425 class String_sql_event_handlers: public	Line 470 class String_sql_event_handlers: public
bool got_column;	bool got_column;
public:	public:
bool got_cell;	bool got_cell;
String& result;	const String* result;
public:	public:
String_sql_event_handlers(	String_sql_event_handlers(
const String& astatement_string, const char* astatement_cstr):	const String& astatement_string, const char* astatement_cstr):
statement_string(astatement_string), statement_cstr(astatement_cstr),	statement_string(astatement_string), statement_cstr(astatement_cstr),
got_column(false),	got_column(false),
got_cell(false),	got_cell(false),
result(*new String) {}	result(&String::Empty) {}

bool add_column(SQL_Error& error, const char* /str/, size_t /length/) {	bool add_column(SQL_Error& error, const char* /str/, size_t /length/) {
if(got_column) {	if(got_column) {
Line 446 public:	Line 491 public:
}	}
bool before_rows(SQL_Error& /error/ ) { /* ignore */ return false; }	bool before_rows(SQL_Error& /error/ ) { /* ignore */ return false; }
bool add_row(SQL_Error& /error/) { /* ignore */ return false; }	bool add_row(SQL_Error& /error/) { /* ignore */ return false; }
bool add_row_cell(SQL_Error& error, const char* str, size_t length) {	bool add_row_cell(SQL_Error& error, const char* str, size_t) {
if(got_cell) {	if(got_cell) {
error=SQL_Error(PARSER_RUNTIME,	error=SQL_Error(PARSER_RUNTIME,
//statement_string,	//statement_string,
Line 456 public:	Line 501 public:

try {	try {
got_cell=true;	got_cell=true;
result.append_know_length(str, length, String::L_TAINTED);	result=new String(str, String::L_TAINTED /* no length as 0x00 can be inside */ );
return false;	return false;
} catch(...) {	} catch(...) {
error=SQL_Error("exception occured in String_sql_event_handlers::add_row_cell");	error=SQL_Error("exception occured in String_sql_event_handlers::add_row_cell");
Line 473 extern String sql_distinct_name;	Line 518 extern String sql_distinct_name;
extern int marshal_binds(HashStringValue& hash, SQL_Driver::Placeholder*& placeholders);	extern int marshal_binds(HashStringValue& hash, SQL_Driver::Placeholder*& placeholders);
extern void unmarshal_bind_updates(HashStringValue& hash, int placeholder_count, SQL_Driver::Placeholder* placeholders);	extern void unmarshal_bind_updates(HashStringValue& hash, int placeholder_count, SQL_Driver::Placeholder* placeholders);

const String* sql_result_string(Request& r, MethodParams& params,	const String* sql_result_string(Request& r, MethodParams& params, Value*& default_code) {
HashStringValue& options, Value& default_code) {
Value& statement=params.as_junction(0, "statement must be code");	Value& statement=params.as_junction(0, "statement must be code");

HashStringValue* bind=0;	HashStringValue* bind=0;
ulong limit=SQL_NO_LIMIT;	ulong limit=SQL_NO_LIMIT;
ulong offset=0;	ulong offset=0;
default_code=0;	default_code=0;
if(params.count()>1) {	if(params.count()>1)
Value& voptions=params.as_no_junction(1, "options must be hash, not code");	if(HashStringValue* options=params.as_hash(1, "sql options")) {
if(voptions.is_defined() && !voptions.is_string())	int valid_options=0;
if((options=voptions.get_hash())) {	if(Value* vbind=options->get(sql_bind_name)) {
int valid_options=0;	valid_options++;
if(Value* vbind=options->get(sql_bind_name)) {	bind=vbind->get_hash();
valid_options++;	}
bind=vbind->get_hash();	if(Value* vlimit=options->get(sql_limit_name)) {
}	valid_options++;
if(Value* vlimit=options->get(sql_limit_name)) {	limit=(ulong)r.process(*vlimit).as_double();
valid_options++;	}
limit=(ulong)r.process_to_value(*vlimit).as_double();	if(Value* voffset=options->get(sql_offset_name)) {
}	valid_options++;
if(Value* voffset=options->get(sql_offset_name)) {	offset=(ulong)r.process(*voffset).as_double();
valid_options++;	}
offset=(ulong)r.process_to_value(*voffset).as_double();	if((default_code=options->get(sql_default_name))) {
}	valid_options++;
if((default_code=options->get(sql_default_name))) {	}
valid_options++;	if(valid_options!=options->count())
}	throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
if(valid_options!=options->count())	}
throw Exception(PARSER_RUNTIME,
0,
"called with invalid option");
} else
throw Exception(PARSER_RUNTIME,
0,
"options must be hash");
} else
options=0;

SQL_Driver::Placeholder* placeholders=0;	SQL_Driver::Placeholder* placeholders=0;
uint placeholders_count=0;	uint placeholders_count=0;
if(bind)	if(bind)
placeholders_count=marshal_binds(*bind, placeholders);	placeholders_count=marshal_binds(*bind, placeholders);

Temp_lang temp_lang(r, String::L_SQL);
const String& statement_string=r.process_to_string(statement);	const String& statement_string=r.process_to_string(statement);
const char* statement_cstr=	const char* statement_cstr=statement_string.untaint_cstr(String::L_SQL, r.connection());
statement_string.cstr(String::L_UNSPECIFIED, r.connection());
String_sql_event_handlers handlers(statement_string, statement_cstr);	String_sql_event_handlers handlers(statement_string, statement_cstr);

r.connection()->query(	r.connection()->query(
Line 536 const String* sql_result_string(Request&	Line 570 const String* sql_result_string(Request&
if(!handlers.got_cell)	if(!handlers.got_cell)
return 0; // no lines, caller should return second param[default value]	return 0; // no lines, caller should return second param[default value]

return &handlers.result;	return handlers.result;
}	}

static void _sql(Request& r, MethodParams& params) {	static void _sql(Request& r, MethodParams& params) {

HashStringValue* options;
Value* default_code;	Value* default_code;
const String* string=sql_result_string(r, params, options, default_code);	const String* string=sql_result_string(r, params, default_code);
if(!string) {	if(!string) {
if(default_code) {	if(default_code) {
string=&r.process_to_string(*default_code);	string=&r.process_to_string(*default_code);
Line 553 static void _sql(Request& r, MethodParam	Line 586 static void _sql(Request& r, MethodParam
"produced no result, but no default option specified");	"produced no result, but no default option specified");
}	}

r.write_assign_lang(*string);	r.write_pass_lang(*string);
}	}

static void _replace(Request& r, MethodParams& params) {	static void _replace(Request& r, MethodParams& params) {
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();

Table* table=params.as_no_junction(0, PARAM_MUST_NOT_BE_CODE).get_table();	if(params.count()==1) {
if(!table)	// ^string.replace[table]
throw Exception(PARSER_RUNTIME,	Table* table=params.as_table(0, "param");
0,	Dictionary dict(*table);
"parameter must be table");	r.write_pass_lang(src.replace(dict));
	} else {
	// ^string.replace[from-string;to-string]
	Dictionary dict(
	params.as_string(0, "from must be string"),
	params.as_string(1, "to must be string")
	);
	r.write_pass_lang(src.replace(dict));
	}

Dictionary dict(*table);
r.write_assign_lang(src.replace(dict));
}	}

static void _save(Request& r, MethodParams& params) {	static void _save(Request& r, MethodParams& params) {
const String& file_name=params.as_string(params.count()-1, FILE_NAME_MUST_BE_STRING);	bool do_append=false;
	Charset* asked_charset=0;

	size_t file_name_index=0;
	if(params.count()>1) {
	if(HashStringValue* options=params.as_no_junction(1, "second parameter should be string or hash").get_hash()){
	// ^file.save[filespec;$.charset[] $.append(true)]
	int valid_options=0;
	if(Value* vcharset_name=options->get(PA_CHARSET_NAME)){
	asked_charset=&pa_charsets.get(vcharset_name->as_string());
	valid_options++;
	}
	if(Value* vappend=options->get(MODE_APPEND)){
	do_append=vappend->as_bool();
	valid_options++;
	}
	if(valid_options != options->count())
	throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
	} else {
	// ^file.save[append;filespec]
	const String& mode=params.as_string(0, "mode must be string");
	if(mode==MODE_APPEND){
	do_append=true;
	file_name_index++;
	} else
	throw Exception(PARSER_RUNTIME,
	&mode,
	"unknown mode, must be 'append'");
	}
	}

	const String& file_name=params.as_string(file_name_index, FILE_NAME_MUST_BE_STRING);
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();

bool do_append=false;	String::Body sbody=src.cstr_to_string_body_untaint(String::L_AS_IS, r.connection(false), &r.charsets);
if(params.count()>1) {
const String& mode=params.as_string(0, "mode must be string");
if(mode=="append")
do_append=true;
else
throw Exception(PARSER_RUNTIME,
&mode,
"unknown mode, must be 'append'");
}

// write	// write
const char* buf=src.cstr(String::L_UNSPECIFIED, r.connection(false/no error if none/));	file_write(r.charsets, r.absolute(file_name), sbody.cstr(), sbody.length(), true, do_append, asked_charset);
file_write(r.absolute(file_name),
buf, strlen(buf), true, do_append);
}	}

static void _normalize(Request& r, MethodParams&) {	static void _normalize(Request& r, MethodParams&) {
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();

r.write_assign_lang(src);	r.write_pass_lang(src);
}	}

static void _trim(Request& r, MethodParams& params) {	static void _trim(Request& r, MethodParams& params) {
const String& src=GET_SELF(r, VString).string();	const String& src=GET_SELF(r, VString).string();

String::Trim_kind kind=String::TRIM_BOTH;	String::Trim_kind kind=String::TRIM_BOTH;
	size_t params_count=params.count();
const char* chars=0;	const char* chars=0;
if(params.count()>0) {	if(params_count>0) {
const String& skind=params.as_string(0,	const String& skind=params.as_string(0, "'where' must be string");
"'where' must be string");	if(!skind.is_empty()) {
if(skind.length())
if(skind==TRIM_BOTH_OPTION)	if(skind==TRIM_BOTH_OPTION)
kind=String::TRIM_BOTH;	kind=String::TRIM_BOTH;
else if(skind==TRIM_START_OPTION \|\| skind=="start")	else if(skind==TRIM_START_OPTION \|\| skind=="start")
kind=String::TRIM_START;	kind=String::TRIM_START;
else if(skind==TRIM_END_OPTION \|\| skind=="end")	else if(skind==TRIM_END_OPTION \|\| skind=="end")
kind=String::TRIM_END;	kind=String::TRIM_END;
	else if(params_count==1)
	chars=skind.cstr();
else	else
throw Exception(PARSER_RUNTIME,	throw Exception(PARSER_RUNTIME,
&skind,	&skind,
"'kind' must be one of "TRIM_START_OPTION", "TRIM_BOTH_OPTION", "TRIM_END_OPTION);	"'kind' must be one of " TRIM_START_OPTION ", " TRIM_BOTH_OPTION ", " TRIM_END_OPTION);
	}

if(params.count()>1) {	if(params_count>1) {
const String& schars=params.as_string(1, "'chars' must be string");	const String& schars=params.as_string(1, "'chars' must be string");
if(schars.length())	if(!schars.is_empty())
chars=schars.cstr();	chars=schars.cstr();
}	}
}	}

r.write_assign_lang(src.trim(kind, chars));	r.write_pass_lang(src.trim(kind, chars, &r.charsets.source()));
}

static void _append(Request& r, MethodParams& params) {
// c=a+b
VString& va=GET_SELF(r, VString);
const String& a=va.string();
const String& b=params.as_string(0, PARAMETER_MUST_BE_STRING);
String& c=*new String(a);
c.append(b, String::L_PASS_APPENDED);
va.set_string(c);
}	}

static void _base64(Request& r, MethodParams& params) {	static void _base64(Request& r, MethodParams& params) {
if(params.count()) {	if(&r.get_self() == string_class) {
// decode	// decode: ^string:base64[encoded[;$.strict(true\|false)]]
const char* cstr=params.as_string(0, PARAMETER_MUST_BE_STRING).cstr();	const char* cstr=params.count() ? params.as_string(0, PARAMETER_MUST_BE_STRING).cstr() : "";
char* decoded_cstr=0;	char* decoded=0;
size_t decoded_size=0;	size_t length=0;
pa_base64_decode(cstr, strlen(cstr), decoded_cstr, decoded_size);
if(decoded_cstr && decoded_size)	bool strict=false;
r.write_assign_lang(*new String(decoded_cstr, decoded_size, true));	if(params.count() > 1)
	if(HashStringValue* options=params.as_hash(1)) {
	int valid_options=0;
	if(Value* vstrict=options->get(BASE64_STRICT_OPTION_NAME)) {
	strict=r.process(*vstrict).as_bool();
	valid_options++;
	}
	if(valid_options!=options->count())
	throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
	}

	pa_base64_decode(cstr, strlen(cstr), decoded, length, strict);
	if(decoded && length){
	if(memchr((const char*)decoded, 0, length))
	throw Exception(PARSER_RUNTIME,
	0,
	"Invalid \\x00 character found while decode to string. Decode it to file instead.");

	fix_line_breaks(decoded, length);
	if(length)
	r.write_pass_lang(*new String(decoded, String::L_TAINTED));
	}
} else {	} else {
// encode	// encode: ^str.base64[]
VString& self=GET_SELF(r, VString);	VString& self=GET_SELF(r, VString);
const char* cstr=self.string().cstr();	const char* cstr=self.string().cstr();
const char* encoded=pa_base64_encode(cstr, strlen(cstr));	const char* encoded=pa_base64_encode(cstr, strlen(cstr));
r.write_assign_lang(new String(encoded, 0, true/once ?param=base64(something) was needed*/));	r.write_pass_lang(new String(encoded, String::L_TAINTED/once ?param=base64(something) was needed*/));
	}
	}

	static void _idna(Request& r, MethodParams& params) {
	if(&r.get_self() == string_class) {
	// decode: ^string:idna[encoded]
	const char* cstr=params.count() ? params.as_string(0, PARAMETER_MUST_BE_STRING).cstr() : "";
	r.write_pass_lang(*new String(pa_idna_decode(cstr, r.charsets.source()), String::L_TAINTED));
	} else {
	// encode: ^str.idna[]
	VString& self=GET_SELF(r, VString);
	const char* cstr=self.string().cstr();
	r.write_pass_lang(*new String(pa_idna_encode(cstr, r.charsets.source()), String::L_TAINTED));
}	}
}	}

	static void _js_escape(Request& r, MethodParams&){
	const String& src=GET_SELF(r, VString).string();
	r.write_pass_lang(src.escape(r.charsets.source()));
	}

	static void _js_unescape(Request& r, MethodParams& params){
	const String& src=params.as_string(0, PARAMETER_MUST_BE_STRING);
	if(const char* result=unescape_chars(src.cstr(), src.length(), &r.charsets.source(), true))
	r.write_pass_lang(*new String(result, String::L_TAINTED));
	}

	static void _unescape(Request& r, MethodParams& params){
	const String& mode=params.as_string(0, MODE_MUST_NOT_BE_CODE);
	const String& src=params.as_string(1, PARAMETER_MUST_BE_STRING);

	Charset* from_charset=&r.charsets.client();

	if(params.count() > 2)
	if(HashStringValue* options=params.as_hash(2)) {
	int valid_options=0;
	if(Value* vcharset_name=options->get(PA_CHARSET_NAME)){
	from_charset=&pa_charsets.get(vcharset_name->as_string());
	valid_options++;
	}
	if(valid_options!=options->count())
	throw Exception(PARSER_RUNTIME, 0, CALLED_WITH_INVALID_OPTION);
	}

	bool mode_js;
	if(mode==UNESCAPE_MODE_JS){
	mode_js=true;
	} else if(mode==UNESCAPE_MODE_URI){
	mode_js=false;
	} else {
	throw Exception(PARSER_RUNTIME, &mode, "is invalid mode, must be either '" UNESCAPE_MODE_JS "' or '" UNESCAPE_MODE_URI "'");
	}

	const char* unescaped=unescape_chars(src.cstr(), src.length(), from_charset, mode_js);
	if(*unescaped){
	const String* result=new String(Charset::transcode(unescaped, *from_charset, r.charsets.source()), String::L_TAINTED);
	r.write_pass_lang(*result);
	}
	}

	static void _contains(Request& r, MethodParams& params) {
	// empty or whitespace string is hash compatible
	GET_SELF(r, VString).get_element(params.as_string(0, "key must be string"));
	// ignoring result as it allways null
	r.write_no_lang(VBool::get(false));
	}

// constructor	// constructor

MString::MString(): Methoded("string") {	MString::MString(): Methoded("string") {
Line 698 MString::MString(): Methoded("string") {	Line 834 MString::MString(): Methoded("string") {

// ^string.match[regexp][options]	// ^string.match[regexp][options]
// ^string.match[regexp][options]{replacement-code}	// ^string.match[regexp][options]{replacement-code}
add_native_method("match", Method::CT_DYNAMIC, _match, 1, 3);	// ^string.match[regexp][options]{replacement-code}{code-if-nothing-is-found}
	add_native_method("match", Method::CT_DYNAMIC, _match, 1, 4);

// ^string.upper[]	// ^string.upper[]
add_native_method("upper", Method::CT_DYNAMIC, _upper, 0, 0);	add_native_method("upper", Method::CT_DYNAMIC, _upper, 0, 0);
// ^string.lower[]	// ^string.lower[]
add_native_method("lower", Method::CT_DYNAMIC, _lower, 0, 0);	add_native_method("lower", Method::CT_DYNAMIC, _lower, 0, 0);

// ^sql[query]	// ^string:sql{query}
// ^sql[query][options hash]	// ^string:sql{query}[options hash]
add_native_method("sql", Method::CT_STATIC, _sql, 1, 2);	add_native_method("sql", Method::CT_STATIC, _sql, 1, 2);

// ^string.replace[table]	// ^string.replace[table]
add_native_method("replace", Method::CT_DYNAMIC, _replace, 1, 1);	add_native_method("replace", Method::CT_DYNAMIC, _replace, 1, 2);

// ^string.save[file]	// ^string.save[append][file]
	// ^string.save[file]
	// ^string.save[file][$.append(true) $.charset[...]]
add_native_method("save", Method::CT_DYNAMIC, _save, 1, 2);	add_native_method("save", Method::CT_DYNAMIC, _save, 1, 2);

// ^string.normalize[]	// ^string.normalize[]
Line 721 MString::MString(): Methoded("string") {	Line 860 MString::MString(): Methoded("string") {
// ^string.trim[[start\|both\|end][;chars]]	// ^string.trim[[start\|both\|end][;chars]]
add_native_method("trim", Method::CT_DYNAMIC, _trim, 0, 2);	add_native_method("trim", Method::CT_DYNAMIC, _trim, 0, 2);

// ^string.append[string]
add_native_method("append", Method::CT_DYNAMIC, _append, 1, 1);

// ^string.base64[] << encode	// ^string.base64[] << encode
// ^string:base64[encoded string] << decode	// ^string:base64[encoded string] << decode
add_native_method("base64", Method::CT_ANY, _base64, 0, 1);	add_native_method("base64", Method::CT_ANY, _base64, 0, 2);
}
	// ^string.idna[] << encode
	// ^string:idna[encoded string] << decode
	add_native_method("idna", Method::CT_ANY, _idna, 0, 1);

	// ^string.js-escape[]
	add_native_method("js-escape", Method::CT_DYNAMIC, _js_escape, 0, 0);

	// ^string:js-unescape[escaped%uXXXXstring]
	add_native_method("js-unescape", Method::CT_STATIC, _js_unescape, 1, 1);

	// ^string:unescape[js\|uri;escaped;$.charset[...]]
	add_native_method("unescape", Method::CT_STATIC, _unescape, 2, 3);

	// ^string.contains[key] for hash compatibility
	add_native_method("contains", Method::CT_DYNAMIC, _contains, 1, 1);
	}

E-mail:

Removed from v.1.166
changed lines
	Added in v.1.232