このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

char、' '

文字配列

このページをすべて展開する

説明

数値配列が数字のシーケンスであるように、文字配列は文字のシーケンスです。一般的に、短いテキストを文字の行として "文字ベクトル" に格納するために使用されます。

作成

一重引用符を使用して文字ベクトルを作成できます。

C = 'Hello, world'

C =

    'Hello, world'

異なるデータ型の配列がある場合は、以下に説明する関数 char を使用して、その配列を文字配列に変換できます。

構文

C = 'text'
C = char(A)
C = char(A1,...,An)
C = char(D,datefmt)
C = char(D,datefmt,locale)

説明

文字ベクトルの作成

C = 'text' は、一重引用符で囲まれたテキストの文字ベクトルを作成します。

例

配列の変換

C = char(A) は、入力配列 A を文字配列に変換します。たとえば、A が string "foo" の場合、c は文字配列 'foo' です。

例

C = char(A1,...,An) は、配列 A1,...,An を単一の文字配列に変換します。文字への変換後、入力配列が C の行になります。関数 char は、必要に応じて空白で行を埋めます。入力配列が空の文字配列の場合、C 内の対応する行は空白の行になります。

入力配列 A1,...,An を string 配列、cell 配列または categorical 配列にすることはできません。

A1,...,An のサイズと形状は揃っていなくてもかまいません。

例

日付と時刻の変換

C = char(D,datefmt) で、D は datetime または duration 配列であり、"HH:mm:ss" などの指定された形式を適用します。

例

C = char(D,datefmt,locale) は、"en_US" などのロケールを指定します。

例

入力引数

すべて展開する

入力配列。A のデータ型によって、char が A を文字配列に変換する方法が決定します。

入力型

変換のメモ

サンプル入力

サンプル出力

string

入力配列内の各要素が、必要に応じて自動的に空白で埋められて、新規文字配列の 1 行になります。

A が空 ("") の場合、出力は "空の文字配列" (0 行 0 列の文字ベクトル) になります。

1×1 string array
    "foo"

 
1×3 char array
    'foo'
2×1 string array
    "foo"
    "bar"
 
2×3 char array
    'foo'
    'bar'

数値配列

char は数値を文字に変換します。有効な数値範囲は 0 ～ 65535 で、Unicode® のコード単位に対応します。0 ～ 127 の値は、7 ビットの ASCII 文字にも対応します。関数 char は、次のように動作します。

  • 非整数をゼロ方向に丸めます。

  • 0 未満の値は 0 として処理します。

  • 65535 を超える値は 65535 として処理します。

[102 111 111 33 ]

'foo!'

文字ベクトルの cell 配列

入力が文字ベクトルの cell 配列、または categorical 配列の場合、char は入力を文字配列に変換します。入力配列の各要素の各行が、必要に応じて自動的に空白で埋められて、新規文字配列の 1 行になります。

{'foo','bar'}

 
2×3 char array

    'foo'
    'bar'

categorical 配列

 
1x3 categorical array
    red    green    blue
 
3×5 char array

    'red  '
    'green'
    'blue '

NaN、NaT、<undefined> categorical 値などの変換された欠損値は、それぞれ ' '、'NaT'、'<undefined>' として表示されます。

日付または duration 配列。datetime、duration、または calendarDuration 配列として指定します。D のデータ型によって、char が D を文字ベクトルに変換する方法が決まります。

入力型

変換のメモ

サンプル入力

出力のサンプル

datetime 配列

各要素を文字ベクトルに変換します。入力配列内の各要素が、必要に応じて自動的に空白で埋められて、新規文字配列の 1 行になります。形式とロケールを指定するには、datefmtを参照してください。

datetime(2020,6,1)

'01-Jun-2020'

duration 配列

各要素を文字ベクトルに変換します。入力配列内の各要素が、必要に応じて自動的に空白で埋められて、新規文字配列の 1 行になります。形式とロケールを指定するには、datefmtを参照してください。

duration(5:6,12,21)

 
  2×8 char array

    '05:12:21'
    '06:12:21'

calendarDuration 配列

各要素を文字ベクトルに変換します。入力配列内の各要素が、必要に応じて自動的に空白で埋められて、新規文字配列の 1 行になります。形式とロケールを指定するには、datefmtを参照してください。

calmonths(15) + caldays(8) + hours(1.2345)

 
'1y 3mo 8d 1h 14m 4.2s'

日付の形式およびロケール。個々の文字ベクトルまたは string スカラーとして指定します。A 入力の型は datetime、duration または calendarDuration でなければなりません。

形式を指定しない場合、char は、A の Format プロパティにある値を使用します。

例: char(A,"yyyy-MM-dd")

サポートされる形式は A のデータ型によって異なります。

  • datetime の形式は、"yyyy-MMM-dd HH:mm:ss.SSS" のように単位と区切り記号を組み合わせて指定できます。詳細については、datetime 配列の Format プロパティを参照してください。

  • duration の形式は、y、d、h、m、s のいずれか 1 文字か、次のいずれかの組み合わせになります。

    • "dd:hh:mm:ss"

    • "hh:mm:ss"

    • "mm:ss"

    • "hh:mm"

    • 上記のいずれかに秒の小数部を表す文字 S (最大 9 桁) を加えた "hh:mm:ss.SSSS" のような形式

  • calendarDuration の形式は、文字 y、q、m、w、d、t を "ym" のように大きい単位から小さい単位の順に組み合わせて指定できます。duration および calendarDuration の形式の詳細については、日付と時刻の表示形式の設定を参照してください。

ロケール。次の値のいずれかとして指定します。

  • "system"。システムのロケールを使用します。

  • "xx_YY" の形式の string スカラー。"xx" は ISO 639-1 で定義された小文字 2 文字の言語コードで、"YY" は ISO 3166-1 alpha-2 で定義された大文字の国コードです。サンプル値については、関数 datetime の名前と値の引数Localeを参照してください。

ロケールのみを指定するには、形式のプレースホルダーとして空の配列 ([]) を使用します。

例: char(A,"yyyy-MM-dd","en_US")

例: char(A,[],"en_US")

ロケールは、月の名前などの日付と時刻の特定成分を表現するために使用する言語に影響します。有効な値は次のとおりです。

次の表に一般的なロケールの値を示します。

ロケール 言語国
"de_DE"ドイツ語ドイツ
"en_GB"英語英国
"en_US"英語米国
"es_ES"スペイン語スペイン
"fr_FR"フランス語フランス
"it_IT"イタリア語イタリア
"ja_JP"日本語日本
"ko_KR"韓国語韓国
"nl_NL"オランダ語オランダ
"zh_CN"簡体字中国語中国

出力引数

すべて展開する

出力配列。文字配列として返されます。文字配列は任意のサイズをもつことができますが、最も一般的な使用例は、複数のテキストを複数の文字ベクトルとして格納することです。

MATLAB® は、UTF-16 エンコードを使用してすべての文字を Unicode 文字として格納します。Unicode の詳細については、Unicode を参照してください。

例

すべて折りたたむ

ライブ スクリプトを開く

一重引用符を使用して文字ベクトルを作成します。

C = 'Hello, world'
C = 
'Hello, world'
ライブ スクリプトを開く

数値配列を文字配列に変換します。 

A = [77 65 84 76 65 66];
C = char(A)
C = 
'MATLAB'

32 ～ 127 の整数は表示可能な ASCII 文字に対応します。しかし、0 ～ 65535 の整数は Unicode® 文字にも対応します。関数 char を使用して、整数を対応する Unicode 表現に変換できます。

たとえば、数字 8451 は摂氏温度を示す記号に対応します。char を使用して 8451 を変換します。

C = char(8451)
C = 
'℃'
ライブ スクリプトを開く

複数の配列を単一の文字配列に変換します。入力配列の形状は同じでなくてもかまいません。 

A1 = [65 66; 67 68];
A2 = 'abcd';
C = char(A1,A2)
C = 3×4 char array
    'AB  '
    'CD  '
    'abcd'

入力配列の列数が同じでないため、char は A1 の行を空白で埋めます。 

whos C
  Name      Size            Bytes  Class    Attributes

  C         3x4                24  char
ライブ スクリプトを開く

string スカラーを作成します。二重引用符を使用して string スカラーを作成できます。また、MATLAB® は二重引用符付きで string を表示します。

A = "Pythagoras"
A = 
"Pythagoras"

関数 char を使用して A を文字ベクトルに変換します。MATLAB は一重引用符を付けて文字ベクトルを表示します。

C = char(A)
C = 
'Pythagoras'
ライブ スクリプトを開く

duration 配列を char に変換します。一般的なデータ型から char への変換に関する詳細については、テキストと datetime 値または duration 値の間の変換を参照してください。

duration 配列を作成します。

D = hours(23:25) + minutes(8) + seconds(1.2345)
D = 1×3 duration
   23.134 hr   24.134 hr   25.134 hr

D を文字配列に変換します。

C = char(D)
C = 3×9 char array
    '23.134 hr'
    '24.134 hr'
    '25.134 hr'

C は、各行が 1 つの duration 値を表す文字配列になります。

duration 値を C で表す形式を指定します。

C = char(D,'hh:mm')
C = 3×5 char array
    '23:08'
    '24:08'
    '25:08'
ライブ スクリプトを開く

datetime を作成します。 

D = datetime
D = datetime
   01-Feb-2025 08:47:32

datetime を、書式設定され、フランス語にローカライズされた文字ベクトルに変換します。

C = char(D,'eeee, MMMM d, yyyy HH:mm:ss',"fr_FR")
C = 
'samedi, février 1, 2025 08:47:32'

ヒント

  • char 配列を数値型に変換すると、対応する Unicode コード値の配列が生成されます。string 内のテキストはこのように変換されません。単一の数値を表さない string を double に変換すると、NaN の結果が生成されます。詳細については、Unicode と ASCII の値を参照してください。

拡張機能

すべて展開する

バージョン履歴

R2006a より前に導入

参考

| | | | | | |

トピック