String()

名称

String()

説明

Stringクラスのインスタンスを生成する。異なるデータ型からStringオブジェクトを作成する(文字列に変換する)ための複数の形式がある。以下にデータ型を示す。

文字列リテラル(文字の配列、二重引用符でくくられた文字)
文字定数(一重引用符でくくられた文字)
他のStringオブジェクト
int型もしくはunsigned int型、long型、unsigned long型の整数定数
底を指定したint型もしくはunsigned int型、long型、unsigned long型の整数定数
int型もしくはunsigned int型、long型、unsigned long型の変数
底を指定したint型もしくはunsigned int型、long型、unsigned long型の変数
float型もしくはdouble型

数字からStringオブジェクトを作ると、その数字のASCII表現を持つ文字列ができる。デフォルトの底は10である。

String thisString = String(13);

は、“13"という文字列になる。異なる底を使うこともでき、

String thisString = String(13, HEX);

は、10進数の13を16進表現した"d"となる。二進数を使いたいなら、

String thisString = String(13, BIN);

とすることで、“1011"を得ることができる。

書式

String(const char *cstr = "");

String(const String &str);

String(const __FlashStringHelper *str);

String(String &&rval);

String(StringSumHelper &&rval);

explicit String(char c);

explicit String(unsigned char value, unsigned char base=10);

explicit String(int value, unsigned char base=10);

explicit String(unsigned int value, unsigned char base=10);

explicit String(long value, unsigned char base=10);

explicit String(unsigned long value, unsigned char base=10);

explicit String(float value, unsigned char decimalPlaces=2);

explicit String(double value, unsigned char decimalPlaces=2);

引数

`cstr, str, rval, c, value`	String型に変換したい値。
`base`	整数を文字列に変換するときの底。
`decimalPlaces`	小数点以下何位。

戻り値

Stringクラスのインスタンス。

使用例

以下のコードはすべて、Stringオブジェクトの有効な宣言である。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


String stringOne = "Hello String";                    // using a constant String
String stringOne = String('a');                       // converting a constant char into a String
String stringTwo = String("This is a string");        // converting a constant string into a String object
String stringOne = String(stringTwo + " with more");  // concatenating two strings
String stringOne = String(13);                        // using a constant integer
String stringOne = String(analogRead(0), DEC);        // using an int and a base
String stringOne = String(45, HEX);                   // using an int and a base (hexadecimal)
String stringOne = String(255, BIN);                  // using an int and a base (binary)
String stringOne = String(millis(), DEC);             // using a long and a base
String stringOne = String(5.698, 3);                  // using a float and the decimal places