Internal functions/String functions - Revision history

Raffriff42: make redirect

2014-09-17T01:57:32Z

make redirect

Admin: 1 revision

2013-05-09T21:33:33Z

1 revision

Unreal666: /* String functions */

2012-11-12T04:14:47Z

‎String functions

New page

== String functions ==

They provide common operations on string variables.

* {{ScriptFunction|LCase|v2.07|LCase(string)}}
: Returns lower case of string.
: ''Examples:''
LCase("AviSynth") = "avisynth"

* {{ScriptFunction|UCase|v2.07|UCase(string)}}
: Returns upper case of string.
: ''Examples:''
UCase("AviSynth") = "AVISYNTH"

* {{ScriptFunction|StrLen|v2.07|StrLen(string)}}
: Returns length of string.
: ''Examples:''
StrLen("AviSynth") = 8

* {{ScriptFunction|RevStr|v2.07|RevStr(string)}}
: Returns string backwards.
: ''Examples:''
RevStr("AviSynth") = "htnySivA"

* {{ScriptFunction|LeftStr|v2.07|LeftStr(string, int)}}
: Returns first int number of characters.
: ''Examples:''
LeftStr("AviSynth", 3) = "Avi"

* {{ScriptFunction|RightStr|v2.07|RightStr(string, int)}}
: Returns last int number of characters.
: ''Examples:''
RightStr("AviSynth", 5) = "Synth"

* {{ScriptFunction|MidStr|v2.07|MidStr(string, int pos [, int length])}}
: Returns substring starting at ''pos'' for optional ''length'' or to end. ''pos''=1 specifies start.
: ''Examples:''
MidStr("AviSynth", 3, 2) = "iS"

* {{ScriptFunction|FindStr|v2.07|FindStr(string, substring)}}
: Returns position of substring within string (note this function is case-sensitive). Returns 0 if substring is not found.
: ''Examples:''
Findstr("AviSynth", "Syn") = 4

* {{ScriptFunction|FillStr|v2.60|FillStr(int [, string])}}
: Fills a string. When int>1 it concatenates the string int times. String is space by default.
: ''Examples:''
FillStr(1, "AviSynth") = "AviSynth"
FillStr(2, "AviSynth") = "AviSynthAviSynth"

* {{ScriptFunction|StrCmp|v2.60|StrCmp(string, string)}}
: Compares two character strings. The comparison is case-sensitive. If the first string is less than the second string, the return value is negative. If it's greater, the return value is positive. If they are equal, the return value is zero. (The actual value seems to be language dependent so it can't be relied upon.)
: ''Examples:''
StrCmp("AviSynth", "AviSynth") = 0 # strings are equal.
StrCmp("AviSynth", "Avisynth") != 0 # strings are not equal.

* {{ScriptFunction|StrCmpi|v2.60|StrCmpi(string, string)}}
: Compares two character strings. The comparison is not case-sensitive. If the first string is less than the second string, the return value is negative. If it's greater, the return value is positive. If they are equal, the return value is zero. (The actual value seems to be language dependent so it can't be relied upon.)
: ''Examples:''
StrCmpi("AviSynth", "AviSynth") = 0 # strings are equal.
StrCmpi("AviSynth", "Avisynth") = 0 # strings are equal.
StrCmpi("abcz", "abcdefg") != 0 # returns the difference betweeen "z" and "d" (which is positive).

* {{ScriptFunction|Chr|v2.51|Chr(int)}}
: Returns the ASCII character.
: Note that characters above the ASCII character set (ie above 127) are code page dependent and may render different (visual) results in different systems. This has an importance only for user-supplied localised text messages.
: ''Examples:''
Chr(34) returns the quote character
Chr(9) returns the tab character

* {{ScriptFunction|Ord|v2.60|Ord(string)}}
: Gives the ordinal number of the first character of a string.
: ''Examples:''
Ord("a") = 97
Ord("AviSynth") = Ord("A") = 65
Ord("§") = 167

* {{ScriptFunction|Time|v2.51|Time(string)}}
: Returns a string with the current system time formatted as defined by the string.
: The string may contain any of the codes for output formatting presented below:
{| border=1 cellspacing=1 cellpadding=4
|-
! Code
! Description
|-
| %a
%A
| Abbreviated weekday name
Full weekday name
|-
| %b
%B
| Abbreviated month name
Full month name
|-
| %c
| Date and time representation appropriate for locale
|-
| %d
| Day of month as decimal number (01 ? 31)
|-
| %H
%I
| Hour in 24-hour format (00 ? 23)
Hour in 12-hour format (01 ? 12)
|-
| %j
| Day of year as decimal number (001 ? 366)
|-
| %m
| Month as decimal number (01 ? 12)
|-
| %M
| Minute as decimal number (00 ? 59)
|-
| %p
| Current locale?s A.M./P.M. indicator for 12-hour clock
|-
| %S
| Second as decimal number (00 ? 59)
|-
| %U
| Week of year as decimal number, with Sunday as first day of week (00 ? 53)
|-
| %w
| Weekday as decimal number (0 ? 6; Sunday is 0)
|-
| %W
| Week of year as decimal number, with Monday as first day of week (00 ? 53)
|-
| %x
| Date representation for current locale
|-
| %X
| Time representation for current locale
|-
| %y
%Y
| Year without century, as decimal number (00 ? 99)
Year ''with'' century, as decimal number
|-
| %z, %Z
| Time-zone name or abbreviation; no characters if time zone is unknown
|-
| %%
| Percent sign
|}
: The # flag may prefix any formatting code. In that case, the meaning of the format code is changed as follows:
{| border=1 cellspacing=1 cellpadding=4
|-
! Code with # flag
! Change in meaning
|-
| %#a, %#A, %#b, %#B,
%#p, %#X, %#z, %#Z, %#%
| No change; # flag is ignored.
|-
| %#c
| Long date and time representation, appropriate for current locale. For example:
?Tuesday, March 14, 1995, 12:41:29?.
|-
| %#x
| Long date representation, appropriate to current locale. For example:
?Tuesday, March 14, 1995?.
|-
| %#d, %#H, %#I, %#j, %#m, %#M,
%#S, %#U, %#w, %#W, %#y, %#Y
| Remove leading zeros (if any).
|}

----
Back to [[Internal functions]].

[[Category:AviSynth_Syntax]]
[[Category:Scripting_Basics]]

@@ Line 1: / Line 1: @@
-== String functions ==
+#REDIRECT [[Internal_functions#String_functions]]
 [[Category:AviSynth_Syntax]]
 [[Category:Scripting_Basics]]