PHPの構文の読み方について教えて下さい

Question

初学者です。

入門用テキストや、PHPの公式サイトを参照すると
以下のような解説があります（構文というのでしょうか？）。例えば printf関数について見てみると以下のような事が出てきます。他の関数等について調べても同様です。
あまり気にしていいなかったのですがやはり理解したいと思います

printf ( string $format , mixed ...$values ) : int

この場合、string　は「文字列」、$formatは「書式文字列」, mixedは型は「数値、文字列、浮動小数点など何でもいい」,　...$values 「引数の値」　という解釈でいいのでしょうか？

int printf( string $format [, mixed $args [, ・・・]])

こちらも同じ意味かと思います。①ただをつけている意味が判然としません。「ない場合はなくても良い」というような意味なのでしょうか？

②またHP公式サイト、入門用テキストの両方とも int がついています。これは戻り値のことかと思います。
自分の中では「 (int) (integer). 整数型への変換」としか解釈出来ません。
しかし、下に記述しているPHPでは返ってくるのは文字列、浮動小数点です。
色々ウェブサイトを探していると、「［1］を表す」というようなのを見かけたのですが何のことかわかりません。

①がついている意味について
②int の意味について

上記2点初学者でもわかるように教えていただけないでしょうか？

＜引用＞

(PHP公式)
https://www.php.net/manual/ja/function.printf.php
printf — フォーマット済みの文字列を出力する
(PHP 4, PHP 5, PHP 7, PHP 8)

printf ( string $format , mixed ...$values ) : int

---

構文　printf関数((独習PHP第3版))

int printf( string $format [, mixed $args [, ・・・]])

---

＜記述＞

<?php

printf('%sは%sです。','きなこ','ハムスター');

echo "<br>\n";

printf("売上平均(前月比): %+0-8.3f",  0.198765);


?>

---

＜表示結果＞

きなこはハムスターです。
売上平均(前月比): +0.19900

Comments

[yh1224]

回答は他の方で十分と思いますので、これだけ言わせてください。

初学で公式リファレンスを読めるようになりたいという姿勢、素晴らしいですね！
一次情報は最も信頼できるものですから、どんどん活用していきましょう！

Answer 1

構文の説明で使われる [ ] は普通は、省略可能な部分という意味です。

a[, b[, c]]であれば、a a, b a, b, cの3通りが可能です。

intは返り値の型です。

$x = printf(～～～);と書くと$xの値は int型です。

どんな整数値かは、「返り値」の蘭に書いてあります。

出力した文字列の長さを返します。

$x = printf("ABC");だと3ですね。

Answer 2

関数プロトタイプの読みかたは、ここに書かれています。
https://www.php.net/manual/ja/about.prototypes.php

Answer 3

しかし、下に記述しているPHPでは返ってくるのは文字列、浮動小数点です。

見えているものは返り値ではありません。「表示を行う」という仕事と、返り値は別物です。

Comments

[maisumakun]

printf(略);のように書いている場合、返り値は受け取らずに捨てています。