updated more function descriptions
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpeclipse / phpeditor / phpsyntax.xml
index 3824b20..c952eaa 100644 (file)
@@ -7,7 +7,7 @@
         <phpsyntax function="COM_invoke" usage="mixed COM_invoke(int module, string handler_name [, mixed arg [, mixed ...]])">Invokes a COM module</phpsyntax>
         <phpsyntax function="COM_load" usage="int com_load(string module_name [, string remote_host [, int codepage [, string typelib]]])">Loads a COM module</phpsyntax>
         <phpsyntax function="abs" usage="int abs(int number)">Return the absolute value of the number</phpsyntax>
-        <phpsyntax function="accept_connect"></phpsyntax>
+<phpsyntax function="accept_connect"></phpsyntax>
         <phpsyntax function="acos" usage="float acos(float arg)">Return the arc cosine of the arg in radians</phpsyntax>
         <phpsyntax function="acosh" usage="float acosh(float arg)">Returns the inverse hyperbolic cosine of arg</phpsyntax>
         <phpsyntax function="add"></phpsyntax>
@@ -20,7 +20,7 @@ It escapes \n, \r etc. in C-like style, characters with ASCII code lower than 32
 higher than 126 are converted to octal representation.</phpsyntax>
         <phpsyntax function="addentry"></phpsyntax>
         <phpsyntax function="addfill"></phpsyntax>
-        <phpsyntax function="addshape"></phpsyntax>
+        <phpsyntax function="addshape"></phpsyntax> 
         <phpsyntax function="addslashes" usage="string addslashes (string str)">
 Returns a string with backslashes before characters that need to be quoted in database queries etc. 
 These characters are single quote ('), double quote (&quot;), backslash (\) and NUL (the NULL byte).</phpsyntax>
@@ -40,7 +40,7 @@ back to the operating system.
 This performs a partial request for a URI. It goes just far enough to obtain all the important information 
 about the given resource and returns this information in a class.
         </phpsyntax>
-        <phpsyntax function="apache_note"></phpsyntax>
+        <phpsyntax function="apache_note" usage="string apache_note ( string note_name [, string note_value])">apache_note() is an Apache-specific function which gets and sets values in a request's notes table. If called with one argument, it returns the current value of note note_name. If called with two arguments, it sets the value of note note_name to note_value and returns the previous value of note note_name.</phpsyntax>
         <phpsyntax function="apache_sub_req"></phpsyntax>
         <phpsyntax function="array_count_values"></phpsyntax>
         <phpsyntax function="array_diff"></phpsyntax>
@@ -67,45 +67,65 @@ about the given resource and returns this information in a class.
         <phpsyntax function="array_unshift"></phpsyntax>
         <phpsyntax function="array_values"></phpsyntax>
         <phpsyntax function="array_walk"></phpsyntax>
-        <phpsyntax function="arsort"></phpsyntax>
-        <phpsyntax function="asin"></phpsyntax>
-        <phpsyntax function="asort"></phpsyntax>
-        <phpsyntax function="aspell_check"></phpsyntax>
-        <phpsyntax function="aspell_check_raw"></phpsyntax>
-        <phpsyntax function="aspell_new"></phpsyntax>
-        <phpsyntax function="aspell_suggest"></phpsyntax>
-        <phpsyntax function="assert"></phpsyntax>
-        <phpsyntax function="assert_options"></phpsyntax>
-        <phpsyntax function="atan"></phpsyntax>
-        <phpsyntax function="atan2"></phpsyntax>
-        <phpsyntax function="base64_decode"></phpsyntax>
-        <phpsyntax function="base64_encode"></phpsyntax>
-        <phpsyntax function="base_convert"></phpsyntax>
-        <phpsyntax function="basename"></phpsyntax>
-        <phpsyntax function="bcadd"></phpsyntax>
-        <phpsyntax function="bccomp"></phpsyntax>
-        <phpsyntax function="bcdiv"></phpsyntax>
-        <phpsyntax function="bcmod"></phpsyntax>
-        <phpsyntax function="bcmul"></phpsyntax>
-        <phpsyntax function="bcpow"></phpsyntax>
-        <phpsyntax function="bcscale"></phpsyntax>
-        <phpsyntax function="bcsqrt"></phpsyntax>
-        <phpsyntax function="bcsub"></phpsyntax>
-        <phpsyntax function="bin2hex"></phpsyntax>
-        <phpsyntax function="bind"></phpsyntax>
+        <phpsyntax function="arsort" usage="void arsort ( array array [, int sort_flags])">This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant.</phpsyntax>
+        <phpsyntax function="asin" usage="float asin ( float arg)">Returns the arc sine of arg in radians. asin() is the complementary function of sin(), which means that a==sin(asin(a)) for every value of a that is within asin() 's range.</phpsyntax>
+        <phpsyntax function="asort" usage="void asort ( array array [, int sort_flags])">This function sorts an array such that array indices maintain their correlation with the array elements they are associated with. This is used mainly when sorting associative arrays where the actual element order is significant.</phpsyntax>
+        <phpsyntax function="aspell_check" usage="bool aspell_check ( int dictionary_link, string word)">aspell_check() checks the spelling of a word and returns TRUE if the spelling is correct, FALSE if not.</phpsyntax>
+        <phpsyntax function="aspell_check_raw" usage="bool aspell_check_raw ( int dictionary_link, string word)">aspell_check_raw() checks the spelling of a word, without changing its case or trying to trim it in any way and returns TRUE if the spelling is correct, FALSE if not.</phpsyntax>
+        <phpsyntax function="aspell_new" usage="int aspell_new ( string master [, string personal])">aspell_new() opens up a new dictionary and returns the dictionary link identifier for use in other aspell functions. Returns FALSE on error.</phpsyntax>
+        <phpsyntax function="aspell_suggest" usage="array aspell_suggest ( int dictionary_link, string word)">aspell_suggest() returns an array of possible spellings for the given word.</phpsyntax>
+        <phpsyntax function="assert" usage="int assert ( mixed assertion)">
+assert() will check the given assertion and take appropriate action if its result is FALSE .
+
+If the assertion is given as a string it will be evaluated as PHP code by assert(). The advantages of a string assertion are less overhead when assertion checking is off and messages containing the assertion expression when an assertion fails. This means that if you pass a boolean condition as assertion this condition will not show up as parameter to the assertion function which you may have defined with the assert_options() function, the condition is converted to a string before calling that handler function, and the boolean FALSE is converted as the empty string.</phpsyntax>
+        <phpsyntax function="assert_options" usage="mixed assert_options ( int what [, mixed value])">Using assert_options() you may set the various assert() control options or just query their current settings.</phpsyntax>
+        <phpsyntax function="atan" usage="loat atan ( float arg)">Returns the arc tangent of arg in radians. atan() is the complementary function of tan(), which means that a==tan(atan(a)) for every value of a that is within atan()'s range.</phpsyntax>
+        <phpsyntax function="atan2" usage="float atan2 ( float y, float x)">
+This function calculates the arc tangent of the two variables xand y. It is similar to calculating the arc tangent of y/x, except that the signs of both arguments are used to determine the quadrant of the result. 
+
+The function returns the result in radians, which is between -PI and PI (inclusive)</phpsyntax>
+        <phpsyntax function="base64_decode" usage="string base64_decode ( string encoded_data)">base64_decode() decodes encoded_data and returns the original data. The returned data may be binary.</phpsyntax>
+        <phpsyntax function="base64_encode" usage="string base64_encode ( string data)">base64_encode returns data encoded with base64. This encoding is designed to make binary data survive transport through transport layers that are not 8-bit clean, such as mail bodies.</phpsyntax>
+        <phpsyntax function="base_convert" usage="string base_convert ( string number, int frombase, int tobase)">Returns a string containing number represented in base tobase. The base in which number is given is specified in frombase. Both frombase and tobase have to be between 2 and 36, inclusive. Digits in numbers with a base higher than 10 will be represented with the letters a-z, with a meaning 10, b meaning 11 and z meaning 35.</phpsyntax>
+        <phpsyntax function="basename" usage="string basename ( string path [, string suffix])">Given a string containing a path to a file, this function will return the base name of the file. If the filename ends in suffix this will also be cut off.</phpsyntax>
+        <phpsyntax function="bcadd" usage="string bcadd ( string left_operand, string right_operand [, int scale])">Adds the left_operand to the right_operand and returns the sum in a string. The optional scale parameter is used to set the number of digits after the decimal place in the result.</phpsyntax>
+        <phpsyntax function="bccomp" usage="int bccomp ( string left_operand, string right_operand [, int scale])">Compares the left_operand to the right_operand and returns the result as an integer. The optional scale parameter is used to set the number of digits after the decimal place which will be used in the comparison. The return value is 0 if the two operands are equal. If the left_operand is larger than the right_operand the return value is +1 and if the left_operand is less than the right_operand the return value is -1.</phpsyntax>
+        <phpsyntax function="bcdiv" usage="string bcdiv ( string left_operand, string right_operand [, int scale])">Divides the left_operand by the right_operand and returns the result. The optional scale sets the number of digits after the decimal place in the result. </phpsyntax>
+        <phpsyntax function="bcmod" usage="string bcmod ( string left_operand, string modulus)">Get the modulus of the left_operand using modulus.</phpsyntax>
+        <phpsyntax function="bcmul" usage="string bcmul ( string left_operand, string right_operand [, int scale])">Multiply the left_operand by the right_operand and returns the result. The optional scale sets the number of digits after the decimal place in the result.</phpsyntax>
+        <phpsyntax function="bcpow" usage="string bcpow ( string x, int y [, int scale])">Raise x to the power y. The optional scale can be used to set the number of digits after the decimal place in the result.</phpsyntax>
+        <phpsyntax function="bcscale" usage="string bcscale ( int scale)">This function sets the default scale parameter for all subsequent bc math functions that do not explicitly specify a scale parameter.</phpsyntax>
+        <phpsyntax function="bcsqrt" usage="string bcsqrt ( string operand [, int scale])">Return the square root of the operand. The optional scale parameter sets the number of digits after the decimal place in the result.</phpsyntax>
+        <phpsyntax function="bcsub" usage="string bcsub ( string left_operand, string right_operand [, int scale])">Subtracts the right_operand from the left_operand and returns the result in a string. The optional scale parameter is used to set the number of digits after the decimal place in the result.</phpsyntax>
+        <phpsyntax function="bin2hex" usage="string bin2hex ( string str)">Returns an ASCII string containing the hexadecimal representation of str. The conversion is done byte-wise with the high-nibble first.</phpsyntax>
+               <phpsyntax function="bind"></phpsyntax>
         <phpsyntax function="bindec"></phpsyntax>
-        <phpsyntax function="bindtextdomain"></phpsyntax>
-        <phpsyntax function="build_iovec"></phpsyntax>
-        <phpsyntax function="bzclose"></phpsyntax>
-        <phpsyntax function="bzcompress"></phpsyntax>
-        <phpsyntax function="bzdecompress"></phpsyntax>
-        <phpsyntax function="bzerrno"></phpsyntax>
-        <phpsyntax function="bzerror"></phpsyntax>
-        <phpsyntax function="bzerrstr"></phpsyntax>
-        <phpsyntax function="bzflush"></phpsyntax>
-        <phpsyntax function="bzopen"></phpsyntax>
-        <phpsyntax function="bzread"></phpsyntax>
-        <phpsyntax function="bzwrite"></phpsyntax>
+        <phpsyntax function="bindec" usage="int bindec ( string binary_string)">
+Returns the decimal equivalent of the binary number represented by the binary_string argument. 
+
+bindec() converts a binary number to an integer. The largest number that can be converted is 31 bits of 1's or 2147483647 in decimal.</phpsyntax>
+        <phpsyntax function="bindtextdomain" usage="string bindtextdomain ( string domain, string directory)">The bindtextdomain() function sets the path for a domain.</phpsyntax>
+        <phpsyntax function="bzclose" usage="int bzclose ( resource bz)">Closes the bzip2 file referenced by the pointer bz.</phpsyntax>
+        <phpsyntax function="bzcompress" usage="string bzcompress ( string source [, int blocksize [, int workfactor]])">
+bzcompress() compresses the source string and returns it as bzip2 encoded data. 
+
+The optional parameter blocksize specifies the blocksize used during compression and should be a number from 1 to 9 with 9 giving the best compression, but using more resources to do so. blocksize defaults to 4. 
+
+The optional parameter workfactor controls how the compression phase behaves when presented with worst case, highly repetitive, input data. The value can be between 0 and 250 with 0 being a special case and 30 being the default value. Regardless of the workfactor, the generated output is the same.</phpsyntax>
+        <phpsyntax function="bzdecompress" usage="string bzdecompress ( string source [, int small])">bzdecompress() decompresses the source string containing bzip2 encoded data and returns it. If the optional parameter small is TRUE , an alternative decompression algorithm will be used which uses less memory (the maximum memory requirement drops to around 2300K) but works at roughly half the speed.</phpsyntax>
+        <phpsyntax function="bzerrno" usage="int bzerrno ( resource bz)">Returns the error number of any bzip2 error returned by the file pointer bz.</phpsyntax>
+        <phpsyntax function="bzerror" usage="array bzerror ( resource bz)">Returns the error number and error string, in an associative array, of any bzip2 error returned by the file pointer bz.</phpsyntax>
+        <phpsyntax function="bzerrstr" usage="string bzerrstr ( resource bz)">Returns the error string of any bzip2 error returned by the file pointer bz.</phpsyntax>
+        <phpsyntax function="bzflush" usage="int bzflush ( resource bz)">
+Forces a write of all buffered bzip2 data for the file pointer bz.
+
+Returns TRUE on success or FALSE on failure.</phpsyntax>
+        <phpsyntax function="bzopen" usage="resource bzopen ( string filename, string mode)">
+Opens a bzip2 (.bz2) file for reading or writing. filename is the name of the file to open. mode is similar to the fopen() function (`r' for read, `w' for write, etc.). 
+
+If the open fails, the function returns FALSE, otherwise it returns a pointer to the newly opened file.</phpsyntax>
+        <phpsyntax function="bzread" usage="string bzread ( resource bz [, int length])">bzread() reads up to length bytes from the bzip2 file pointer referenced by bz. Reading stops when length (uncompressed) bytes have been read or EOF is reached, whichever comes first. If the optional parameter length is not specified, bzread() will read 1024 (uncompressed) bytes at a time.</phpsyntax>
+        <phpsyntax function="bzwrite" usage="int bzwrite ( resource bz, string data [, int length])">bzwrite() writes the contents of the string data to the bzip2 file stream pointed to by bz. If the optional length argument is given, writing will stop after length (uncompressed) bytes have been written or the end of string is reached, whichever comes first.</phpsyntax>
         <phpsyntax function="call_user_func"></phpsyntax>
         <phpsyntax function="call_user_func_array"></phpsyntax>
         <phpsyntax function="call_user_method"></phpsyntax>