左から右に、テキストから文字列を抽出します。

たとえば、製品 SKU の先頭に決まった長さのコードが付いている場合、LEFT 関数を使ってそのコードだけを抽出できます。

LEFT(Text [, Number of characters]) 

引数データ型説明
テキスト

テキスト

ライン アイテム、テキスト定数、または一般式を使用できます。

文字抽出元のテキストです。
Number of characters (オプション)

数値

ライン アイテム、プロパティ、又は式を使用できます。

文字列から抽出する文字数です。

この引数を省略した場合、LEFT 関数はテキスト文字列の左端の文字だけを返します。

この引数に負の数値かゼロを使用した場合、LEFT 関数は空の結果を返します。

この引数が Text 引数の文字数よりも大きい場合、LEFT 関数は文字列の文字だけを返します。

LEFT 関数は結果をテキスト形式で返します。

LEFT(Product SKU, 3)

この例では、商品を区別するための文字列のリストが「Product SKU」というライン アイテムに含まれています。各 SKU の先頭には、製品カテゴリーを表す 3 文字が付いています。

この式では、Text 引数に「Product SKU」ライン アイテムを使用し、Number of characters 引数に 3 を使用しています。そのため、式は各製品 SKU の先頭 3 文字をテキスト形式の結果として返します。

LEFT 関数はリスト アイテムには使用できません。 リスト アイテムで LEFT 関数を使用する必要がある場合は、NAME 関数でリスト アイテムをテキスト形式に変換します。

Polaris では、複合文字を含むものや、基本多言語面 (BMP) 以外の文字を含むものなど、すべてのテキスト値で LEFT 関数が想定通りに動作します。

Classic エンジンでは LEFT 関数で以下のように長さが考慮されます。

  • BMP 内の Unicode 文字は 1 文字分
  • BMP 外の Unicode 文字は 2 文字分
  • 複合文字 (例: アクセントや発音区別符がある文字) の長さはコンポーネント数と等しい

この例では、列に「Clothing」リストが表示されています。リストには「Hats」、「Shirts」、「Shorts」、「Trousers」の四つのアイテムがあります。

Red Product」、「Blue Product」、「Yellow Product」という三つのテキスト形式ライン アイテムが行に表示されています。これらには商品名が含まれています。商品タイプを含む、「Clothing List」というリスト形式ライン アイテムも一つあります。これらのライン アイテムには、Text 引数で使用される値が含まれています。

LEFT 関数を使ってテキスト文字列の左から文字を抽出する式が下の 4 行に含まれています。


HatsShirtsShortsTrousers
Red ProductRed HatsRed ShirtsRed ShortsRed Trousers
Blue ProductBlue HatsBlue ShirtsBlue ShortsBlue Trousers
Yellow ProductYellow HatsYellow ShirtsYellow ShortsYellow Trousers
Clothing ListHatsShirtsShortsTrousers
LEFT(Red Product, 3)RedRedRedRed
LEFT(Blue Product, 7)Blue HaBlue ShBlue ShBlue Tr
LEFT(Yellow Product, 10)Yellow HatYellow ShiYellow ShoYellow Tro
LEFT(NAME(Clothing List), 3)HatShiShoTro

ITEM 関数を使ってリスト形式の列名を返すことができます。次に、LEFT 関数と互換性があり、名前をテキスト形式に変換する NAME 関数を使用します。

この例では、「Fruit」リストが列に表示されており、二つのライン アイテムが行に表示されています。どちらのライン アイテムにも式が含まれています。


ApplesPeachesBananasPearsCarrotsCucumbersLettuce
ITEM(Products)ApplesPeachesBananasPearsCarrotsCucumbersLettuce
LEFT(NAME(ITEM(Products)), 5)ApplePeachBananPearsCarroCucumLettu

この例では、Number of characters 引数に 5 が使用されているため、式はリスト形式の「Products」文字列の先頭 5 文字を返します。

LEFT("Favorite Team", 8) 

この例では、式に直接テキスト文字列を入力して LEFT 関数を使用しています。Number of characters 引数には 8 を使用しています。つまり、テキスト文字列の先頭 8 文字である「Favorite」を返します。