配列をリングバッファと見て、そこにデータをコピーする。
- COPY命令と同じく配列間の値をコピーするが、コピー先よりもコピー元のコピー要素数が多い場合でも要素数を拡張せず、配列の先頭に折り返してデータをコピーする。
- コピー先、コピー元共に2次元配列まで指定できる。2次元配列を指定した場合、マルチチャンネルのリングバッファ(もしくはデータ)として扱う。
- コピー先、コピー元両方に2次元配列を指定した場合、双方のチャンネル数(第1次元の要素数)は同じにする必要がある。
- コピー先が2次元、コピー元が1次元配列の場合、コピー元のデータがコピー先の全チャンネルに同じようにコピーされる。
- コピー先、コピー元が同じ配列だった場合の動作は保証しない。
書式
RINGCOPY コピー先配列,コピー先オフセット,コピー元配列[[,コピー元オフセット],コピー要素数]
引き数
コピー先配列
コピー先のリングバッファとして扱われる配列
コピー先オフセット
コピー先でのコピー開始位置
コピー元配列
コピー元の配列
コピー元オフセット
コピー元でのコピー開始位置(省略時は0)
コピー要素数
コピーする要素の数(省略時はコピー元配列の要素数)
戻り値
なし
サンプル・参考動画
コメント