Type Method
型メソッド
stringWithContentsOfFile:
Returns a string created by reading data from the file named by a given path.
与えられたパスによって指名されるファイルからデータを読み出すことによって作成される文字列を返します。
Declaration
宣言
+ (id)stringWithContentsOfFile:(NSString
*)path;
Discussion
議論
If the contents begin with a Unicode byte-order mark (U+FEFF
or U+FFFE
), interprets the contents as UTF-16 code units. If the contents begin with a UTF-8 byte-order mark (EFBBBF
), interprets the contents as UTF-8. Otherwise, interprets the contents as data in the default C string encoding. Since the default C string encoding will vary with the user’s configuration, do not depend on this method unless you are using Unicode or UTF-8 or you can verify the default C string encoding. Returns nil
if the file can’t be opened.
内容がユニードバイトオーダーマーク(U+FEFF
またはU+FFFE
)で始まるならば、内容はUTFー16コード単位として解釈します。内容がUTF-8バイトオーダーマーク(EFBBBF
)で始まるならば、内容をUTF-8として解釈します。そうでなければ、内容をデータとして省略時のC文字列符号化で解釈します。省略時のC文字列符号化はユーザの構成設定によって変動することから、このメソッドに依存しないでください、あなたがユニコードまたはUTFー8を使っているまたはあなたが省略時のC文字列符号化を検証できるのでない限り。nil
を返します、もしファイルが開かれることができないならば。
See Also
参照
Deprecated
非推奨
+ stringWithCString:
Creates a new string using a given C-string.
新しい文字列をある与えられたC文字列で作成します。
Deprecated
非推奨
- initWithCString:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
+ stringWithCString:length:
Returns a string containing the characters in a given C-string.
与えられたC文字列の中の文字を含んでいる文字列を返します。
Deprecated
非推奨
- initWithCString:length:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
- initWithCStringNoCopy:length:freeWhenDone:
Initializes the receiver, a newly allocated NSString
object, by converting the data in a given C-string from the default C-string encoding into the Unicode character encoding.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、与えられたC文字列の中のデータを省略時のC文字列符号化からユニコード文字符号化へと変換することによって初期化します。
Deprecated
非推奨
- initWithContentsOfFile:
Initializes the receiver, a newly allocated NSString
object, by reading data from the file named by path
.
レシーバ、ある新しく作成されたNSString
オブジェクトを、path
によって指名されたファイルからデータを読み出すことによって初期化します。
Deprecated
非推奨
+ stringWithContentsOfURL:
Returns a string created by reading data from the file named by a given URL.
与えられたURLによって指名されるファイルからデータを読み出すことによって作成される文字列を返します。
Deprecated
非推奨
- initWithContentsOfURL:
Initializes the receiver, a newly allocated NSString
object, by reading data from the location named by a given URL.
レシーバ、ある新しくアロケートされたNSString
オブジェクトを、ある与えられたURLによって指名される位置からデータを読み出すことによって初期化します。
Deprecated
非推奨
- writeToFile:atomically:
Writes the contents of the receiver to the file specified by a given path.
レシーバの内容をある与えられたパスによって指定されるファイルに書き出します。
Deprecated
非推奨
- writeToURL:atomically:
Writes the contents of the receiver to the location specified by a given URL.
レシーバの内容をある与えられたURLによって指定される位置に書き出します。
Deprecated
非推奨
- getCharacters:
Copies all characters from the receiver into a given buffer.
全ての文字をレシーバからある与えられたバッファにコピーします。
Deprecated
非推奨
- cString
Returns a representation of the receiver as a C string in the default C-string encoding.
C文字列として、省略時のC文字列符号化において、レシーバの表現を返します。
Deprecated
非推奨
- lossyCString
Returns a representation of the receiver as a C string in the default C-string encoding, possibly losing information in converting to that encoding.
C文字列として、省略時のC文字列符号化において、レシーバの表現を返します、ことによるとその符号化への変換において情報を損失します。
Deprecated
非推奨
- cStringLength
Returns the length in char-sized units of the receiver’s C-string representation in the default C-string encoding.
省略時のC文字列符号化において 、レシーバのもつC文字列表現のcharサイズ単位での長さを返します。
Deprecated
非推奨
- stringByAddingPercentEscapesUsingEncoding:
Returns a representation of the receiver using a given encoding to determine the percent escapes necessary to convert the receiver into a legal URL string.
レシーバのある表現を返します、レシーバを合法なURL文字列へ変換するのに必要なパーセントエスケープを決定するのに与えられた符号化を使います。
Deprecated
非推奨
- stringByReplacingPercentEscapesUsingEncoding:
Returns a new string made by replacing in the receiver all percent escapes with the matching characters as determined by a given encoding.
レシーバにおいて全てのパーセントエスケープを、与えられた符号化によって判定されるときに、マッチする文字で置き換えることによって作られる新しい文字列を返します。
Deprecated
非推奨
- sizeWithFont:
Returns the size of the string if it were to be rendered with the specified font on a single line.
その文字列の大きさを返します、もしそれが指定されたフォントである単一の行上で描出されることになったならば。
Deprecated
非推奨
- sizeWithFont:forWidth:lineBreakMode:
Returns the size of the string if it were to be rendered with the specified font and line attributes on a single line.
その文字列の大きさを返します、もしそれが指定されたフォントと行属性である単一の行上で描出されることになったならば。
Deprecated
非推奨
- sizeWithFont:constrainedToSize:
Returns the size of the string if it were rendered and constrained to the specified size.
その文字列の大きさを返します、もしそれが描出されたそして指定された大きさに制約されたならば。
Deprecated
非推奨
- drawAtPoint:withFont:
Draws the string in a single line at the specified point in the current graphics context using the specified font.
文字列を単一行においてこの指定されたポイントで現在のグラフィック文脈においてこの指定されたフォントを使って描画します。
Deprecated
非推奨
- drawAtPoint:forWidth:withFont:lineBreakMode:
Draws the string in a single line at the specified point in the current graphics context using the specified font and attributes.
文字列を単一行においてこの指定されたポイントで現在のグラフィック文脈においてこの指定されたフォントと属性を使って描画します。
Deprecated
非推奨
- drawInRect:withFont:
Draws the string in the current graphics context using the specified bounding rectangle and font.
文字列を現在のグラフィック文脈においてこの指定された境界矩形とフォントを使って描画します。
Deprecated
非推奨
- drawInRect:withFont:lineBreakMode:
Draws the string in the current graphics context using the specified bounding rectangle, font, and attributes.
文字列を現在のグラフィック文脈においてこの指定された境界矩形、フォント、そして属性を使って描画します。
Deprecated
非推奨
- drawWithRect:options:attributes:
Draws the receiver with the specified options and other display characteristics of the given attributes, within the specified rectangle in the current graphics context.
レシーバをこの指定されたオプションとこの与えられた属性の他の表示特徴とともに、現在のグラフィクス文脈においてこの指定された矩形内に描画します。
Deprecated
非推奨
- boundingRectWithSize:options:attributes:
Calculates and returns the bounding rect for the receiver drawn using the given options and display characteristics, within the specified rectangle in the current graphics context.
現在のグラフィック文脈でこの指定された矩形内に、与えられたオプションと表示特徴を使って描画されるレシーバに対する境界rectを計算して返します。
Deprecated
非推奨
Related Documentation
関連文書
+ stringWithContentsOfFile:encoding:error:
Returns a string created by reading data from the file at a given path interpreted using a given encoding.
与えられたパスでのファイルからデータを読み出すことによって作成される文字列を返します、与えられた符号化を使って解釈されます。
+ stringWithContentsOfFile:usedEncoding:error:
Returns a string created by reading data from the file at a given path and returns by reference the encoding used to interpret the file.
与えられたパスでのファイルからデータを読み出すことによって作成された文字列を返します、そしてそのファイルを解釈するのに使った符号化を参照によって返します。