函數(shù)名稱：gmp_jacobi()

適用版本：PHP 5 >= 5.6.0, PHP 7

函數(shù)描述：計(jì)算雅可比符號(hào)（Jacobi symbol）

用法： gmp_jacobi ( GMP|int|string $a , GMP|int|string $p ) : int

參數(shù)：

• $a：一個(gè) GMP 對(duì)象，或一個(gè)整數(shù)字符串，或一個(gè)整數(shù)。
• $p：一個(gè) GMP 對(duì)象，或一個(gè)整數(shù)字符串，或一個(gè)整數(shù)。

返回值：

• 返回一個(gè)整數(shù)，表示雅可比符號(hào)的值。如果返回 1，則表示 $a 是一個(gè)二次剩余模 $p；如果返回 -1，則表示 $a 是一個(gè)二次非剩余模 $p；如果返回 0，則表示 $a 和 $p 不互素。

示例：

$a = 5;
$p = 7;

$result = gmp_jacobi($a, $p);
echo "Jacobi symbol of $a and $p is: $result"; // 輸出：Jacobi symbol of 5 and 7 is: -1

$a = gmp_init(10);
$p = gmp_init(13);

$result = gmp_jacobi($a, $p);
echo "Jacobi symbol of $a and $p is: $result"; // 輸出：Jacobi symbol of 10 and 13 is: 1

注意事項(xiàng)：

• 參數(shù) $a 和 $p 必須為正整數(shù)。
• 如果參數(shù) $a 或 $p 的值為負(fù)數(shù)，則函數(shù)會(huì)自動(dòng)取其絕對(duì)值進(jìn)行計(jì)算。
• 如果參數(shù) $p 的值為偶數(shù)或小于等于 1，則函數(shù)將返回 0。
• 該函數(shù)對(duì)于非整數(shù)參數(shù)會(huì)發(fā)出警告并返回 false。
• 在 PHP 7.4 之前的版本中，只能使用整數(shù)參數(shù)，無(wú)法接受 GMP 對(duì)象或整數(shù)字符串作為參數(shù)。