在给定的连接中,返回由最近的DELETE、INSERT、REPLACE或者UPDATE语句所作用的行数。如果没有行
被修改,则mysql_affected_rows()返回0,如果出现错误,则返回-1。
在SELECT查询之后,mysql_affected_rows()返回所选择的行数。但一般是与SELECT语句一道使用
mysql_num_rows().
使用范例:
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("samp_db") or die("Could not select database");
$query="INSERT INTO
member(last_name,first_name,expiration)"."VALUES('Brown','Marcia','2002-6-3')";
$result=mysql_query($query) or die("Query failed");
printf("%d row%s insertedn",mysql_affected_rows(),mysql_affected_rows()==1?" ":"s");
?>
(2) int mysql_close(int[link_id]);
关闭由link_id标识的与MySQL服务器的连接。如果没有指定连接,则mysql_close()关闭最近打开的连
接。如果成功,则mysql_close()返回真,失败则返回假。对由mysql_pconnect()打开的永久连接,
mysql_close()忽略相应的关闭请求,只是返回值。如果要关闭一个连接,就应该用mysql_connect()而不是
mysql_pconnect()来打开它。
使用范例:
$link=mysql_connect("localhost","sunsoft","suixiang") or die("Could not connect");
print("Connected successfully");
mysql_close($link);
?>
(3) int mysql_connect(string [hostname] [:port], string [username], string [password]);
本函式建立与 MySQL 伺服器的连线。其中所有的参数都可省略。当使用本函式却不加任何参数时,参
数 hostname 的内定值为 localhost、参数 username 的内定值为 PHP 执行行程的拥有者、参数 password 则
为空字串 (即没有密码)。而参数 hostname 后面可以加冒号与埠号,代表使用那个埠与 MySQL 连接。当然在
使用资料库时,早点使用 mysql_close() 将连线关掉可以节省资源。
使用范例
这是一位未具名网友提供的范例 (18-Feb-1999)
$dbh = mysql_connect('localhost:3306','mcclain','standard');
mysql_select_db('admreqs');
$query = "insert into requests(date, request, email, priority,status) values
(NOW(),'$description', '$email', '$priority', 'NEW')";
$res = mysql_query($query, $dbh);
$query = "select max(id) from requests";
$res = mysql_query($query, $dbh);
$err = mysql_error();
if($err){
echo "发生错误,请通知站长";
}
$row = mysql_fetch_row($res);
echo "未来您使用的号码为: ".$row[0];
?>
(4) int mysql_create_db(string db_name [, int link_id]);
告诉由link_id标识的MySQL服务器用给定的名称来创建数据库。如果数据库创建成功,则返回真;如
果出现错误,则返回假。必须在数据库有创建它的CREATE权限。
可能利用mysql_query()较利用mysql_create_db()发布CREATE DATABASE 语句更为适合。
$link=mysql_pconnect("localhost","sunsoft","suixiang"); or die("Could not connect");
if(mysql_create_db("my_db"))
print("Database created successfullyn");
else
print("Error creating database:%sn",mysql_error());
?>
由SELECT查询返回的每个结果集都有一个行游标,指示下一个提取行的函数(mysql_fetch_array()、
mysql_fetch_object()或者mysql_fetch_row())调用将返回哪一行。mysql_data_seek()将给定结果集
的指针设置到给定的行。行号的范围为0到mysql_num_rows()-1。如果行号合法,则mysql_data_seek()返回真,否则返回
假。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("samp_db") or die("Could not select database");
$query="SELECT last_name,first_name FROM president");
$result=mysql_query($query) or die("Query failed");
for($i=mysql_num_rows($result)-1;$i>=0;$i-)
{
if(!mysql_data_seek($result,$i);
{
printf("Cannot seek to row %dn",$i);
continue;
}
if(!$row=mysql_fetch_object($result)))
continue;
printf("%d %s
n",$row->last_name,$row->first_name);
}
mysql_free_result($result);
?>
(6) int mysql_db_query(string db_name, string query [, int link_id]);
mysql_db_query()除了提取一个额外的数据库名称参数,并在执行查询之前使它成为缺省的数据库为,与mysql_query()类似。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
print("Connected successfully");
$query="SELECT * FROM president";
$result=mysql_db_query("samp_db",$query) or die("Query failed");
?>
(7) int mysql_drop_db(string db_name, int [link_id]);
告诉由link_id标识的MySQL服务器用给定的名称来删除数据库。如果数据库删除成功,则返回真;如果出现错误,则返回假。必须有对数据库进行删除的DROP权限。
要小心这个函数;如果删除数据库,它就不存在了,且不能恢复。
使用mysql_query()较使用mysql_drop_db()发布DROP DATABASE 语句更为适合。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
if(mysql_drop_db("my_db"))
print("Database dropped successfullyn");
else
printf("Error dropping database:%sn",mysql_error());
?>
(8) int mysql_errno(int [link_id]);
对于给定的连接,返回含有最近返回状态的与MySQL相关的函数的错误号。零值意味着未出现错误。
使用范例
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
print("Connected successfully");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed,error code=".mysql_errno());
?>
(9) string mysql_error(int [link_id]);
对于给定的连接,返回含有最近返回状态的与MySQL相关的函数的错误消息字符串。空值意味着未出现错误。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
print("Connected successfully");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("query failed,error message=".mysql_error());
?>
(10)array mysql_fetch_array(int result, int [result_typ]);
本函式用来将
查询结果 result 拆到阵列变数中。若 result 没有资料,则传回 false 值。而本函式可以说是
mysql_fetch_row()
的加强函式,除可以将传回列及数字索引放入阵列之外,还可以将文字索引放入阵列中。若是好几个传回栏位都是相同的文字名称,则最后一个置入的栏位有效,解
决方法是使用数字索引或者为这些同名的栏位 (column) 取别名
(alias)。值得注意的是使用本函式的处理速度其实不会比mysql_fetch_row() 函式慢,要用哪个函式还是看使用的需求决定。参数
result_typ 是一个常数值,有以下几种常数 MYSQL_ASSOC、MYSQL_NUM 与 MYSQL_BOTH。
使用范例
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT last_name,first_name FROM president";
$result=mysql_query($query) or die("Query failed");
while($row=mysql_fetch_array($result))
{
printf("%s %s
",$row[0],$row[1]);
printf("%s %s
",$row["last_name"],$row["first_name"]);
}
mysql_free_result($result);
?>
(11) object mysql_fetch_field(int result [,int col_num]);
返回结
果集中给定列的相关元数据信息,如果没有这样的列,则返回假。如果省略col_num,则对mysql_fetch_field()的后继调用返回结果集
后续列的信息。如果不再有剩余的列。则返回值为假。如果指定了col_num,则其取值范围为0到mysql_num_fields()-1。在此情况
下,mysql_num_fields()返回给定列的相关信息,如果col_num超出范围,返回假。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("information for column %d:
",$i);
$meta=mysql_fetch_field($result);
if(!$meta)
{
print("No information available
");
continue;
}
print("
");
printf("blob: %s
",$meta->blob);
printf("max_length: %s
",$meta->max_length);
printf("multiple_key: %s
",$meta->multiple_key);
printf("name: %s
",$meta->name);
printf("not_null: %s
",$meta->not_null);
printf("numeric: %s
",$meta->numeric);
printf("primary_key: %s
",$meta->primary_key);
printf("table: %s
",$meta->table);
printf("type: %s
",$meta->type);
printf("unique_key: %s
",$meta->unique_key);
printf("unsigned: %s
",$meta->unsigned);
printf("zerofill: %s
",$meta->zerofill);
print("
");
}
?>
(12) array mysql_fetch_lengths(int result);
本函式将 mysql_fetch_row() 处理过的最后一列资料的各栏位资料最大长度放在阵列变数之中。若执行失败则传回 false 值。传回阵列的第一笔资料索引值是 0。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT * FROM president" or die("Query failed");
$row_num=0;
while(mysql_fetch_row($result))
{
++$row_num;
printf("Lengths of values in row %d:
",$row_num);
$len=mysql_fetch_lengths($result);
if(!$len)
{
print("No information available
");
break;
}
print("
");
for($i=0;$iprintf("Column %d: %s
",$i,$len[$i]);
print("
");
}
?>
13) object mysql_fetch_object(int result_id [, int result_typ]);
本
函式用来将查询结果 result 拆到物件变数中。使用方法和 mysql_fetch_array()
几乎相同,不同的地方在于本函式传回资料是物件而不是阵列。若 result 没有资料,则传回 false
值。另外值得注意的地方是,取回的物件资料的索引只能是文字而不能用数字,这是因为物件的特性。物件资料的特性中所有的属性(property)
名称都不能是数字,因此只好乖乖使用文字字串当索引了。参数 result_typ是一个常数值,有以下几种常数
MYSQL_ASSOC、MYSQL_NUM 与 MYSQL_BOTH。关于速度方面,本函式的处理速度几乎和mysql_fetch_row()
及 mysql_fetch_array() 二函式差不多,要用哪个函式还是看使用的需求决定。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT last_name,first_name FROM president";
$result=mysql_query($query) or die("Query failed");
while($row=mysql_fetch_object($result))
printf("%s %s
",$row->last_name,$row->first_name);
mysql_free_result($result);
?>
(14) array mysql_fetch_row(int result);
作为一个数组返回给定结果集的下一行,如果没有更多的行,则返回假。列值可作为数组元素访问,在0到mysql_num_fields()-1范围内使用列索引。
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT last_name,first_name FROM president";
$result=mysql_query($query) or die("Query failed");
while($row=mysql_fetch_row($result))
printf("%s %s
",$row[0],$row[1]);
mysql_free_result($result);
?>
(15) string mysql_field_name(int result, int field_index);
返回结果集的给定列的名称。
col_num 的范围为0到mysql_num_fields()-1.
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("Name of column %d:",$i);
$name=mysql_field_name($result,$i);
if(!$name)
print("No name available
");
else
print("$name
");
}
?>
(16) int mysql_field_seek(int result, int field_offset);
为随后的mysql_fetch_field()调用设置索引。发布没有明确列号的mysql_fetch_field()的下一次调用,将返回列col_num的信息。如果搜索成功,返回真,否则返回假。
col_num的范围为0到mysql_num_fields()-1.
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db") or die("Could not select database");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("Information for column %d:
",$i);
if(!mysql_field_seek($result,$i))
{
print("Cannot seek to colum
");
continue;
}
$meta=mysql_fetch_field($result,$i);
if(!$meta)
{
print("No information available
");
continue;
}
print("
");
printf("blob: %s
",$meta->blob);
printf("max_length: %s
",$meta->max_length);
printf("multiple_key: %s
",$meta->multiple_key);
printf("name: %s
",$meta->name);
printf("not_null: %s
",$meta->not_null);
printf("numeric: %s
",$meta->numeric);
printf("primary_key: %s
",$meta->primary_key);
printf("table: %s
",$meta->table);
printf("type: %s
",$meta->type);
printf("unique_key: %s
",$meta->unique_key);
printf("unsigned: %s
",$meta->unsigned);
printf("zerofill: %s
",$meta->zerofill);
print("
");
}
?>
(17) string mysql_field_table(int result_id, int col_num);
返回结果集给定列的表名。对于计算列,此名为空。
col_num的范围为0到mysql_num_fields()-1.
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
print("column $d:",$i);
printf("Name %s
",mysql_field_name($result,$i));
printf("Table %s
",mysql_field_nmae($result,$i));
print"
";
?>
(18) string mysql_field_type(int result_id, int col_num);
返回结果集给定列的类型名。类型名敬请等待参考本人的另外“MySQL列类型参考”。
col_num的范围为0到mysql_num_fields()-1.
$link=pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db");
$query="SELECT * FROM president";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("colum %d:",$i);
printf("Name %s,
",mysql_field_name($result,$i));
printf("Type %s
",mysql_field_type($result,$i));
}
?>
(19) string mysql_field_flags(int result_id, int col_num);
作为字符串返回结果集中给定列的相关元数据信息,如果出现错误,则返回假。这个字符串由以空格分开的词
组成,说明哪个列的标记值为真。对于假的标记,在字符串中给出相应的词。
col_num的范围为0到mysql_num_fields()-1.
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db");
$query="SELECT * FORM member";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("column %d:",$i);
printf("Name %s,
",mysql_fields_name($result,$i));
printf("Flags %s
",mysql_fields_flags($result,$i));
}
?>
(20) int mysql_field_len(int result, int field_offset);
返回结果集给定列中值可能的最大长度。
col_num的范围为0到mysql_num_fields()-1.
$link=mysql_pconnect("localhost","sunsoft","suixiang") or die("Could not connect");
mysql_select_db("stamp_db");
$query="SELECT * FROM member";
$result=mysql_query($query) or die("Query failed");
for($i=0;$i{
printf("Column %d:",$i);
printf("Name %s,
",mysql_field_name($result,$i));
printf("Len %d
",mysql_field_len($result,$i));
print"
";
}
?>