FFAStrans wiki

User Tools

Site Tools

Trace:
functions:other_functions

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
functions:other_functions [2023/11/24 16:19] – [$regext] emcodemfunctions:other_functions [2024/01/28 10:30] (current) – benjamin
Line 108: Line 108:
  
   * This is regular expression function. It extracts text based on recognition patterns. It uses the Perl Compatible Regular Expressions (PCRE) engine. http://www.pcre.org/   * This is regular expression function. It extracts text based on recognition patterns. It uses the Perl Compatible Regular Expressions (PCRE) engine. http://www.pcre.org/
-  * Additional documentation of the underlying function: https://www.autoitscript.com/autoit3/docs/functions/StringRegExp.htm 
-  * Special note about using https://regex101.com/ for testing regex expressions used in ffastrans: 
-    * To match ffastrans regex, you must set the delimiter (left of your regex) to something else than slash (/) and also remove all regex Flags (right to your regex) 
  
 Usage :\\ Usage :\\
-$regext(input string = "string/%variable%", regex_pattern = "string/%variable%", Flags = 0-2)+$regext(input string = "string/%variable%", pattern = "string/%variable%") 
 + 
 +$regext("<Duration value="1214"/>", "<Duration value="(\d+)"/>")  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  1214
  
-Examples :\\ 
-$regext("<Duration value="1214"/>", "<Duration value="(\d+)"/>")  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  1214\\ 
-Notice that in the above examples, we use () in order to specify which part we want to have returned, e.g. the numbers of the xml attribute "value" only\\ 
 $regext("TVShow_EP0013.mxf", "/(EP\d{4})/")  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  EP0013\\ $regext("TVShow_EP0013.mxf", "/(EP\d{4})/")  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  EP0013\\
- 
- 
-**Available regex Flags** as optional third parameter (default=0): 
- 
-  * 0: $STR_REGEXPARRAYMATCH 
-    * Default, returns only first match 
-  * 1: $STR_REGEXPARRAYGLOBALMATCH 
-    * Returns a JSON array containing all matches 
-  * 2: $STR_REGEXPARRAYGLOBALFULLMATCH 
-    * Full match is a very special and hard to use mode for experts 
- 
-**Flags Difference:**\\ 
-In this simple Example, we search for the regex "a" in the input string "aaa". Let's see how $regext behaves:\\ 
- 
-No Flag:\\ 
-<code>$regext("aaa", "a") --> a</code> 
-Flag 0:\\ 
-<code>$regext("aaa", "a",0) --> a</code>   
-Notice that flag 0 is the same as specifying no flag. It returns the first found match.\\\\ 
-Flag 1:\\ 
-<code>$regext("aaa", "a",1) -->  ["a","a","a"]</code>   
-Flag 2:\\ 
-Flag 2 has not yet been researched 
- 
-**Regex Modifier flags:** 
-Start your regex with any of these commands to get the desired effect:\\ 
- 
-(?i) case-insensitive  
-<code>$regext("aaa", "(?i)A") --> a</code>  
- 
-(?s) Single Line: dot matches newline. For this Example we need to read a text (or xml file as input)\\ 
-https://regex101.com/r/If58EQ/1 
- 
-(?m) Multiline: ^ and $ match start and end of line\\ 
-https://regex101.com/r/AbhL2r/1 
  
 ---------------------- ----------------------
Line 279: Line 240:
 $lookuprep('["joe", "bill", "greg"]', '["lucy", "evy", "jane"]', "lucylindajane")  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  $lookuprep('["joe", "bill", "greg"]', '["lucy", "evy", "jane"]', "lucylindajane")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 joelindagreg joelindagreg
 +
 +
 +-----------------------------
 +
 +===== $foreach =====
 +
 +  * This function will iterate and perform the desired operation on each data value. The result of each iteration will be put back into the array and presented as the new resulting array. Please note that the special keyword "%$%" represents unique data value of each iteration. The special keyword "%i%" represents each iteration number.
 +
 +
 +Usage : \\
 +$foreach(input string ="string/%variable%", input string ="OPERATION/%variable%")
 +
 +$foreach('["jack", "joe", "jill", "jane", "james", "jules"]', '$triml("%$%", 2)')  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 +["ck", "e", "ll", "ne", "mes", "les"]
 +
 +
 +$foreach('["jack", "joe", "jill", "jane", "james", "jules"]', '%i% - %$%')  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 +["1 - jack", "2 - joe", "3 - jill", "4 - jane", "5 - james", "6 - jules"]
 +
 +
 +$foreach('[10, 11, 12, 10, 20, -6]', '%$%-%i%')  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 +[9, 9, 9, 6, 15, -12]
  
 ----------------------------- -----------------------------
Line 296: Line 279:
 ["jack", "james", "jane", "jill", "joe", "jules"] ["jack", "james", "jane", "jill", "joe", "jules"]
  
 +-----------------------------
 +
 +===== $stringf =====
 +
 +  * This function works very much like the printf() function in C. It shares the same notation. The difference is that if you have multiple arguments you need to put them in an array.
 +
 +Usage : \\
 +
 +$stringf(input string ="string/%variable%", input data/array ="ARGUMENTS/%variable%")
 +
 +
 +$stringf('%05d', 12) {{:functions:FFAStrans_compute.jpg?nolink&50|}} 00012
 +
 +
 +$stringf('%02i\%02i\%04i', '[1,8,2021]') {{:functions:FFAStrans_compute.jpg?nolink&50|}} 01\08\2021
  
 ----------------------------- -----------------------------
  
-===== $foreach =====+===== $fsize =====
  
-  * This function will iterate and perform the desired operation on each data value. The result of each iteration will be put back into the array and presented as the new resulting array. Please note that the special keyword "%$%" represents unique data value of each iteration. The special keyword "%i%" represents each iteration number.+  * Get file size in bytes.
  
 +Usage : \\
 +
 +$fsize(input string ="string/%variable%")
 +
 +
 +$fsize("D:\Replace spaces in filename") {{:functions:FFAStrans_compute.jpg?nolink&50|}} 57162
 +
 +
 +-----------------------------
 +
 +===== $fext =====
 +
 +  * Get file extension.
  
 Usage : \\ Usage : \\
-$foreach(input string ="string/%variable%", input string ="OPERATION/%variable%") 
  
-$foreach('["jack", "joe", "jill", "jane", "james", "jules"]', '$triml("%$%", 2)')  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  +$fext(input string ="string/%variable%")
-["ck", "e", "ll", "ne", "mes", "les"]+
  
  
-$foreach('["jack", "joe", "jill", "jane", "james", "jules"]', '%i% - %$%')  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  +$fext("D:\Replace spaces in filename.mp4")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} mp4
-["1 - jack", "2 - joe", "3 - jill", "4 - jane", "5 - james", "6 - jules"]+
  
  
-$foreach('[10, 11, 12, 10, 20, -6]', '%$%-%i%')  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  +----------------------------- 
-[9, 9, 9, 6, 15, -12]+ 
 +===== $fname ===== 
 + 
 +  * Get file name. 
 + 
 +Usage : \\ 
 + 
 +$fname(input string ="string/%variable%") 
 + 
 + 
 +$fname("D:\my_file.mxf")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} my_file
  
  
 ----------------------------- -----------------------------
 +
 +
 +===== $fpath =====
 +
 +  * Get file path.
 +
 +Usage : \\
 +
 +$fpath(input string ="string/%variable%")
 +
 +
 +$fpath("D:\cool folder\right_here\my_file.mxf")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} D:\cool folder\right_here
 +
 +-----------------------------
 +
 +===== $fdrive =====
 +
 +  * Get drive path.
 +
 +Usage : \\
 +
 +$fdrive(input string ="string/%variable%")
 +
 +
 +$fdrive("D:\cool folder\right_here\my_file.mxf")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} D:
 +
 +-----------------------------
 +
 +
 +===== $asplit =====
 +
 +  * Splits an array string into a delimited string using the optional separator. Default separator is \r\n (carriage return and line feed).
 +
 +Usage : \\
 +
 +$asplit(input string/array ="string/%variable%"[, input string ="SEPARATOR/%variable%"])
 +
 +
 +$asplit("[6,2,4,3,5]", "|")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 6|2|3|4|5
 +
 +
 +$asplit('["jack", "joe", "jill", "jane", "james", "jules"]') {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 +
 +jack
 +
 +joe
 +
 +jill
 +
 +jane
 +
 +james
 +
 +jules
 +
 +
 +-----------------------------
 +
 +===== $ffconcat =====
 +
 +  * Creates a ffconcat version 1.0 compatible string for use with encoder input.
 +
 +Usage : \\
 +
 +$ffconcat(input string/array ="string/%variable%")
 +
 +
 +$ffconcat('["c:\myClips\video1.mov", "c:\myClips\video1.mov", "c:\myClips\video3.mov"]') {{:functions:FFAStrans_compute.jpg?nolink&50|}} 
 +
 +ffconcat version 1.0
 +
 +file 'c:\myClips\video1.mov'
 +
 +file 'c:\myClips\video2.mov'
 +
 +file 'c:\myClips\video3.mov'
 +
 +
 +-----------------------------
 +
 +===== $owner =====
 +
 +  * Find the domain owner of a file.
 +
 +Usage : \\
 +
 +$owner(input string ="string/%variable%")
 +
 +
 +$owner("D:\cool folder\right_here\my_file.mxf")   {{:functions:FFAStrans_compute.jpg?nolink&50|}} domain/ElonMusk
 +
 +
 +-----------------------------
 +
 +
 +===== $waccess =====
 +
 +  * Check if user running the ffastrans system has write access to the specified folder.
 +
 +Usage : \\
 +
 +$waccess(input string ="string/%variable%")
 +
 +
 +$waccess("D:\cool folder\right_here")  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 1
 +
 +
 +-----------------------------
 +
 +===== $dateweek =====
 +
 +  * Finds the date (year_month_mday) of any given year, week number, week day number and week start day.
 +
 +Usage : \\
 +
 +dateweek(input integer = integer/%variable%[, input integer = integer/%variable%, input integer = integer/%variable%, input string ="string/%variable%"])
 +
 +(find date of week no. 35, the second day of the week starting on monday)
 +$dateweek(1973, 35, 2, 'mon')  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 1973_08_28
 +
 +
 +-----------------------------
 +
 +===== $timecalc =====
 +
 +  * Calculates a new date/time by adding/subtracting a specified number of time intervals from an initial date/time. \\ 
 +y = year, M = month, d = day, w = week, h = hour, m = minute, s = second
 +
 +Usage : \\
 +
 +$timecalc(input integer = integer/%variable%[, input integer = integer/%variable%, input integer = integer/%variable%, input string ="string/%variable%"])
 +
 +(add 60 days)
 +$timecalc('d', 60, '2019/11/24')  {{:functions:FFAStrans_compute.jpg?nolink&50|}}  2020_01_23
 +
 +(add 3 hours)
 +$timecalc('h', 3, '2019/11/24 22:35:00')  {{:functions:FFAStrans_compute.jpg?nolink&50|}} 2019_11_25 01:35:00
 +
 +
 +-----------------------------
 +
 +===== $shortcut =====
 +
 +  * Parse the shortcut (Windows) or alias (MAC) and return the actual file path.
 +
 +Usage : \\
 +
 +$shortcut(input string ="string/%variable%")
 +
 +$shortcut("c:\users\myname\desktop\cool video.mkv - Shortcut.lnk") {{:functions:FFAStrans_compute.jpg?nolink&50|}}  \\server\some_share\projects\REALITY_SHOW\my video files\cool video.mkv
 +
 +-----------------------------
 +
 +
 <html>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</html>[[functions:other_functions|Back to top]] <html>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</html>[[functions:other_functions|Back to top]]
  
  
functions/other_functions.1700842797.txt.gz · Last modified: 2023/11/24 16:19 by emcodem
Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki