meta: migrate to monorepo

1 files changed, 708 insertions, 0 deletions

diff --git a/vhosts/blog/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.xml b/vhosts/blog/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.xml
new file mode 100644
index 00000000..88d71755
--- /dev/null
+++ b/vhosts/blog/content/posts/2022-09-29/write-fizzbuzz-in-php-2-letters-per-line.xml
@@ -0,0 +1,708 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<article xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0">
+  <info>
+    <title>【PHP】 fizzbuzz を書く。1行あたり2文字で。</title>
+    <abstract>
+      PHP で、fizzbuzz を書いた。ただし、1行あたりに使える文字数は2文字まで。
+    </abstract>
+    <keywordset>
+      <keyword>php</keyword>
+    </keywordset>
+    <revhistory>
+      <revision>
+        <date>2022-09-28</date>
+        <revremark>公開</revremark>
+      </revision>
+      <revision>
+        <date>2022-09-29</date>
+        <revremark>小さな文言の修正・変更</revremark>
+      </revision>
+    </revhistory>
+  </info>
+  <section xml:id="intro">
+    <title>記事の構成について</title>
+    <para>
+      この記事は、普通の fizzbuzz を徐々に変形して最終形にしていく、という構成で書かれている。
+      最終形を見てどのような仕組みで動いているのか解読してから解説を読みたい、というかたがいれば、
+      <link xl:href="https://gist.github.com/nsfisis/04c227d5a419867472a0b23a83ad2919#file-fizzbuzz-php-2-letters-per-line-and-supports-php-8-x-without-warnings">このページ</link>
+      にソースコードがあるので、そちらを先に見てほしい。
+    </para>
+  </section>
+  <section xml:id="regulations">
+    <title>レギュレーション</title>
+    <para>
+      PHP で、次のような制約の下に fizzbuzz を書いた。
+    </para>
+    <itemizedlist>
+      <listitem>
+        1行あたりの文字数は2文字までに収めること (ただし <literal>&lt;?php</literal> タグは除く)
+        <itemizedlist>
+          <listitem>
+            厳密な定義: <literal>&lt;?php</literal> タグ以降のソースコードが、2 byte ごとにラインフィード (LF) で区切られること
+          </listitem>
+        </itemizedlist>
+      </listitem>
+      <listitem>スペースやタブを使用しないこと</listitem>
+      <listitem>
+        ループのアンロールをしないこと
+        <itemizedlist>
+          <listitem>100 回ループの代わりに 100 回コードをコピペ、というのは禁止</listitem>
+        </itemizedlist>
+      </listitem>
+      <listitem>PHP 7.4〜8.1 で動作すること</listitem>
+      <listitem>実行時に Notice や Warning が出ないこと</listitem>
+      <listitem>標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)</listitem>
+    </itemizedlist>
+    <para>
+      備考: PHP には <literal>short_open_tag</literal> というオプションがあり、
+      これを有効にするとファイル冒頭の <literal>&lt;?php</literal> の代わりに <literal>&lt;?</literal>
+      を使うことができ、文字どおり1行2文字で書ける。
+      ただ、このオプションはデフォルト off になっている環境が多いようなので、今回は使わないことにした。
+    </para>
+  </section>
+  <section xml:id="problems">
+    <title>主な障害</title>
+    <para>
+      1行あたりの文字数など、適当に改行を挟めばいいだけではないのか？
+    </para>
+    <para>
+      特に、C言語でこのような試みをおこなったことがあるかたならそう思うだろう。事実、Cでのこの制約はほとんど無意味に等しい。
+    </para>
+    <programlisting language="c" linenumbering="unnumbered">
+      <![CDATA[
+      #\
+      i\
+      n\
+      c\
+      l\
+      u\
+      d\
+      e\
+      <\
+      s\
+      t\
+      d\
+      i\
+      o\
+      .\
+      h\
+      >\
+      /*
+      */
+      i\
+      n\
+      t\
+      /*
+      */
+      m\
+      a\
+      i\
+      n(
+      ){
+      f\
+      o\
+      r(
+      i\
+      n\
+      t\
+      /*
+      */
+      i=
+      1;
+      i<
+      1\
+      0\
+      0;
+      i\
+      +\
+      +)
+      if
+      (i
+      %\
+      15
+      ==
+      0)
+      p\
+      r\
+      i\
+      n\
+      t\
+      f(
+      "\
+      F\
+      i\
+      z\
+      z\
+      B\
+      u\
+      z\
+      z\
+      %\
+      c\
+      ",
+      10
+      );
+
+      /* あとは同じように普通のプログラムを変形するだけなので省略 */
+      ]]>
+    </programlisting>
+    <para>
+      バックスラッシュを使った行継続がトークンを区切らない、というのがポイントだ。
+    </para>
+    <para>
+      さて、PHP ではそもそもバックスラッシュを行継続に使うことができない。
+      これにより、「3文字以上からなるトークンが一切使えない」という制約が課される。
+      例えば、<literal>echo</literal> で出力することや、<literal>for</literal> でループすること、
+      <literal>new</literal> でインスタンスを生成することができない。
+      特に、出力は fizzbuzz をどんなアルゴリズムで実装しようとおこなわなければならないので、できないのは致命的である。
+    </para>
+    <para>
+      当然、名前が3文字以上ある関数も使えない。なお、標準 PHP の範囲内において、名前が 2文字以下の関数は以下のとおりである:
+    </para>
+    <itemizedlist>
+      <listitem>
+        <literal>_</literal>: <literal>gettext</literal> のエイリアス
+      </listitem>
+      <listitem>
+        <literal>dl</literal>: 拡張モジュールをロードする
+      </listitem>
+      <listitem>
+        <literal>pi</literal>: 円周率を返す
+      </listitem>
+    </itemizedlist>
+    <para>
+      (環境によって多少は変わるかも)
+    </para>
+    <para>
+      2文字の関数を定義しまくった拡張モジュールを用意しておいて <literal>dl()</literal> で読み込む行為は、レギュレーションで定めた
+    </para>
+    <blockquote>
+      <itemizedlist>
+        <listitem>標準的なインストール構成の PHP で実現できること (デフォルトで有効になっていない拡張等を使わないこと)</listitem>
+      </itemizedlist>
+    </blockquote>
+    <para>
+      に反する (というより、「それだとおもしろくもなんともないので、このルールを足した」というのが正しい)。
+    </para>
+    <para>
+      また、2文字だと文字列がまともに書けないのも辛い。<literal>''</literal> だけで2文字使うので、
+      「1文字の文字列リテラル」というものを書くことができない。PHP では文字列リテラル中に生の改行が書けるので
+    </para>
+    <programlisting language="php" linenumbering="unnumbered">
+      <![CDATA[
+      $a
+      ='
+      a'
+      ;;
+      ]]>
+    </programlisting>
+    <para>
+      とすると <literal>$a</literal> は <literal>"\na"</literal> になるのだが、余計な改行が入ってしまう。
+    </para>
+    <para>
+      これらの障害をどのように乗り越えるのか、次節から見ていく。
+    </para>
+  </section>
+  <section xml:id="commentary">
+    <title>解説</title>
+    <section xml:id="commentary--normal-fizzbuzz">
+      <title>普通の (?) fizzbuzz</title>
+      <para>
+        まずは普通に書くとしよう。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        <?php
+
+        for ($i = 1; $i < 100; $i++) {
+          echo (($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n";
+        }
+        ]]>
+      </programlisting>
+      <para>
+        素直に書いた fizzbuzz とは言い難いが、このくらいは普通だということにしておかないと、この先がやっていられないので許してほしい。
+      </para>
+    </section>
+    <section xml:id="commentary--remove-keywords">
+      <title><literal>for</literal> の排除</title>
+      <para>
+        <literal>for</literal> は、3文字もある長いキーワードである。
+        こんなものは使えない。<literal>array_</literal> 系の関数を使って、適当に置き換えるとしよう。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        <?php
+
+        $s = range(1, 100);
+        array_walk(
+        $s,
+        fn($i) =>
+        printf((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
+        );
+        ]]>
+      </programlisting>
+      <para>
+        <literal>array_walk</literal> や <literal>range</literal>、<literal>printf</literal> といった
+        <literal>for</literal> よりも長いトークンが現れてしまったが、これは次節で直すことにする。
+        なお、<literal>echo</literal> は文 (statement) であり式 (expression) ではないので、式である <literal>printf</literal> に置き換えた。
+      </para>
+    </section>
+    <section xml:id="commentary--shorten-function-invocation">
+      <title>関数呼び出しの短縮</title>
+      <para>
+        <literal>range</literal>、<literal>array_walk</literal>、<literal>printf</literal> は長すぎるのでどうにかせねばならない。
+        ここで、PHP の可変関数を使う。可変関数とは、関数名が文字列として入った変数を経由して、関数を呼び出す機能である。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        <?php
+
+        $r = 'range';
+        $w = 'array_walk';
+        $p = 'printf';
+
+        $s = $r(1, 100);
+        $w(
+        $s,
+        fn($i) =>
+        $p((($i % 3 ? '' : 'Fizz') . ($i % 5 ? '' : 'Buzz') ?: $i) . "\n"),
+        );
+        ]]>
+      </programlisting>
+      <para>
+        これで関数を呼び出している所は短くなった。
+        では、<literal>$r</literal> や <literal>$w</literal> や <literal>$p</literal>、
+        また <literal>'Fizz'</literal> や <literal>'Buzz'</literal> はどうやって 1 行 2 文字に収めるのか。
+        次のテクニックへ移ろう。
+      </para>
+    </section>
+    <section xml:id="commentary--incompatible-solution">
+      <title>余談: PHP 8.x で動作しなくてもいいなら</title>
+      <para>
+        今回使ったテクニックを説明する前に、余談として、文字列リテラルの短縮法として今回採用しなかったものを紹介する。
+      </para>
+      <blockquote>
+        <itemizedlist>
+          <listitem>PHP 7.4〜8.1 で動作すること</listitem>
+        </itemizedlist>
+      </blockquote>
+      <para>
+        というルールがない場合、「未定義の定数が評価された場合、その定数の名前が値になる」という PHP 7.x までの仕様が利用できる。
+        例えば、 <literal>Fizz</literal> という文字列が欲しければ、次のようにする。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $f
+        =F
+        .i
+        .z
+        .z
+        ;;
+        ]]>
+      </programlisting>
+      <para>
+        こうして簡単に文字列を作れる。
+        なお、この仕様は 7.x 時点でも警告を受けるので、<literal>@</literal> 演算子を使って抑制してやるとよい。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $f
+        =@
+        F.
+        @i
+        .#
+        @z
+        .#
+        @z
+        ;;
+        ]]>
+      </programlisting>
+      <para>
+        むしろ、このことがわかっていたからこそ PHP 8.x での動作を要件に課したところがある。
+      </para>
+    </section>
+    <section xml:id="commentary--shorten-string-literals">
+      <title>文字列リテラルの短縮</title>
+      <para>
+        実際に使った手法の説明に移る。
+      </para>
+      <para>
+        ずばり、文字列同士のビット演算を使う。
+        PHP では、文字列同士でビット演算 (<literal>&amp;</literal>、<literal>|</literal>、<literal>^</literal>) をした場合、
+        文字列の各バイトごとに指定したビット演算がなされ、それを結合したものが演算結果となる。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $a = "12345";
+        $b = "world";
+
+        // $a ^ $b は次のコードと同じ
+        $result = '';
+        for ($i = 0; $i < min(strlen($a), strlen($b)); $i++) {
+        $result .= $a[$i] ^ $b[$i];
+        }
+
+        echo $result;
+        // => F]AXQ
+        ]]>
+      </programlisting>
+      <para>
+        これを踏まえ、次のコードを見てみよう。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $x = "x\nOm\n";
+        $y = "\nk!\no";
+        $r = $x ^ $y;
+        echo "$r\n";
+        ]]>
+      </programlisting>
+      <para>
+        実行すると、<literal>range</literal> が表示される。
+        さて、PHP では文字列リテラル中に生の改行を直接書いてもよいのだった (「主な障害」の節を参照のこと)。
+        書きかえてみよう。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $x
+        ='x
+        Om
+        ';
+        $y
+        ='
+        k!
+        o'
+        ;
+
+        $r = $x ^ $y;
+        echo "$r\n";
+        ]]>
+      </programlisting>
+      <para>
+        さらに <literal>#</literal> を使って適当に調整すると、次のようになる。
+      </para>
+      <programlisting language="php" linenumbering="unnumbered">
+        <![CDATA[
+        $x
+        =#
+        'x
+        Om
+        ';
+        $y
+        ='
+        k!
+        o'
+        ;#
+        $r
+        =#
+        $x
+        ^#
+        $y
+        ;#
+
+        echo "$r\n";
+        ]]>
+      </programlisting>
+      <para>
+        1行あたり2文字で、<literal>range</literal> という文字列を生成することに成功した。
+        他の必要な文字列にも、同様の処理をほどこす。
+      </para>
+      <para>
+        備考: <literal>Buzz</literal> 中にある小文字の <literal>u</literal> は、このロジックだと non-printable な文字になってしまう。
+        ここまでのテクニックを駆使すれば回避するのはそう難しくないので、考えてみてほしい。
+      </para>
+    </section>
+  </section>
+  <section xml:id="stretched-fizzbuzz">
+    <title>完成系</title>
+    <para>
+      完成したものがこちら。
+    </para>
+    <programlisting language="php" linenumbering="unnumbered">
+      <![CDATA[
+      <?php
+
+      $x
+      =#
+      'i
+      S'
+      ;;
+      $y
+      ='
+      b!
+      ';
+      $c
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $x
+      =#
+      'x
+      Om
+      ';
+      $y
+      ='
+      k!
+      o'
+      ;#
+      $r
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $x
+      =#
+      'k
+      Sk
+      ~}
+      Ma
+      ';
+      $y
+      ='
+      x!
+      s!
+      k!
+      ';
+      $w
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $x
+      =#
+      'z
+      Hd
+      G'
+      ;#
+      $y
+      ='
+      x!
+      ~!
+      ';
+      $p
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $x
+      =#
+      'L
+      [p
+      ';
+      $y
+      ='
+      c!
+      ';
+      $f
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $x
+      =#
+      'H
+      [p
+      ';
+      $y
+      ='
+      _!
+      ';
+      $b
+      =#
+      $x
+      ^#
+      $y
+      ;#
+      $b
+      [1
+      ]=
+      $c
+      (#
+      13
+      *9
+      );
+      $s
+      =#
+      $r
+      (1
+      ,(
+      10
+      **
+      2)
+      );
+      $w
+      (#
+      $s
+      ,#
+      fn
+      (#
+      $i
+      )#
+      =>
+      $p
+      ((
+      (#
+      $i
+      %3
+      ?#
+      ''
+      :#
+      $f
+      ).
+      (#
+      $i
+      %5
+      ?#
+      ''
+      :#
+      $b
+      )?
+      :#
+      $i
+      )#
+      .'
+      ')
+      );
+      ]]>
+    </programlisting>
+  </section>
+  <section xml:id="outro">
+    <title>感想など</title>
+    <para>
+      PHP は、スクリプト言語の中だとシンタックスシュガーが少ない (体感)。
+      この挑戦は不可能に思われたが、PHP マニュアルとにらめっこしていたらなんとかなった。
+    </para>
+    <para>
+      みんなもプログラムを細長くしよう。
+    </para>
+  </section>
+  <section xml:id="alternative-solution">
+    <title>余談2: 別解</title>
+    <para>
+      PHP では、バッククォートを使ってシェルを呼び出せる。
+      これは <literal>shell_exec</literal> 関数と等価である。
+      さて、PHP ではバックスラッシュによる行継続が使えないと書いたが、シェルでは使える
+      (当然だが、呼び出されるシェルに依存する。Bash なら大丈夫だろう。知らんけど)。
+    </para>
+    <programlisting language="php" linenumbering="unnumbered">
+      <![CDATA[
+      <?php
+
+      printf(`
+      e\
+      c\
+      h\
+      o\
+      \
+      1\
+      2\
+      3\
+      `);
+      ]]>
+    </programlisting>
+    <para>
+      なお、ここでは簡単のため出力に <literal>printf</literal> をそのまま使っているが、
+      実際には <literal>printf</literal> という文字列を合成して可変関数で呼び出す。
+    </para>
+    <para>
+      ただし、これでは
+    </para>
+    <blockquote>
+      <itemizedlist>
+        <listitem>スペースやタブを使用しないこと</listitem>
+      </itemizedlist>
+    </blockquote>
+    <para>
+      に違反してしまう。スペースが使えないと引数とコマンドを区切れない。これは困った。
+    </para>
+    <para>
+      もうこれ以上は不可能だと思っていたのだが、この記事の執筆中に解決する方法を思いついたので載せておく。
+    </para>
+    <programlisting language="php" linenumbering="unnumbered">
+      <![CDATA[
+      <?php
+
+      $c = 'chr';
+
+      ${
+      '_
+      '}
+      =#
+      $c
+      (#
+      32
+      ).
+      $c
+      (#
+      92
+      );
+
+      printf(`
+      e\
+      c\
+      h\
+      o\
+      ${
+      '_
+      '}
+      1\
+      2\
+      3\
+      `);
+      ]]>
+    </programlisting>
+    <para>
+      先程と同じく、<literal>chr</literal> や <literal>printf</literal> を生成する部分は長くなるので省いた。
+    </para>
+    <literallayout class="monospaced">
+      <![CDATA[
+      ${
+      '_
+      '}
+      ]]>
+    </literallayout>
+    <para>
+      は変数で、中にはスペースとエスケープが入っている (<literal>chr(32) . chr(92)</literal>)。
+      シェルに渡されている文字列は次のようになる。
+    </para>
+    <literallayout class="monospaced">
+      <![CDATA[
+      e\
+      c\
+      h\
+      o\
+      \
+      1\
+      2\
+      3\
+      ]]>
+    </literallayout>
+    <para>
+      これは、前掲したコマンドと同じだ。
+      かくして、スペースを陽に書かずにシェルをおおよそ自由に扱えるようになった。
+      Fizzbuzz のワンライナーくらいすぐ書けるだろうから、あとはなんとかなるだろう (試してないけど)。
+    </para>
+    <para>
+      ということでこれは別解ということにしておく。
+    </para>
+    <para>
+      ちなみに、PHP 8.2 からは、この記法で Warning が出るようになるようだ。
+    </para>
+    <literallayout class="monospaced">
+      <![CDATA[
+      ${
+      '_
+      '}
+      ]]>
+    </literallayout>
+    <para>
+      最新版で警告が出るというのも美しくないので、私としては本編の解法を推す。
+    </para>
+  </section>
+</article>