This shows you the differences between two versions of the page.
— |
pass [2007/03/02 02:32] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | # $EPIC: pass.txt,v 1.4 2007/03/02 02:32:04 jnelson Exp $ | ||
+ | ======Synopsis:====== | ||
+ | $__strip__(<chars> <text>) \\ | ||
+ | $__pass__(<chars> <text>) | ||
+ | |||
+ | ======Technical:====== | ||
+ | * The <chars> argument is a [[what is a word|dword]] which is different from most functions. | ||
+ | * If the <chars> argument is omitted the empty string is returned. | ||
+ | * If the <text> argument is omitted the empty string is returned. | ||
+ | * The return value for $strip() is a copy of <text> from which every instance of any character in <chars> has been removed. | ||
+ | * The return value for $pass() is a copy of <text> from which every instance of any character not in <chars> has been removed. | ||
+ | |||
+ | ======Practical:====== | ||
+ | These functions can be useful to remove dangerous or unwanted | ||
+ | characters from a text string. | ||
+ | |||
+ | ======Returns:====== | ||
+ | $strip(): <text> with all of the characters in <chars> removed. \\ | ||
+ | $pass(): <text> with all of the characters not in <chars> removed. | ||
+ | |||
+ | ======Examples:====== | ||
+ | <file> | ||
+ | $strip(aeoiu hello there) returns "hll thr" | ||
+ | $pass(aeoiu hello there) returns "eoee" | ||
+ | </file> | ||
+ | |||
+ | ======History:====== | ||
+ | This function originally appeared in ircII-2.1.5 | ||