https://www.memcp.org/index.php?action=history&feed=atom&title=Strings
Strings - Revision history
2026-04-24T16:47:39Z
Revision history for this page on the wiki
MediaWiki 1.39.1
https://www.memcp.org/index.php?title=Strings&diff=222&oldid=prev
Aiagent: Created page with "= Strings = The '''Strings''' module provides comprehensive string manipulation and processing functions for the SCM programming language. This module includes: * '''String validation''': Functions to check string types and properties (string?, strlen) * '''String manipulation''': Concatenation (concat), substring extraction (substr), and case conversion (toLower, toUpper) * '''Pattern matching''': Wildcard pattern matching (strlike) and string replacement (replace) *..."
2025-08-25T16:35:52Z
<p>Created page with "= Strings = The '''Strings''' module provides comprehensive string manipulation and processing functions for the SCM programming language. This module includes: * '''String validation''': Functions to check string types and properties (string?, strlen) * '''String manipulation''': Concatenation (concat), substring extraction (substr), and case conversion (toLower, toUpper) * '''Pattern matching''': Wildcard pattern matching (strlike) and string replacement (replace) *..."</p>
<p><b>New page</b></p><div>= Strings =<br />
<br />
The '''Strings''' module provides comprehensive string manipulation and processing functions for the SCM programming language. This module includes:<br />
<br />
* '''String validation''': Functions to check string types and properties (string?, strlen)<br />
* '''String manipulation''': Concatenation (concat), substring extraction (substr), and case conversion (toLower, toUpper)<br />
* '''Pattern matching''': Wildcard pattern matching (strlike) and string replacement (replace)<br />
* '''String parsing''': Splitting strings (split) and data type simplification (simplify)<br />
* '''Encoding/Decoding''': URL encoding/decoding, HTML entities, JSON processing, and binary conversion<br />
* '''Internationalization''': Collation support for natural sorting and language-specific comparisons<br />
<br />
These functions provide the essential tools for text processing, data formatting, and string-based operations in SCM programs.<br />
<br />
← Back to [[Full SCM API documentation]]<br />
<br />
== string? ==<br />
<br />
tells if the value is a string<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>any</code>): value<br />
<br />
'''Returns:''' <code>bool</code><br />
<br />
== concat ==<br />
<br />
concatenates stringable values and returns a string<br />
<br />
'''Allowed number of parameters:''' 1–1000<br />
<br />
'''Parameters:'''<br />
* '''value...''' (<code>any</code>): values to concat<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== substr ==<br />
<br />
returns a substring<br />
<br />
'''Allowed number of parameters:''' 2–3<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to cut<br />
* '''start''' (<code>number</code>): first character index<br />
* '''len''' (<code>number</code>): optional length<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== simplify ==<br />
<br />
turns a stringable input value in the easiest-most value (e.g. turn strings into numbers if they are numeric<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>any</code>): value to simplify<br />
<br />
'''Returns:''' <code>any</code><br />
<br />
== strlen ==<br />
<br />
returns the length of a string<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
<br />
'''Returns:''' <code>int</code><br />
<br />
== strlike ==<br />
<br />
matches the string against a wildcard pattern (SQL compliant)<br />
<br />
'''Allowed number of parameters:''' 2–3<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
* '''pattern''' (<code>string</code>): pattern with % and _ in them<br />
* '''collation''' (<code>string</code>): collation in which to compare them<br />
<br />
'''Returns:''' <code>bool</code><br />
<br />
== toLower ==<br />
<br />
turns a string into lower case<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== toUpper ==<br />
<br />
turns a string into upper case<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== replace ==<br />
<br />
replaces all occurances in a string with another string<br />
<br />
'''Allowed number of parameters:''' 3–3<br />
<br />
'''Parameters:'''<br />
* '''s''' (<code>string</code>): input string<br />
* '''find''' (<code>string</code>): search string<br />
* '''replace''' (<code>string</code>): replace string<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== split ==<br />
<br />
splits a string using a separator or space<br />
<br />
'''Allowed number of parameters:''' 1–2<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
* '''separator''' (<code>string</code>): (optional) parameter, defaults to " "<br />
<br />
'''Returns:''' <code>list</code><br />
<br />
== collate ==<br />
<br />
returns the <code><</code> operator for a given collation. MemCP allows natural sorting of numeric literals.<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''collation''' (<code>string</code>): collation string of the form LANG or LANG_cs or LANG_ci where LANG is a BCP 47 code, for compatibility to MySQL, a CHARSET_ prefix is allowed and ignored as well as the aliases bin, danish, general, german1, german2, spanish and swedish are allowed for language codes<br />
* '''reverse''' (<code>bool</code>): whether to reverse the order like in ORDER BY DESC<br />
<br />
'''Returns:''' <code>func</code><br />
<br />
== htmlentities ==<br />
<br />
escapes the string for use in HTML<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): input string<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== urlencode ==<br />
<br />
encodes a string according to URI coding schema<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to encode<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== urldecode ==<br />
<br />
decodes a string according to URI coding schema<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to decode<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== json_encode ==<br />
<br />
encodes a value in JSON, treats lists as lists<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>any</code>): value to encode<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== json_encode_assoc ==<br />
<br />
encodes a value in JSON, treats lists as associative arrays<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>any</code>): value to encode<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== json_decode ==<br />
<br />
parses JSON into a map<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to decode<br />
<br />
'''Returns:''' <code>any</code><br />
<br />
== sql_unescape ==<br />
<br />
unescapes the inner part of a sql string<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to decode<br />
<br />
'''Returns:''' <code>string</code><br />
<br />
== bin2hex ==<br />
<br />
turns binary data into hex with lowercase letters<br />
<br />
'''Allowed number of parameters:''' 1–1<br />
<br />
'''Parameters:'''<br />
* '''value''' (<code>string</code>): string to decode<br />
<br />
'''Returns:''' <code>string</code></div>
Aiagent