t3lib_div Class Reference

List of all members.

Public Member Functions

 trimExplode ($delim, $string, $onlyNonEmptyValues=0)
 dirname ($path)
 revExplode ($delim, $string, $count=0)
 getIndpEnv ($getEnvName)
 _GP ($var)
 _GET ($var=NULL)
 _POST ($var=NULL)
 _GETset ($inputGet, $key='')
 GPvar ($var, $strip=0)
 GParrayMerged ($var)
 gif_compress ($theFile, $type)
 png_to_gif_by_imagemagick ($theFile)
 read_png_gif ($theFile, $output_png=0)
 fixed_lgd ($string, $origChars, $preStr='...')
 fixed_lgd_pre ($string, $chars)
 fixed_lgd_cs ($string, $chars)
 breakTextForEmail ($str, $implChar="\n", $charWidth=76)
 breakLinesForEmail ($str, $implChar="\n", $charWidth=76)
 cmpIP ($baseIP, $list)
 cmpIPv4 ($baseIP, $list)
 cmpIPv6 ($baseIP, $list)
 IPv6Hex2Bin ($hex)
 normalizeIPv6 ($address)
 validIPv6 ($ip)
 cmpFQDN ($baseIP, $list)
 inList ($list, $item)
 rmFromList ($element, $list)
 expandList ($list)
 intInRange ($theInt, $min, $max=2000000000, $zeroValue=0)
 intval_positive ($theInt)
 int_from_ver ($verNumberStr)
 compat_version ($verNumberStr)
 md5int ($str)
 shortMD5 ($input, $len=10)
 uniqueList ($in_list, $secondParameter=NULL)
 split_fileref ($fileref)
 dirname ($path)
 modifyHTMLColor ($color, $R, $G, $B)
 modifyHTMLColorAll ($color, $all)
 rm_endcomma ($string)
 danish_strtoupper ($string)
 convUmlauts ($str)
 testInt ($var)
 isFirstPartOfStr ($str, $partStr)
 formatSize ($sizeInBytes, $labels='')
 convertMicrotime ($microtime)
 splitCalc ($string, $operators)
 calcPriority ($string)
 calcParenthesis ($string)
 htmlspecialchars_decode ($value)
 deHSCentities ($str)
 slashJS ($string, $extended=0, $char="'")
 rawUrlEncodeJS ($str)
 rawUrlEncodeFP ($str)
 validEmail ($email)
 formatForTextarea ($content)
 inArray ($in_array, $item)
 intExplode ($delim, $string)
 revExplode ($delim, $string, $count=0)
 trimExplode ($delim, $string, $onlyNonEmptyValues=0)
 uniqueArray ($valueArray)
 removeArrayEntryByValue ($array, $cmpValue)
 implodeArrayForUrl ($name, $theArray, $str='', $skipBlank=0, $rawurlencodeParamName=0)
 explodeUrl2Array ($string, $multidim=FALSE)
 compileSelectedGetVarsFromArray ($varList, $getArray, $GPvarAlt=1)
 addSlashesOnArray (&$theArray)
 stripSlashesOnArray (&$theArray)
 slashArray ($arr, $cmd)
 array_merge_recursive_overrule ($arr0, $arr1, $notAddKeys=0, $includeEmtpyValues=true)
 array_merge ($arr1, $arr2)
 csvValues ($row, $delim=',', $quote='"')
 get_tag_attributes ($tag)
 split_tag_attributes ($tag)
 implodeAttributes ($arr, $xhtmlSafe=FALSE, $dontOmitBlankAttribs=FALSE)
 implodeParams ($arr, $xhtmlSafe=FALSE, $dontOmitBlankAttribs=FALSE)
 wrapJS ($string, $linebreak=TRUE)
 xml2tree ($string, $depth=999)
 array2xml_cs ($array, $docTag='phparray', $options=array(), $charset='')
 array2xml ($array, $NSprefix='', $level=0, $docTag='phparray', $spaceInd=0, $options=array(), $stackData=array())
 xml2array ($string, $NSprefix='', $reportDocTag=FALSE)
 xmlRecompileFromStructValArray ($vals)
 xmlGetHeaderAttribs ($xmlData)
 getURL ($url, $includeHeader=0)
 writeFile ($file, $content)
 fixPermissions ($file)
 writeFileToTypo3tempDir ($filepath, $content)
 mkdir ($theNewFolder)
 mkdir_deep ($destination, $deepDir)
 get_dirs ($path)
 getFilesInDir ($path, $extensionList='', $prependPath=0, $order='')
 getAllFilesAndFoldersInPath ($fileArr, $path, $extList='', $regDirs=0, $recursivityLevels=99)
 removePrefixPathFromList ($fileArr, $prefixToRemove)
 fixWindowsFilePath ($theFile)
 resolveBackPath ($pathStr)
 locationHeaderUrl ($path)
 debug_ordvalue ($string, $characters=100)
 view_array ($array_in)
 print_array ($array_in)
 debug ($var="", $brOrHeader=0)
 debug_trail ()
 debugRows ($rows, $header='')
 getThisUrl ()
 linkThisScript ($getParams=array())
 linkThisUrl ($url, $getParams=array())
 getIndpEnv ($getEnvName)
 milliseconds ()
 clientInfo ($useragent='')
 getFileAbsFileName ($filename, $onlyRelative=1, $relToTYPO3_mainDir=0)
 validPathStr ($theFile)
 isAbsPath ($path)
 isAllowedAbsPath ($path)
 verifyFilenameAgainstDenyPattern ($filename)
 upload_copy_move ($source, $destination)
 upload_to_tempfile ($uploadedFileName)
 unlink_tempfile ($uploadedTempFileName)
 tempnam ($filePrefix)
 stdAuthCode ($uid_or_record, $fields='', $codeLength=8)
 cHashParams ($addQueryParams)
 hideIfNotTranslated ($l18n_cfg_fieldValue)
 readLLfile ($fileRef, $langKey)
 readLLXMLfile ($fileRef, $langKey)
 llXmlAutoFileName ($fileRef, $language)
 loadTCA ($table)
 resolveSheetDefInDS ($dataStructArray, $sheet='sDEF')
 resolveAllSheetsInDS ($dataStructArray)
 callUserFunction ($funcName, &$params, &$ref, $checkPrefix='user_', $silent=0)
& getUserObj ($classRef, $checkPrefix='user_', $silent=0)
& makeInstance ($className)
 makeInstanceClassName ($className)
& makeInstanceService ($serviceType, $serviceSubType='', $excludeServiceKeys=array())
 plainMailEncoded ($email, $subject, $message, $headers='', $enc='', $charset='', $dontEncodeHeader=false)
 quoted_printable ($string, $maxlen=76)
 encodeHeader ($line, $enc='', $charset='ISO-8859-1')
 substUrlsInPlainText ($message, $urlmode='76', $index_script_url='')
 makeRedirectUrl ($inUrl, $l=0, $index_script_url='')
 freetypeDpiComp ($font_size)
 initSysLog ()
 sysLog ($msg, $extKey, $severity=0)
 devLog ($msg, $extKey, $severity=0, $dataVar=FALSE)
 arrayToLogString ($arr, $valueList=array(), $valueLength=20)
 imageMagickCommand ($command, $parameters, $path='')
 unQuoteFilenames ($parameters, $unQuote=FALSE)
 quoteJSvalue ($value, $inScriptTags=false)

Detailed Description

Definition at line 10 of file incfile.php.

Member Function Documentation

t3lib_div._GET (  $  var = NULL  ) 
 

Returns the global GET array (or value from) normalized to contain un-escaped values. ALWAYS use this API function to acquire the GET variables! Usage: 27

Parameters:
string Optional pointer to value in GET array (basically name of GET var)
Returns:
mixed If $var is set it returns the value of $_GET[$var]. If $var is NULL (default), returns $_GET itself. In any case *slashes are stipped from the output!*
See also:
_POST(), _GP(), _GETset()

Definition at line 280 of file class.t3lib_div.php.

t3lib_div._GETset (  $  inputGet,
$  key = ''
) 
 

Writes input value to $_GET Usage: 2

Parameters:
array Array to write to $_GET. Values should NOT be escaped at input time (but will be escaped before writing according to TYPO3 standards).
string Alternative key; If set, this will not set the WHOLE GET array, but only the key in it specified by this value!
Returns:
void

Definition at line 313 of file class.t3lib_div.php.

t3lib_div._GP (  $  var  ) 
 

Returns the 'GLOBAL' value of incoming data from POST or GET, with priority to POST (that is equalent to 'GP' order) Strips slashes from all output, both strings and arrays. This function substitutes t3lib_div.GPvar() To enhancement security in your scripts, please consider using t3lib_div._GET or t3lib_div._POST if you already know by which method your data is arriving to the scripts! Usage: 537

Parameters:
string GET/POST var to return
Returns:
mixed POST var named $var and if not set, the GET var of the same name.
See also:
GPvar()

Definition at line 262 of file class.t3lib_div.php.

t3lib_div._POST (  $  var = NULL  ) 
 

Returns the global POST array (or value from) normalized to contain un-escaped values. ALWAYS use this API function to acquire the POST variables! Usage: 41

Parameters:
string Optional pointer to value in POST array (basically name of POST var)
Returns:
mixed If $var is set it returns the value of $_POST[$var]. If $var is NULL (default), returns $_POST itself. In any case *slashes are stipped from the output!*
See also:
_GET(), _GP()

Definition at line 297 of file class.t3lib_div.php.

t3lib_div.addSlashesOnArray (  &$  theArray  ) 
 

AddSlash array This function traverses a multidimentional array and adds slashes to the values. NOTE that the input array is and argument by reference.!! Twin-function to stripSlashesOnArray Usage: 8

Parameters:
array Multidimensional input array, (REFERENCE!)
Returns:
array

Definition at line 1587 of file class.t3lib_div.php.

t3lib_div.array2xml (  $  array,
$  NSprefix = '',
$  level = 0,
$  docTag = 'phparray',
$  spaceInd = 0,
$  options = array(),
$  stackData = array()
) 
 

Deprecated to call directly (unless you are aware of using XML prologues)! Use "array2xml_cs" instead (which adds an XML-prologue)

Converts a PHP array into an XML string. The XML output is optimized for readability since associative keys are used as tagnames. This also means that only alphanumeric characters are allowed in the tag names AND only keys NOT starting with numbers (so watch your usage of keys!). However there are options you can set to avoid this problem. Numeric keys are stored with the default tagname "numIndex" but can be overridden to other formats) The function handles input values from the PHP array in a binary-safe way; All characters below 32 (except 9,10,13) will trigger the content to be converted to a base64-string The PHP variable type of the data IS preserved as long as the types are strings, arrays, integers and booleans. Strings are the default type unless the "type" attribute is set. The output XML has been tested with the PHP XML-parser and parses OK under all tested circumstances with 4.x versions. However, with PHP5 there seems to be the need to add an XML prologue a la <?xml version="1.0" encoding="[charset]" standalone="yes" ?> - otherwise UTF-8 is assumed! Unfortunately, many times the output from this function is used without adding that prologue meaning that non-ASCII characters will break the parsing!! This suchs of course! Effectively it means that the prologue should always be prepended setting the right characterset, alternatively the system should always run as utf-8! However using MSIE to read the XML output didn't always go well: One reason could be that the character encoding is not observed in the PHP data. The other reason may be if the tag-names are invalid in the eyes of MSIE. Also using the namespace feature will make MSIE break parsing. There might be more reasons... Usage: 5

Parameters:
array The input PHP array with any kind of data; text, binary, integers. Not objects though.
string tag-prefix, eg. a namespace prefix like "T3:"
integer Current recursion level. Don't change, stay at zero!
string Alternative document tag. Default is "phparray".
integer If set, the number of spaces corresponding to this number is used for indenting, otherwise a single chr(9) (TAB) is used
array Options for the compilation. Key "useNindex" => 0/1 (boolean: whether to use "n0, n1, n2" for num. indexes); Key "useIndexTagForNum" => "[tag for numerical indexes]"; Key "useIndexTagForAssoc" => "[tag for associative indexes"; Key "parentTagMap" => array('parentTag' => 'thisLevelTag')
string Stack data. Don't touch.
Returns:
string An XML string made from the input content in the array.
See also:
xml2array()

Definition at line 1999 of file class.t3lib_div.php.

t3lib_div.array2xml_cs (  $  array,
$  docTag = 'phparray',
$  options = array(),
$  charset = ''
) 
 

Turns PHP array into XML. See array2xml()

Parameters:
array The input PHP array with any kind of data; text, binary, integers. Not objects though.
string Alternative document tag. Default is "phparray".
array Options for the compilation. See array2xml() for description.
string Forced charset to prologue
Returns:
string An XML string made from the input content in the array.
See also:
xml2array(),array2xml()

Definition at line 1958 of file class.t3lib_div.php.

t3lib_div.array_merge (  $  arr1,
$  arr2
) 
 

An array_merge function where the keys are NOT renumbered as they happen to be with the real php-array_merge function. It is "binary safe" in the sense that integer keys are overridden as well. Usage: 16

Parameters:
array First array
array Second array
Returns:
array Merged result.

Definition at line 1683 of file class.t3lib_div.php.

t3lib_div.array_merge_recursive_overrule (  $  arr0,
$  arr1,
$  notAddKeys = 0,
$  includeEmtpyValues = true
) 
 

Merges two arrays recursively and "binary safe" (integer keys are overridden as well), overruling similar values in the first array ($arr0) with the values of the second array ($arr1) In case of identical keys, ie. keeping the values of the second. Usage: 0

Parameters:
array First array
array Second array, overruling the first array
boolean If set, keys that are NOT found in $arr0 (first array) will not be set. Thus only existing value can/will be overruled from second array.
boolean If set, values from $arr1 will overrule if they are empty. Default: true
Returns:
array Resulting array where $arr1 values has overruled $arr0 values

Definition at line 1650 of file class.t3lib_div.php.

t3lib_div.arrayToLogString (  $  arr,
$  valueList = array(),
$  valueLength = 20
) 
 

Converts a one dimensional array to a one line string which can be used for logging or debugging output Example: "loginType: FE; refInfo: Array; HTTP_HOST: www.example.org; REMOTE_ADDR: 192.168.1.5; REMOTE_HOST:; security_level:; showHiddenRecords: 0;"

Parameters:
array Data array which should be outputted
mixed List of keys which should be listed in the output string. Pass a comma list or an array. An empty list outputs the whole array.
integer Long string values are shortened to this length. Default: 20
Returns:
string Output string with key names and their value as string

Definition at line 4396 of file class.t3lib_div.php.

t3lib_div.breakLinesForEmail (  $  str,
$  implChar = "\n",
$  charWidth = 76
) 
 

Breaks up a single line of text for emails Usage: 5

Parameters:
string The string to break up
string The string to implode the broken lines with (default/typically
)
integer The line length
Returns:
string
See also:
breakTextForEmail()

Definition at line 574 of file class.t3lib_div.php.

t3lib_div.breakTextForEmail (  $  str,
$  implChar = "\n",
$  charWidth = 76
) 
 

Breaks up the text for emails Usage: 1

Parameters:
string The string to break up
string The string to implode the broken lines with (default/typically
)
integer The line length
Returns:
string

Definition at line 555 of file class.t3lib_div.php.

t3lib_div.calcParenthesis (  $  string  ) 
 

Calculates the input with parenthesis levels Usage: 2

Parameters:
string Input string, eg "(123 + 456) / 789 - 4"
Returns:
integer Calculated value. Or error string.
See also:
calcPriority(), tslib_cObj.stdWrap()

Definition at line 1258 of file class.t3lib_div.php.

t3lib_div.calcPriority (  $  string  ) 
 

Calculates the input by +,-,*,/,%,^ with priority to + and - Usage: 1

Parameters:
string Input string, eg "123 + 456 / 789 - 4"
Returns:
integer Calculated value. Or error string.
See also:
calcParenthesis()

Definition at line 1217 of file class.t3lib_div.php.

t3lib_div.callUserFunction (  $  funcName,
&$  params,
&$  ref,
$  checkPrefix = 'user_',
$  silent = 0
) 
 

Calls a userdefined function/method in class Such a function/method should look like this: "function proc(&$params, &$ref) {...}" Usage: 17

Parameters:
string Function/Method reference, '[file-reference":"]["&"]class/function["->"method-name]'. You can prefix this reference with "[file-reference]:" and t3lib_div::getFileAbsFileName() will then be used to resolve the filename and subsequently include it by "require_once()" which means you don't have to worry about including the class file either! Example: "EXT:realurl/class.tx_realurl.php:&tx_realurl->encodeSpURL". Finally; you can prefix the class name with "&" if you want to reuse a former instance of the same object call ("singleton").
mixed Parameters to be pass along (typically an array) (REFERENCE!)
mixed Reference to be passed along (typically "$this" - being a reference to the calling object) (REFERENCE!)
string Required prefix of class or function name
boolean If set, no debug() error message is shown if class/function is not present.
Returns:
mixed Content from method/function call
See also:
getUserObj()

Definition at line 3756 of file class.t3lib_div.php.

t3lib_div.cHashParams (  $  addQueryParams  ) 
 

Splits the input query-parameters into an array with certain parameters filtered out. Used to create the cHash value

Parameters:
string Query-parameters: "&xxx=yyy&zzz=uuu"
Returns:
array Array with key/value pairs of query-parameters WITHOUT a certain list of variable names (like id, type, no_cache etc) and WITH a variable, encryptionKey, specific for this server/installation
See also:
tslib_fe.makeCacheHash(), tslib_cObj.typoLink()

Definition at line 3440 of file class.t3lib_div.php.

t3lib_div.clientInfo (  $  useragent = ''  ) 
 

Client Browser Information Usage: 4

Parameters:
string Alternative User Agent string (if empty, t3lib_div.getIndpEnv('HTTP_USER_AGENT') is used)
Returns:
array Parsed information about the HTTP_USER_AGENT in categories BROWSER, VERSION, SYSTEM and FORMSTYLE

Definition at line 3155 of file class.t3lib_div.php.

t3lib_div.cmpFQDN (  $  baseIP,
$  list
) 
 

Match fully qualified domain name with list of strings with wildcard

Parameters:
string The current remote IP address for instance, typ. REMOTE_ADDR
string A comma-list of domain names to match with. *-wildcard allowed but cannot be part of a string, so it must match the full host name (eg. myhost.*.com => correct, myhost.*domain.com => wrong)
Returns:
boolean True if a domain name mask from $list matches $baseIP

Definition at line 805 of file class.t3lib_div.php.

t3lib_div.cmpIP (  $  baseIP,
$  list
) 
 

Match IP number with list of numbers with wildcard Dispatcher method for switching into specialised IPv4 and IPv6 methods. Usage: 10

Parameters:
string $baseIP is the current remote IP address for instance, typ. REMOTE_ADDR
string $list is a comma-list of IP-addresses to match with. *-wildcard allowed instead of number, plus leaving out parts in the IP number is accepted as wildcard (eg. 192.168.*.* equals 192.168). If list is "*" no check is done and the function returns TRUE immediately.
Returns:
boolean True if an IP-mask from $list matches $baseIP

Definition at line 610 of file class.t3lib_div.php.

t3lib_div.cmpIPv4 (  $  baseIP,
$  list
) 
 

Match IPv4 number with list of numbers with wildcard

Parameters:
string $baseIP is the current remote IP address for instance, typ. REMOTE_ADDR
string $list is a comma-list of IP-addresses to match with. *-wildcard allowed instead of number, plus leaving out parts in the IP number is accepted as wildcard (eg. 192.168.*.* equals 192.168)
Returns:
boolean True if an IP-mask from $list matches $baseIP

Definition at line 626 of file class.t3lib_div.php.

t3lib_div.cmpIPv6 (  $  baseIP,
$  list
) 
 

Match IPv6 address with a list of IPv6 prefixes

Parameters:
string $baseIP is the current remote IP address for instance
string $list is a comma-list of IPv6 prefixes, could also contain IPv4 addresses
Returns:
boolean True if an baseIP matches any prefix

Definition at line 668 of file class.t3lib_div.php.

t3lib_div.compat_version (  $  verNumberStr  ) 
 

Returns true if the current TYPO3 version (or compatibility version) is compatible to the input version

Parameters:
string Minimum version number required (format x.y.z)
Returns:
boolean true or false

Definition at line 934 of file class.t3lib_div.php.

t3lib_div.compileSelectedGetVarsFromArray (  $  varList,
$  getArray,
$  GPvarAlt = 1
) 
 

Returns an array with selected keys from incoming data. (Better read source code if you want to find out...) Usage: 3

Parameters:
string List of variable/key names
array Array from where to get values based on the keys in $varList
boolean If set, then t3lib_div._GP() is used to fetch the value if not found (isset) in the $getArray
Returns:
array Output array with selected variables.

Definition at line 1564 of file class.t3lib_div.php.

t3lib_div.convertMicrotime (  $  microtime  ) 
 

Returns microtime input to milliseconds Usage: 2

Parameters:
string Microtime
Returns:
integer Microtime input string converted to an integer (milliseconds)

Definition at line 1181 of file class.t3lib_div.php.

t3lib_div.convUmlauts (  $  str  ) 
 

Change umlaut characters to plain ASCII with normally two character target Only known characters will be converted, so don't expect a result for any character. (DEPRECATED: Works only for western europe single-byte charsets! Use t3lib_cs.specCharsToASCII() instead!)

ä => ae, Ö => Oe

Parameters:
string String to convert.
Returns:
string

Definition at line 1105 of file class.t3lib_div.php.

t3lib_div.csvValues (  $  row,
$  delim = ',',
$  quote = '"'
) 
 

Takes a row and returns a CSV string of the values with $delim (default is ,) and $quote (default is ") as separator chars. Usage: 5

Parameters:
array Input array of values
string Delimited, default is comman
string Quote-character to wrap around the values.
Returns:
string A single line of CSV

Definition at line 1696 of file class.t3lib_div.php.

t3lib_div.danish_strtoupper (  $  string  ) 
 

strtoupper which converts danish (and other characters) characters as well (DEPRECATED, use t3lib_cs.conv_case() instead or for HTML output, wrap your content in ...) Usage: 0

Parameters:
string String to process
Returns:
string

Definition at line 1090 of file class.t3lib_div.php.

t3lib_div.debug (  $  var = "",
$  brOrHeader = 0
) 
 

Makes debug output Prints $var in bold between two vertical lines If not $var the word 'debug' is printed If $var is an array, the array is printed by t3lib_div.print_array() Usage: 8

Parameters:
mixed Variable to print
mixed If the parameter is a string it will be used as header. Otherwise number of break tags to apply after (positive integer) or before (negative integer) the output.
Returns:
void

Definition at line 2756 of file class.t3lib_div.php.

t3lib_div.debug_ordvalue (  $  string,
$  characters = 100
) 
 

Returns a string with a list of ascii-values for the first $characters characters in $string Usage: 0

Parameters:
string String to show ASCII value for
integer Number of characters to show
Returns:
string The string with ASCII values in separated by a space char.

Definition at line 2696 of file class.t3lib_div.php.

t3lib_div.debug_trail (   ) 
 

Displays the "path" of the function call stack in a string, using debug_backtrace

Returns:
string

Definition at line 2787 of file class.t3lib_div.php.

t3lib_div.debugRows (  $  rows,
$  header = ''
) 
 

Displays an array as rows in a table. Useful to debug output like an array of database records.

Parameters:
array Array of arrays with similar keys
string Table header
Returns:
void Outputs to browser.

Definition at line 2809 of file class.t3lib_div.php.

t3lib_div.deHSCentities (  $  str  ) 
 

Re-converts HTML entities if they have been converted by htmlspecialchars() Usage: 10

Parameters:
string String which contains eg. "&amp;amp;" which should stay "&amp;". Or "&amp;#1234;" to "&#1234;". Or "&amp;#x1b;" to "&#x1b;"
Returns:
string Converted result.

Definition at line 1299 of file class.t3lib_div.php.

t3lib_div.devLog (  $  msg,
$  extKey,
$  severity = 0,
$  dataVar = FALSE
) 
 

Developer log; This should be implemented around the source code, both frontend and backend, logging everything from the flow through an application, messages, results from comparisons to fatal errors. The result is meant to make sense to developers during development or debugging of a site. The idea is that this function is only a wrapper for external extensions which can set a hook which will be allowed to handle the logging of the information to any format they might wish and with any kind of filter they would like. If you want to implement the devLog in your applications, simply add lines like: if (TYPO3_DLOG) t3lib_div.devLog('[write message in english here]', 'extension key');

Parameters:
string Message (in english).
string Extension key (from which extension you are calling the log)
integer Severity: 0 is info, 1 is notice, 2 is warning, 3 is fatal error, -1 is "OK" message
array Additional data you want to pass to the logger.
Returns:
void

Definition at line 4375 of file class.t3lib_div.php.

t3lib_div.dirname (  $  path  ) 
 

Returns the directory part of a path without trailing slash If there is no dir-part, then an empty string is returned. Behaviour:

'/dir1/dir2/script.php' => '/dir1/dir2' '/dir1/' => '/dir1' 'dir1/script.php' => 'dir1' 'd/script.php' => 'd' '/script.php' => '' '' => '' Usage: 5

Parameters:
string Directory name / path
Returns:
string Processed input value. See function description.

Definition at line 1030 of file class.t3lib_div.php.

t3lib_div.dirname (  $  path  ) 
 

Definition at line 23 of file incfile.php.

t3lib_div.encodeHeader (  $  line,
$  enc = '',
$  charset = 'ISO-8859-1'
) 
 

Encode header lines Email headers must be ASCII, therefore they will be encoded to quoted_printable (default) or base64.

Parameters:
string Content to encode
string Encoding type: "base64" or "quoted-printable". Default value is "quoted-printable".
string Charset used for encoding
Returns:
string The encoded string

Definition at line 4119 of file class.t3lib_div.php.

t3lib_div.expandList (  $  list  ) 
 

Expand a comma-separated list of integers with ranges (eg 1,3-5,7 becomes 1,3,4,5,7). Ranges are limited to 1000 values per range.

Parameters:
string comma-separated list of integers with ranges (string)
Returns:
string new comma-separated list of items
Author:
Martin Kutschker <martin.kutschker@activesolution.at>

Definition at line 863 of file class.t3lib_div.php.

t3lib_div.explodeUrl2Array (  $  string,
$  multidim = FALSE
) 
 

Explodes a string with GETvars (eg. "&id=1&type=2&ext[mykey]=3") into an array

Parameters:
string GETvars string
boolean If set, the string will be parsed into a multidimensional array if square brackets are used in variable names (using PHP function parse_str())
Returns:
array Array of values. All values AND keys are rawurldecoded() as they properly should be. But this means that any implosion of the array again must rawurlencode it!
See also:
implodeArrayForUrl()

Definition at line 1538 of file class.t3lib_div.php.

t3lib_div.fixed_lgd (  $  string,
$  origChars,
$  preStr = '...'
) 
 

Truncate string Returns a new string of max. $chars length. If the string is longer, it will be truncated and appended with '...'. DEPRECATED. Works ONLY for single-byte charsets! USE t3lib_div.fixed_lgd_cs() instead Usage: 39

Parameters:
string string to truncate
integer must be an integer with an absolute value of at least 4. if negative the string is cropped from the right end.
string String to append to the output if it is truncated, default is '...'
Returns:
string new string
See also:
fixed_lgd_pre()

Definition at line 499 of file class.t3lib_div.php.

t3lib_div.fixed_lgd_cs (  $  string,
$  chars
) 
 

Truncates a string with appended/prepended "..." and takes backend character set into consideration Use only from backend! Usage: 75

Parameters:
string string to truncate
integer must be an integer with an absolute value of at least 4. if negative the string is cropped from the right end.
Returns:
string New string
See also:
fixed_lgd()

Definition at line 538 of file class.t3lib_div.php.

t3lib_div.fixed_lgd_pre (  $  string,
$  chars
) 
 

Truncate string Returns a new string of max. $chars length. If the string is longer, it will be truncated and prepended with '...'. This works like fixed_lgd, but is truncated in the start of the string instead of the end DEPRECATED. Use either fixed_lgd() or fixed_lgd_cs() (with negative input value for $chars) Usage: 6

Parameters:
string string to truncate
integer must be an integer of at least 4
Returns:
string new string
See also:
fixed_lgd()

Definition at line 524 of file class.t3lib_div.php.

t3lib_div.fixPermissions (  $  file  ) 
 

Setting file system mode & group ownership of file

Parameters:
string Filepath of newly created file
Returns:
void

Definition at line 2397 of fil