| Qore Programming Language Reference Manual 1.0.8

ql_string.dox.h
1
3 namespace Qore {
191
193
221 int bindex(softstring str, softstring substr, softint pos = 0);
222
224
228 int bindex();
229
231
258 int brindex(softstring str, softstring substr, softint pos = -1);
259
261
265 int brindex();
266
268
291 int char_width(softstring str);
292
294
310 string chomp(string str);
311
313
324 *string chomp(reference<string> str);
325
327
331 nothing chomp();
332
334
349 string chr(softint val, *string encoding);
350
352
357 string chr(auto arg);
358
360
364 nothing chr();
365
367
382 string convert_encoding(string str, string encoding);
383
385
389 nothing convert_encoding();
390
392
411 string f_printf(string fmt, ...);
412
414
418 string f_printf();
419
421
440 string f_sprintf(string fmt, ...);
441
443
447 string f_sprintf();
448
450
471 string f_vprintf(string fmt, auto varg);
472
474
495 string f_vsprintf(string fmt, auto varg);
496
498
506 nothing flush();
507
509
524 string force_encoding(string str, string encoding);
525
527
531 nothing force_encoding();
532
534
553 string format_number(string fmt, softfloat num);
554
556
560 nothing format_number();
561
563
577 string get_encoding(string str);
578
580
584 nothing get_encoding();
585
587
616 int index(softstring str, softstring substr, softint pos = 0);
617
619
623 int index();
624
626
641 string join(string str, ...);
642
644
661 string join(string str, list<auto> l);
662
664
668 nothing join();
669
671
694 int length(softstring str);
695
697
711 int length(binary bin);
712
714
718 nothing length();
719
721
725 int length(auto arg);
726
728
744 string ltrim(string str, *string chars);
745
747
761 *string ltrim(reference<string> str, *string chars);
762
764
779 int ord(softstring str, softint offset = 0);
780
782
786 int ord();
787
789
803 bool parse_boolean(string str);
804
806
818 bool parse_boolean(any val);
819
821
840 float parse_float(string str, string fmt);
841
843
862 int parse_int(string str, string fmt);
863
865
884 number parse_number(string str, string fmt);
885
887
899 nothing print( ...);
900
902
921 string printf(string fmt, ...);
922
924
931 string printf();
932
934
958 bool regex(string str, string regex, int options = 0);
959
961
965 nothing regex();
966
968
994 *list<*string> regex_extract(string str, string regex, int options = 0);
995
997
1001 nothing regex_extract();
1002
1004
1043 string regex_subst(string str, string regex, string subst, int options = 0);
1044
1046
1050 nothing regex_subst();
1051
1053
1081 string replace(string str, string source, string target, int start = 0, int end = -1);
1082
1084
1088 nothing replace();
1089
1091
1107 string reverse(softstring str);
1108
1110
1139 int rindex(softstring str, softstring substr, softint pos = -1);
1140
1142
1146 int rindex();
1147
1149
1167 string rtrim(string str, *string chars);
1168
1170
1186 *string rtrim(reference<string> str, *string chars);
1187
1189
1207 list<string> split(string sep, string str, bool with_separator = False);
1208
1210
1245 list<string> split(string sep, string str, string quote, bool trim_unquoted = False);
1246
1248
1263 list<binary> split(data sep, binary data);
1264
1266
1270 list<string> split();
1271
1273
1292 string sprintf(string fmt, ...);
1293
1295
1299 string sprintf();
1300
1302
1322 int strlen(softstring str);
1323
1325
1329 nothing strlen();
1330
1332
1336 int strlen(auto arg);
1337
1339
1353 string strmul(softstring str, softint smul, *softint offset);
1354
1356
1376 string substr(softstring str, softint start);
1377
1379
1400 string substr(softstring str, softint start, softint len);
1401
1403
1423 binary substr(binary b, softint start);
1424
1426
1447 binary substr(binary b, softint start, softint len);
1448
1450
1454 nothing substr();
1455
1457
1481 string tolower(string str);
1482
1484
1488 nothing tolower();
1489
1491
1515 string toupper(string str);
1516
1518
1522 nothing toupper();
1523
1525
1540 string trim(string str, *string chars);
1541
1543
1557 *string trim(reference<string> str, *string chars);
1558
1560
1564 nothing trim();
1565
1567
1583 string trunc_str(softstring str, softint len, *string encoding);
1584
1586
1605 string vprintf(string fmt, auto varg);
1606
1608
1612 string vprintf();
1613
1615
1634 string vsprintf(string fmt, auto varg);
1635
1637
1641 string vsprintf();
1642
1644 }
1645
1647 namespace Qore {
1652
1654 const RE_Caseless = PCRE_CASELESS;
1657 const RE_DotAll = PCRE_DOTALL;
1659 const RE_Extended = PCRE_EXTENDED;
1661 const RE_Global = QRE_GLOBAL;
1663 const RE_MultiLine = PCRE_MULTILINE;
1665
1667 const RE_Unicode = PCRE_UCP;
1669 }
Qore::sprintf
string sprintf(string fmt,...)
Returns a formatted string based on a format string and other arguments; does not enforce field width...
Qore::printf
string printf(string fmt,...)
Outputs the string passed to standard output, using the first argument as a format string; does not e...
Qore::RE_Unicode
const RE_Unicode
extens Posix matches to the full Unicode character set
Definition: ql_string.dox.h:1667
Qore::force_encoding
string force_encoding(string str, string encoding)
Returns the first string argument tagged with the character encoding given as the second argument; do...
Qore::strlen
int strlen(softstring str)
Returns the length in bytes of the string argument.
Qore::rtrim
string rtrim(string str, *string chars)
Removes byte characters from the end of a string and returns the new string.
Qore::parse_boolean
bool parse_boolean(string str)
tries to parse a string value as a boolean
Qore::get_encoding
string get_encoding(string str)
Returns a string describing the character encoding of the string argument passed. ...
Qore::format_number
string format_number(string fmt, softfloat num)
Returns a string of a formatted number according to a number argument and a format string...
Qore::parse_number
number parse_number(string str, string fmt)
returns a number corresponding to the string and the argument, giving the format
Qore::bindex
int bindex(softstring str, softstring substr, softint pos=0)
Retrieves the byte position of a substring within a string.
Qore::trim
string trim(string str, *string chars)
Removes byte characters from the start and end of a string and returns the new string (also see the t...
Qore::flush
nothing flush()
Flushes output to the console output with print(), printf(), etc.
Qore::number
number number(softnumber n)
Converts the argument to a number value.
Qore::RE_MultiLine
const RE_MultiLine
makes start-of-line (^) or end-of-line ($) match after or before any newline in the subject string...
Definition: ql_string.dox.h:1663
Qore::binary
binary binary()
Always returns an empty binary object (of zero length)
Qore::substr
string substr(softstring str, softint start)
Returns a portion of a string starting from an integer offset.
Qore::f_vprintf
string f_vprintf(string fmt, auto varg)
Outputs the string passed to standard output, using the first argument as a format string and a secon...
Qore::chomp
string chomp(string str)
Removes the trailing end-of-line indicator ("\n" or "\r\n") from a string and returns the new string ...
Qore::False
const False
logical False
Definition: qc_qore.dox.h:96
Qore::print
nothing print(...)
Outputs a string to standard output with no formatting.
Qore::replace
string replace(string str, string source, string target, int start=0, int end=-1)
Replaces all occurrences of a substring in a string with another string.
Qore::regex_extract
*list< *string > regex_extract(string str, string regex, int options=0)
Returns a list of substrings in a string based on matching patterns defined by a regular expression...
Qore::index
int index(softstring str, softstring substr, softint pos=0)
Retrieves the character position of a substring within a string.
Qore::split
list< string > split(string sep, string str, bool with_separator=False)
Splits a string into a list of components based on a separator string.
Qore::RE_Caseless
const RE_Caseless
Ignores case when matching regular expressions, equivalent to /i
Definition: ql_string.dox.h:1655
Qore::regex
bool regex(string str, string regex, int options=0)
Returns True if the regular expression matches the string passed, otherwise returns False...
Qore::vprintf
string vprintf(string fmt, auto varg)
Outputs the string passed to standard output, using the first argument as a format string and a secon...
Qore::RE_DotAll
const RE_DotAll
makes a dot (.) match a newline character, equivalent to /s
Definition: ql_string.dox.h:1657
Qore::strmul
string strmul(softstring str, softint smul, *softint offset)
Returns a new string with a repeated string element and optionally removing trailing characters...
Qore::chr
string chr(softint val, *string encoding)
Returns a string containing a single ASCII character represented by the numeric value passed...
Qore::convert_encoding
string convert_encoding(string str, string encoding)
Performs explicit string character encoding conversions.
Qore::char_width
int char_width(softstring str)
Returns the width of characters in the string; some unicode characters take up multiple spaces on out...
Qore::RE_Global
const RE_Global
replace all matches globally in the string or extract all occurrences of the pattern(s) in the string...
Definition: ql_string.dox.h:1661
Qore::tolower
string tolower(string str)
Returns a string in all lower-case characters based on the argument passed.
Qore::toupper
string toupper(string str)
Returns a string in all upper-case characters based on the argument passed.
Qore::vsprintf
string vsprintf(string fmt, auto varg)
Returns a formatted string based on a format string and other arguments given as a list after the for...
Qore::ord
int ord(softstring str, softint offset=0)
Gives the positive numeric value of the given byte in the string passed; if no string is passed or th...
Qore::f_vsprintf
string f_vsprintf(string fmt, auto varg)
Returns a formatted string based on a format string and other arguments given as a list after the for...
Qore::regex_subst
string regex_subst(string str, string regex, string subst, int options=0)
Returns a string with patterns substituted according to the arguments passed.
Qore::rindex
int rindex(softstring str, softstring substr, softint pos=-1)
Retrieves the character position of a substring within a string, starting the search from the end of ...
Qore::f_sprintf
string f_sprintf(string fmt,...)
Returns a formatted string based on a format string and other arguments; enforces field widths on arg...
Qore::parse_float
float parse_float(string str, string fmt)
returns a floating-point value corresponding to a string representing the number and an argument givi...
Qore::parse_int
int parse_int(string str, string fmt)
returns an integer corresponding to a string representing the number and an argument giving the forma...
Qore::trunc_str
string trunc_str(softstring str, softint len, *string encoding)
Returns a truncated string with no more than the given number of bytes and optionally converted to a ...
Qore::RE_Extended
const RE_Extended
ignores whitespace characters and enables comments prefixed by #, equivalent to /x ...
Definition: ql_string.dox.h:1659
Qore::brindex
int brindex(softstring str, softstring substr, softint pos=-1)
Retrieves the byte position of a substring within a string, starting the search from the end of the s...
Qore::length
int length(softstring str)
Returns the length in characters for the string passed.
Qore::ltrim
string ltrim(string str, *string chars)
Removes byte characters from the start of a string and returns the new string.
Qore
main Qore-language namespace
Definition: Pseudo_QC_All.dox.h:3
Qore::join
string join(string str,...)
Creates a string from separator string and a list of arguments.
Qore::reverse
nothing reverse()
This function variant does nothing at all; it is only included for backwards-compatibility with qore ...
Qore::f_printf
string f_printf(string fmt,...)
Outputs the string passed to standard output, using the first argument as a format string; enforces f...