PHP Developer''''s Dictionary- P91 doc

PHP Developer’s Dictionary IT-SC book 450 offset in the result set. Possible return values include int , real , blob , and string , as well as the others defined in the MySQL documentation. mysql_field_flags() Syntax string mysql_field_flags (int result, int field_offset) Description The mysql_field_flags() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the field flags for field specified by the field_offset in the result set. The flags are returned as a single-spaced string that can be further manipulated using the explode() function. The following flags can be reported not_null , primary_key , unique_key , multiple_key , blob , unsigned , zerofill , binary , enum , auto_increment , and timestamp . For backward compatibility, mysql_fieldflags() can be used. mysql_field_len() Syntax int mysql_field_len (int result, int field_offset) Description The mysql_field_len() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the length the field specified by the field_offset parameter in the result set. mysql_free_result() Syntax int mysql_free_result (int result) Description The mysql_free_result() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, frees all memory associated with the result set. This PHP Developer’s Dictionary IT-SC book 451 function is not typically used because a result set is freed automatically when the script completes its processing. mysql_insert_id() Syntax int mysql_insert_id ([int link_identifier]) Description The mysql_insert_id() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the ID that was automatically generated for an AUTO_INCREMENT column on the previous insert statement performed on the link_identifier connection. If the connection is not specified, the previous link is assumed. The return value will be 0 if no value was generated for the last statement. Note that the last ID generated can be retrieved using the internal MySQL function LAST_INSERT_ID() . If the column type is bigint, you must use the internal MySQL function instead of this function. mysql_list_fields() Syntax int mysql_list_fields (string database_name, string table_name [, int link_identifier ]) Description The mysql_list_fields() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns a pointer to information about the given table_name in the database_name using the link_identifier . The resulting list can be examined using mysql_field_flags() , mysql_field_len() , mysql_field_name() , and mysql_field_type() . The return value is a positive number representing the result identifier or FALSE if an error occurs. For backward compatibility, mysql_listfields() is also supported. mysql_list_dbs() Syntax int_mysql_list_dbs ([int link_identifier]) PHP Developer’s Dictionary IT-SC book 452 Description The mysql_list_dbs() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns a pointer to a list of the currently available databases on the MySQL daemon. Use the mysql_tablename() function to traverse the list. mysql_list_tables() Syntax int mysql_list_tables (string database, [, int link_identifier]) Description The mysql_list_tables() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns a pointer to a list of tables for the database . The mysql_tablename() function should be used to traverse the list. mysql_num_fields() Syntax int myssql_num_fields (int result) Description The mysql_num_fields() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the number of fields in the result set. For backward compatibility, mysql_numfields() is also supported. mysql_num_rows() Syntax int mysql_num_rows (int result) Description PHP Developer’s Dictionary IT-SC book 453 The mysql_num_rows() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the number of rows in a result set. This is valid only for select statements. If you need to determine the number of rows affected by an insert, update, or delete statement, you should use the mysql_affected_rows() function. For backward compatibility, the mysql_numrows() function is also supported. mysql_pconnect() Syntax int mysql_pconnect ([string hostname [:port] [:/path/to/socket] [, string username [, string password]]]) Description The mysql_pconnect() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, is used to establish a persistent connection to a MySQL server. The default host:port is localhost:3306 , the default username is the name of the user that owns the server process, and the default password is the empty string. The hostname parameter can also include a port or path to socket. If a persistent connection already exists, it will be returned instead and the connection is not closed on completion of a script's processing. mysql_query() Syntax int mysql_query (string query [, int link_identifier]) Description The mysql_query() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, sends the query to the server referenced by the link_identifier . If a link isn't specified, the last opened link is used. If no link is available, an attempt to establish one is made as though mysql_connect() were called with no arguments. Note that the query string should not end with a semicolon. The return value is TRUE for success and FALSE otherwise, although a TRUE return value doesn't guarantee that the query affected any rows of data or returned a result set. mysql_result() Syntax PHP Developer’s Dictionary IT-SC book 454 mixed mysql_result (int result, int row [, mixed field]) Description The mysql_result() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns the contents of a cell in the result set located at the row and optional field position. The field parameter can be the name, offset, or table name dot fieldname ( tablename . fieldname ). If the select statement used aliases, use those names instead of the column names. If obtaining multiple cells for one row, it is often quicker to fetch the entire row. Also, better performance can be achieved by using the offsets instead of the names. mysql_select_db() Syntax int mysql_select_db (string database_name [, int link_identifier]) Description The mysql_select_db() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, selects the current active database for the server referenced by the link_identifier parameter, and if no link is specified, the last opened link is used. If no link exists, the function tries to establish one. For backward compatibility, the mysql_selectdb() function is supported. mysql_tablename() Syntax string mysql_tablename int result, int i) Description The mysql_tablename() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, traverses the list returned from the mysql_list_ tables() function and returns the name of the table. The parameter i is used as an index into the list. ODBC . mysql_free_result() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, frees all memory associated with the result set. This PHP Developer’s Dictionary IT-SC book 451 function. link_identifier]) PHP Developer’s Dictionary IT-SC book 452 Description The mysql_list_dbs() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns. (int result) Description PHP Developer’s Dictionary IT-SC book 453 The mysql_num_rows() function, which is available from PHP 3.0 to PHP 3.0.16 along with PHP 4.0 and higher, returns