mysql_affected_rows

(PHP 4, PHP 5)

mysql_affected_rows ā€” Ɩnceki MySQL işleminde etkilenen satırların sayısını al

Uyarı

Bu eklentinin kullanımı PHP 5.5.0 itibariyle ƶnerilmemekte olup PHP 7.0.0'da kaldırılmıştır. Bu eklentinin yerine ya mysqli ya da PDO_MySQL eklentisi kullanılmalıdır. MySQL API seƧerken MySQL API'ye Bakış belgesi yardımcı olabilir. Bu işlevin yerine kullanılabilecekler:

AƧıklama

function mysql_affected_rows(resource $bağlantı_belirteci = null): int

bağlantı_belirteci ile ilişkili son INSERT, UPDATE, REPLACE veya DELETE sorgusundan etkilenen satır sayısını dƶndĆ¼rĆ¼r.

Bağımsız Değişkenler

bağlantı_belirteci

MySQL bağlantısı. Eğer bağlantı belirteci belirtilmemişse mysql_connect() tarafından aƧılan son bağlantı kullanılmaya Ƨalışılır. Eğer bƶyle bir bağlantı yoksa mysql_connect() bağımsız değişkensiz olarak Ƨağrılmış gibi bir bağlantı oluşturmaya Ƨalışır. HiƧbir bağlantı yoksa ve yenisi de kurulamazsa E_WARNING seviyesinde bir hata Ć¼retilir.

Dƶnen Değerler

Son sorgunun başarılı olması durumunda etkilenen satırların sayısını dƶndĆ¼rĆ¼r; başarısız olması durumunda -1 dƶndĆ¼rĆ¼r.

Eğer son sorgu, WHERE şartı iƧermeyen bir DELETE sorgusuysa, tablodaki bĆ¼tĆ¼n kayıtlar silinmiş demektir, ancak bu işlev MySQL'in 4.1.2'den ƶnceki sĆ¼rĆ¼mlerinde 0 dƶndĆ¼rĆ¼r.

UPDATE'i kullanırken, MySQL yeni değerleri eski değerleri ile aynı olan sĆ¼tunları dĆ¼zeltmez. Bu da mysql_affected_rows()'un muhtemelen uyan tĆ¼m satırların değil, sadece sorgu sonucu gerƧekten dĆ¼zeltilen satırların sayısını dƶndĆ¼rmesine neden olur.

REPLACE ifadesi aynı birincil anahtara sahip olan kayıtları siler, daha sonra yeni kaydı girer. Bu işlev silinen kayıtların sayısı artı girilen kayıtların sayısını dƶndĆ¼rĆ¼r.

"INSERT ... ON DUPLICATE KEY UPDATE" sorgularında, yerleştirme yapılmışsa 1, mevcut satır gĆ¼ncellenmişse 2 dƶner.

Ɩrnekler

Ɩrnek 1 - mysql_affected_rows() ƶrneği

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Bağlanamadı: ' . mysql_error());
}
mysql_select_db('mydb');

/* bu silinen kayıtların gerƧek sayısını dƶndĆ¼rmeli */
mysql_query('DELETE FROM mytable WHERE id < 10');
printf("Silinen kayıtlar: %d\n", mysql_affected_rows());

/* WHERE şartıyla asla true olmaz, 0 dƶndĆ¼rmeli */
mysql_query('DELETE FROM mytable WHERE 0');
printf("Silinen kayıtlar: %d\n", mysql_affected_rows());
?>

Yukarıdaki ƶrnek şuna benzer bir Ƨıktı Ć¼retir:

Silinen kayıtlar: 10
Silinen kayıtlar: 0

Ɩrnek 2 - Hareket kullananılan mysql_affected_rows() ƶrneği

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Bağlanamadı: ' . mysql_error());
}
mysql_select_db('mydb');

/* Kayıtları gĆ¼ncelle */
mysql_query("UPDATE mytable SET used=1 WHERE id < 10");
printf ("GĆ¼ncellenen kayıtlar: %d\n", mysql_affected_rows());
mysql_query("COMMIT");
?>

Yukarıdaki ƶrnek şuna benzer bir Ƨıktı Ć¼retir:

GĆ¼ncellenen kayıtlar: 10

Notlar

Bilginize: Hareketler
Eğer hareketleri kullanıyorsanız mysql_affected_rows() işlevini INSERT, UPDATE veya DELETE sorgunuzdan sonra, ama COMMIT'den ƶnce kullanmalısınız.

Bilginize: SELECT Deyimleri
Bir SELECT sorgusundan dƶndĆ¼rĆ¼len satırların sayısını almak iƧin, mysql_num_rows() işlevini kullanmak mĆ¼mkĆ¼ndĆ¼r.

Bilginize: Birleşik Yabancı Anahtarlar
mysql_affected_rows() yabancı anahtar kısıtlarındaki ON DELETE CASCADE ve/veya ON UPDATE CASCADE kullanımları Ć¼zerinden dolaylı olarak etkilenen satırları saymaz.

Ayrıca Bakınız

Found A Problem?

Learn How To Improve This Page ā€¢ Submit a Pull Request ā€¢ Report a Bug
ļ¼‹add a note

User Contributed Notes

There are no user contributed notes for this page.