JavaScript/String/prototype/StringPaddingBuiltinsImpl

StringPaddingBuiltinsImpl は、String.prototype.padStart() と String.prototype.padEnd() メソッドの実装に使用される内部的な抽象操作です。このメソッドは、文字列のパディング処理の共通ロジックを提供します。

構文

StringPaddingBuiltinsImpl ( O, maxLength, fillString, placement )

• O: パディングされる文字列オブジェクト
• maxLength: 結果の文字列の最大長
• fillString: 埋め込みに使用する文字列
• placement: パディングの位置（"start" または "end"）

動作の仕組み

以下に、StringPaddingBuiltinsImpl の動作手順を示します：

1. O を文字列に変換します。
2. maxLength を整数に変換します。
3. maxLength が元の文字列の長さ以下の場合、元の文字列を返します。
4. fillString が未定義の場合、空白文字（" "）を使用します。
5. fillString を文字列に変換します。
6. fillString が空文字列の場合、元の文字列を返します。
7. 必要なパディングの長さを計算します。
8. 必要な回数だけ fillString を繰り返して、パディング文字列を作成します。
9. placement に基づいて、パディング文字列を元の文字列の前または後に追加します。

実装例

以下は、StringPaddingBuiltinsImpl の動作を示す疑似的な実装例です：

function StringPaddingBuiltinsImpl(O, maxLength, fillString, placement) {
  // 1. 文字列に変換
  const S = String(O);
  
  // 2-3. maxLengthが元の文字列の長さ以下の場合、元の文字列を返す
  const intMaxLength = Math.floor(Number(maxLength));
  if (intMaxLength <= S.length) {
    return S;
  }
  
  // 4-6. fillStringが未定義または空文字列の場合の処理
  let filler = fillString === undefined ? " " : String(fillString);
  if (filler === "") {
    return S;
  }
  
  // 7. 必要なパディングの長さを計算
  const fillLen = intMaxLength - S.length;
  
  // 8. パディング文字列の作成
  let padString = "";
  while (padString.length < fillLen) {
    padString += filler;
  }
  if (padString.length > fillLen) {
    padString = padString.substring(0, fillLen);
  }
  
  // 9. パディング文字列を配置
  if (placement === "start") {
    return padString + S;
  } else {
    return S + padString;
  }
}

実装例による動作確認

以下のプログラムは、上記の疑似実装を使用して padStart と padEnd の動作を確認します：

// padStartの実装例
function myPadStart(str, maxLength, fillString) {
  return StringPaddingBuiltinsImpl(str, maxLength, fillString, "start");
}

// padEndの実装例
function myPadEnd(str, maxLength, fillString) {
  return StringPaddingBuiltinsImpl(str, maxLength, fillString, "end");
}

// 動作確認
console.log(myPadStart("abc", 10, ".")); // ".......abc"
console.log(myPadEnd("abc", 10, "."));   // "abc......."

注意点

• 内部実装: StringPaddingBuiltinsImpl は内部メソッドであり、JavaScript開発者が直接アクセスすることはできません。
• 共通ロジック: このメソッドは padStart と padEnd の共通のロジックを抽象化し、コードの重複を避けるために使用されます。
• 仕様: このメソッドの動作は ECMAScript 仕様によって厳密に定義されており、すべてのJavaScript実装で同じ結果を保証します。
• 効率性: 実際の実装では、文字列の繰り返しやメモリ使用の面で最適化されている可能性があります。

外部リンク

• ECMA-262::22.1.3.17.1 StringPaddingBuiltinsImpl ( O, maxLength, fillString, placement )