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.136 and 1.185

version 1.136, 2004/03/01 08:54:16	version 1.185, 2009/07/07 05:47:43
Line 1	Line 1
/** @file	/** @file
Parser: @b string parser class.	Parser: @b string parser class.

Copyright (c) 2001-2004 ArtLebedev Group (http://www.artlebedev.com)	Copyright (c) 2001-2009 ArtLebedev Group (http://www.artlebedev.com)
Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)	Author: Alexandr Petrosian <paf@design.ru> (http://paf.design.ru)
*/	*/

Line 19 static const char * const IDENT_STRING_C	Line 19 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"

// class	// class

Line 36 DECLARE_CLASS_VAR(string, new MString, 0	Line 37 DECLARE_CLASS_VAR(string, new MString, 0
// defines for statics	// defines for statics

#define MATCH_VAR_NAME "match"	#define MATCH_VAR_NAME "match"
#define TRIM_START_OPTION "start"	#define TRIM_START_OPTION "left"
	#define TRIM_END_OPTION "right"
#define TRIM_BOTH_OPTION "both"	#define TRIM_BOTH_OPTION "both"
#define TRIM_END_OPTION "end"

// statics	// statics

Line 47 static const String match_var_name(MATCH	Line 48 static const String match_var_name(MATCH
// methods	// methods

static void _length(Request& r, MethodParams&) {	static void _length(Request& r, MethodParams&) {
double result=GET_SELF(r, VString).string().length();	double result=GET_SELF(r, VString).string().length(r.charsets.source());
r.write_no_lang(*new VDouble(result));	r.write_no_lang(*new VDouble(result));
}	}

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;
Value* default_code=params.count()>0?&params.as_junction(0, "default must be int")
:0; // (default)
try {	try {
if(self_string.is_empty())	if(self_string.is_empty())
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
0,	0,
"parameter is empty string, error converting");	"parameter is empty string, error converting");
converted=self_string.as_int();	converted=self_string.as_int();
} catch(...) { // convert problem	} catch(...) { // convert problem
if(default_code)	if(params.count()>0)
converted=r.process_to_value(*default_code).as_int();	converted=params.as_int(0, "default must be int", r); // (default)
else	else
rethrow; // we have a problem when no default	rethrow; // we have a problem when no default
}	}
Line 74 static void _int(Request& r, MethodParam	Line 73 static void _int(Request& r, MethodParam
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;	double converted;
Value* default_code=params.count()>0?&params.as_junction(0, "default must be double")
:0; // (default)
try {	try {
if(self_string.is_empty())	if(self_string.is_empty())
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
0,	0,
"parameter is empty string, error converting");	"parameter is empty string, error converting");
converted=self_string.as_double();	converted=self_string.as_double();
} catch(...) { // convert problem	} catch(...) { // convert problem
if(default_code)	if(params.count()>0)
converted=r.process_to_value(*default_code).as_double();	converted=params.as_double(0, "default must be double", r); // (default)
else	else
rethrow; // we have a problem when no default	rethrow; // we have a problem when no default
}	}
Line 92 static void _double(Request& r, MethodPa	Line 89 static void _double(Request& r, MethodPa
r.write_no_lang(*new VDouble(converted));	r.write_no_lang(*new VDouble(converted));
}	}

	static void _bool(Request& r, MethodParams& params) {
	const String& self_string=GET_SELF(r, VString).string();
	bool converted;
	try {
	if(self_string.is_empty())
	throw Exception(PARSER_RUNTIME,
	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)
	converted=params.as_bool(0, "default must be bool", r); // (default)
	else
	rethrow; // we have a problem when no default
	}

	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) {

Value& fmt_maybe_code=params[0];	Value& fmt_maybe_code=params[0];
// for some time due to stupid {} in original design	// for some time due to stupid {} in original design
const String& fmt=r.process_to_string(fmt_maybe_code);	const String& fmt=r.process_to_string(fmt_maybe_code);

const char* buf=format(r.get_self().as_double(), fmt.cstrm());	const char* buf=format(r.get_self().as_double(), fmt.trim().cstrm());

r.write_no_lang(String(buf));	r.write_no_lang(String(buf));
}	}

static void _left(Request& r, MethodParams& params) {	static void _left(Request& r, MethodParams& params) {
size_t n=(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)
	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(0, n));	r.write_assign_lang(string.mid(r.charsets.source(), 0, n));
}	}

static void _right(Request& r, MethodParams& params) {	static void _right(Request& r, MethodParams& params) {
size_t n=(size_t)params.as_int(0, "n must be int", r);	ssize_t sn=(size_t)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();
size_t length=string.length();	size_t length=string.length(r.charsets.source());
r.write_assign_lang(n<length?string.mid(length-n, string.length()):string);	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) {
const String& string=GET_SELF(r, VString).string();	const String& string=GET_SELF(r, VString).string();

size_t p=(size_t)max(0, params.as_int(0, "p must be int", r));	ssize_t sbegin=params.as_int(0, "p must be int", r);
size_t n=params.count()>1?	if(sbegin<0)
(size_t)max(0, params.as_int(1, "n must be int", r)):string.length();	throw Exception(PARSER_RUNTIME,
	0,
r.write_assign_lang(string.mid(p, p+n));	"p(%d) must be >=0", sbegin);
	size_t begin=(size_t)sbegin;

	size_t end;
	size_t length=0;
	if(params.count()>1) {
	ssize_t sn=params.as_int(1, "n must be int", r);
	if(sn<0)
	throw Exception(PARSER_RUNTIME,
	0,
	"n(%d) must be >=0", sn);
	end=begin+(size_t)sn;
	} else {
	length=string.length(r.charsets.source());
	end=length;
	}

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

static void _pos(Request& r, MethodParams& params) {	static void _pos(Request& r, MethodParams& params) {
Value& substr=params.as_no_junction(0, "substr must not be code");	Value& substr=params.as_no_junction(0, "substr must not be code");

const String& string=GET_SELF(r, VString).string();	const String& string=GET_SELF(r, VString).string();
r.write_assign_lang(*new VInt((int)string.pos(substr.as_string())));	ssize_t offset=0;
	if(params.count()>1){
	offset=params.as_int(1, "n must be int", r);
	if(offset<0)
	throw Exception(PARSER_RUNTIME,
	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)));
}	}

static void split_list(MethodParams& params, int paramIndex,	static void split_list(MethodParams& params, int paramIndex,
Line 169 static int split_options(const String* o	Line 233 static int split_options(const String* o
if(options->pos(o->keyL)!=STRING_NOT_FOUND	if(options->pos(o->keyL)!=STRING_NOT_FOUND
\|\| (o->keyU && options->pos(o->keyU)!=STRING_NOT_FOUND)) {	\|\| (o->keyU && options->pos(o->keyU)!=STRING_NOT_FOUND)) {
if(result & o->checkBit)	if(result & o->checkBit)
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
options,	options,
"conflicting split options");	"conflicting split options");
result \|= o->setBit;	result \|= o->setBit;
Line 179 static int split_options(const String* o	Line 243 static int split_options(const String* o
return result;	return result;
}	}

static Table& split_vertical(ArrayString& pieces, bool right) {	static Table& split_vertical(ArrayString& pieces, bool right, const String* column_name) {
Table::columns_type columns(new ArrayString);	Table::columns_type columns(new ArrayString);
*columns+=new String("piece");	*columns+=column_name;

Table& table=*new Table(columns, pieces.count());	Table& table=*new Table(columns, pieces.count());
if(right) { // right	if(right) { // right
Line 220 static Table& split_horizontal(ArrayStri	Line 284 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 234 static void split_with_options(Request&	Line 299 static void split_with_options(Request&

bool right=(bits & SPLIT_RIGHT) != 0;	bool right=(bits & SPLIT_RIGHT) != 0;
bool horizontal=(bits & SPLIT_HORIZONTAL) !=0;	bool horizontal=(bits & SPLIT_HORIZONTAL) !=0;
Table& table=horizontal?split_horizontal(pieces, right)
:split_vertical(pieces, right);	const String* column_name=0;
	if(params_count>2){
	column_name=&params.as_string(2, COLUMN_NAME_MUST_BE_STRING);
	if (horizontal && !column_name->is_empty())
	throw Exception(PARSER_RUNTIME,
	column_name,
	"column name can't be specified with horisontal split");
	}
	if(!column_name \|\| column_name->is_empty())
	column_name=new String("piece");

	Table& table=horizontal?split_horizontal(pieces, right):split_vertical(pieces, right, column_name);

r.write_no_lang(*new VTable(&table));	r.write_no_lang(*new VTable(&table));
}	}
Line 256 static void search_action(Table& table,	Line 332 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 277 static void replace_action(Table& table,	Line 354 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, false)){
	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);	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();
bool just_matched;	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,
just_matched);	matches_count);
Value* result;
if(table)	if(table){
result=new VTable(table); // table of pre/match/post+substrings	r.write_no_lang(*new VTable(table));
else	} else {
result=new VBool(just_matched);	r.write_no_lang(*new VInt(matches_count));
r.write_assign_lang(*result);	}

} 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");

String result;	String result;
VTable* vtable=new VTable;	VTable* vtable=new VTable;
Line 318 static void _match(Request& r, MethodPar	Line 428 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,	Temp_value_element* temp_match_var=0;
match_var_name, vtable);
src.match(r.charsets.source(),	if(is_junction)
r.process_to_string(regexp), options,	temp_match_var=new Temp_value_element(
	*replacement_code->get_junction()->method_frame,
	match_var_name, vtable);

	src.match(vregex,
replace_action, &info,	replace_action, &info,
just_matched);	matches_count);

	if(temp_match_var)
	delete temp_match_var;

r.write_assign_lang(result);	r.write_assign_lang(result);
}	}
}	}
Line 361 public:	Line 479 public:

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) {
error=SQL_Error("parser.runtime",	error=SQL_Error(PARSER_RUNTIME,
//statement_string,	//statement_string,
"result must contain exactly one column");	"result must contain exactly one column");
return true;	return true;
Line 373 public:	Line 491 public:
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 length) {
if(got_cell) {	if(got_cell) {
error=SQL_Error("parser.runtime",	error=SQL_Error(PARSER_RUNTIME,
//statement_string,	//statement_string,
"result must not contain more then one row");	"result must not contain more then one row");
return true;	return true;
Line 390 public:	Line 508 public:
}	}
};	};
#endif	#endif
	extern String sql_bind_name;
extern String sql_limit_name;	extern String sql_limit_name;
extern String sql_offset_name;	extern String sql_offset_name;
extern String sql_default_name;	extern String sql_default_name;
extern String sql_distinct_name;	extern String sql_distinct_name;
	extern int marshal_binds(HashStringValue& hash, 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,
HashStringValue& options, 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");

ulong limit=0;	HashStringValue* bind=0;
	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");	Value& voptions=params.as_no_junction(1, "options must be hash, not code");
if(!voptions.is_string())	if(voptions.is_defined() && !voptions.is_string())
if((options=voptions.get_hash())) {	if((options=voptions.get_hash())) {
if(Value* vlimit=options->get(sql_limit_name))	int valid_options=0;
	if(Value* vbind=options->get(sql_bind_name)) {
	valid_options++;
	bind=vbind->get_hash();
	}
	if(Value* vlimit=options->get(sql_limit_name)) {
	valid_options++;
limit=(ulong)r.process_to_value(*vlimit).as_double();	limit=(ulong)r.process_to_value(*vlimit).as_double();
if(Value* voffset=options->get(sql_offset_name))	}
	if(Value* voffset=options->get(sql_offset_name)) {
	valid_options++;
offset=(ulong)r.process_to_value(*voffset).as_double();	offset=(ulong)r.process_to_value(*voffset).as_double();
	}
if((default_code=options->get(sql_default_name))) {	if((default_code=options->get(sql_default_name))) {
if(!default_code->get_junction())	valid_options++;
throw Exception("parser.runtime",
0,
"default option must be code");
}	}
	if(valid_options!=options->count())
	throw Exception(PARSER_RUNTIME,
	0,
	"called with invalid option");
} else	} else
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
0,	0,
"options must be hash");	"options must be hash");
} else	} else
options=0;	options=0;

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

Temp_lang temp_lang(r, String::L_SQL);	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(r.flang, 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(
statement_cstr, offset, limit,	statement_cstr,
	placeholders_count, placeholders,
	offset, limit,
handlers,	handlers,
statement_string);	statement_string);

	if(bind)
	unmarshal_bind_updates(*bind, placeholders_count, placeholders);

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]

Line 447 static void _sql(Request& r, MethodParam	Line 591 static void _sql(Request& r, MethodParam
if(default_code) {	if(default_code) {
string=&r.process_to_string(*default_code);	string=&r.process_to_string(*default_code);
} else	} else
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
0,	0,
"produced no result, but no default option specified");	"produced no result, but no default option specified");
}	}
Line 458 static void _sql(Request& r, MethodParam	Line 602 static void _sql(Request& r, MethodParam
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, "parameter must not be code").get_table();	Table* table=params.as_no_junction(0, PARAM_MUST_NOT_BE_CODE).get_table();
if(!table)	if(!table)
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
0,	0,
"parameter must be table");	"parameter must be table");

Line 469 static void _replace(Request& r, MethodP	Line 613 static void _replace(Request& r, MethodP
}	}

static void _save(Request& r, MethodParams& params) {	static void _save(Request& r, MethodParams& params) {
const String& file_name=params.as_string(params.count()-1,	size_t params_count=params.count();
"file name must be string");	const String& file_name=params.as_string(params_count-1, 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;	bool do_append=false;
if(params.count()>1) {	if(params_count>1) {
const String& mode=params.as_string(0, "mode must be string");	const String& mode=params.as_string(0, "mode must be string");
if(mode=="append")	if(mode=="append")
do_append=true;	do_append=true;
else	else
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
&mode,	&mode,
"unknown mode, must be 'append'");	"unknown mode, must be 'append'");
}	}

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

static void _normalize(Request& r, MethodParams&) {	static void _normalize(Request& r, MethodParams&) {
Line 501 static void _trim(Request& r, MethodPara	Line 644 static void _trim(Request& r, MethodPara
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==TRIM_START_OPTION)	if(skind==TRIM_BOTH_OPTION)
kind=String::TRIM_START;	kind=String::TRIM_BOTH;
else if(skind==TRIM_END_OPTION)	else if(skind==TRIM_START_OPTION \|\| skind=="start")
kind=String::TRIM_END;	kind=String::TRIM_START;
else if(skind==TRIM_BOTH_OPTION)	else if(skind==TRIM_END_OPTION \|\| skind=="end")
kind=String::TRIM_BOTH;	kind=String::TRIM_END;
else	else
throw Exception("parser.runtime",	throw Exception(PARSER_RUNTIME,
&skind,	&skind,
"'kind' should 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())
throw Exception("parser.runtime",	chars=schars.cstr();
	}
	}

	r.write_assign_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) {
	if(params.count()) {
	// decode: ^string:base64[encoded]
	const char* cstr=params.as_string(0, PARAMETER_MUST_BE_STRING).cstr();
	char* decoded=0;
	size_t length=0;
	pa_base64_decode(cstr, strlen(cstr), decoded, length);
	if(decoded && length){
	if(memchr((const char*)decoded, 0, length))
	throw Exception(PARSER_RUNTIME,
0,	0,
"'chars' must not be empty");	"Invalid \\x00 character found while decode to string. Decode it to file instead.");
chars=schars.cstr();
	fix_line_breaks(decoded, length);
	if(length)
	r.write_assign_lang(*new String(decoded, String::L_TAINTED));
}	}
	} else {
	// encode: ^str.base64[]
	VString& self=GET_SELF(r, VString);
	const char* cstr=self.string().cstr();
	const char* encoded=pa_base64_encode(cstr, strlen(cstr));
	r.write_assign_lang(new String(encoded, String::L_TAINTED/once ?param=base64(something) was needed*/));
}	}
	}

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

r.write_assign_lang(src.trim(kind, chars));	static void _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/* don't unescape '+' char */))
	r.write_assign_lang(*new String(result));
}	}

// constructor	// constructor
Line 541 MString::MString(): Methoded("string") {	Line 729 MString::MString(): Methoded("string") {
// ^string.double[]	// ^string.double[]
// ^string.double(default)	// ^string.double(default)
add_native_method("double", Method::CT_DYNAMIC, _double, 0, 1);	add_native_method("double", Method::CT_DYNAMIC, _double, 0, 1);
	// ^void.bool[]
	// ^void.bool(default)
	add_native_method("bool", Method::CT_DYNAMIC, _bool, 0, 1);

// ^string.format{format}	// ^string.format[format]
add_native_method("format", Method::CT_DYNAMIC, _string_format, 1, 1);	add_native_method("format", Method::CT_DYNAMIC, _string_format, 1, 1);

// ^string.left(n)	// ^string.left(n)
add_native_method("left", Method::CT_DYNAMIC, _left, 1, 1);	add_native_method("left", Method::CT_DYNAMIC, _left, 1, 1);
// ^string.right(n)	// ^string.right(n)
add_native_method("right", Method::CT_DYNAMIC, _right, 1, 1);	add_native_method("right", Method::CT_DYNAMIC, _right, 1, 1);
	// ^string.mid(p)
// ^string.mid(p;n)	// ^string.mid(p;n)
add_native_method("mid", Method::CT_DYNAMIC, _mid, 1, 2);	add_native_method("mid", Method::CT_DYNAMIC, _mid, 1, 2);

// ^string.pos[substr]	// ^string.pos[substr]
add_native_method("pos", Method::CT_DYNAMIC, _pos, 1, 1);	// ^string.pos[substr](n)
	add_native_method("pos", Method::CT_DYNAMIC, _pos, 1, 2);

// ^string.split[delim]	// ^string.split[delim]
// ^string.split[delim][options]	// ^string.split[delim][options]
add_native_method("split", Method::CT_DYNAMIC, _split, 1, 2);	// ^string.split[delim][options][column name]
	add_native_method("split", Method::CT_DYNAMIC, _split, 1, 3);
// old names for backward compatibility	// old names for backward compatibility
// ^string.lsplit[delim]	// ^string.lsplit[delim]
add_native_method("lsplit", Method::CT_DYNAMIC, _lsplit, 1, 1);	add_native_method("lsplit", Method::CT_DYNAMIC, _lsplit, 1, 1);
Line 568 MString::MString(): Methoded("string") {	Line 762 MString::MString(): Methoded("string") {
// ^string.match[regexp][options]{replacement-code}	// ^string.match[regexp][options]{replacement-code}
add_native_method("match", Method::CT_DYNAMIC, _match, 1, 3);	add_native_method("match", Method::CT_DYNAMIC, _match, 1, 3);

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

// ^sql[query]	// ^sql[query]
// ^sql[query][$.limit(1) $.offset(2) $.default[n/a]]	// ^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]
Line 588 MString::MString(): Methoded("string") {	Line 782 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[encoded string] << decode
	add_native_method("base64", Method::CT_ANY, _base64, 0, 1);

	// ^string.js-escape[]
	// ^string:js-unescape[escaped%uXXXXstring]
	add_native_method("js-escape", Method::CT_ANY, _escape, 0, 0);
	add_native_method("js-unescape", Method::CT_STATIC, _unescape, 1, 1);
}	}

E-mail:

Removed from v.1.136
changed lines
	Added in v.1.185