NSStringクラスリファレンス／定数

---

定数

unichar

Unicode文字型
    typedef unsigned short unichar;
Availability
Available in OS X v10.0 and later.
Declared In
NSString.h

NSMaximumStringLength

    NSStringに格納できる最大文字数を定義する定数。（廃止。OS X v10.5以降でこの定数は使えません。）

    #define NSMaximumStringLength (INT_MAX-1)

定数

NSMaximumStringLength

NSStringに格納できる最大文字数。

Available in OS X v10.0 and later.
Declared in NSString.h.

Availability
Available in OS X v10.0.
Removed in OS X v10.5.
Declared In
NSString.h

NSStringCompareOptions

文字比較オプション型

    typedef NSUInteger NSStringCompareOptions;

Discussion

取りえる値については、"Search and Comparison Options”を参照してください。

Availability

Available in OS X v10.5 and later.
Declared In
NSString.h

Search and Comparison Options

これらの値は、文字列クラスにある、たくさんの検索と比較メソッドで使える、オプションを表します。

 enum{
    NSCaseInsensitiveSearch = 1,
    NSLiteralSearch = 2,
    NSBackwardsSearch = 4,
    NSAnchoredSearch = 8,
    NSNumericSearch = 64,
    NSDiacriticInsensitiveSearch = 128,
    NSWidthInsensitiveSearch = 256,
    NSForcedOrderingSearch = 512,
    NSRegularExpressionSearch = 1024
 };

Constants

NSCaseInsensitiveSearch

ケースの違いを無視した検索。

Available in OS X v10.0 and later.
Declared in NSString.h.

NSLiteralSearch

文字列ごとの等価性を評価。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSBackwardsSearch

対象文字列の終わりから検索。

Available in OS X v10.0 and later.
Declared in NSString.h.

NSAnchoredSearch

対象文字列の始まり（NSBackwardsSearchなら終わり）が限定されて検索。

Available in OS X v10.0 and later.
Declared in NSString.h.

NSNumericSearch

文字列に含まれる数字が数値として比較される。つまり、Name2.txt < Name7.txt < Name25.txt。
数値的な比較は文字列に含まれる数字にのみ適用されます。そのほかの文字、負数記号（マイナス）や小数点などといった本物の数字を意味していても含まれません。
このオプションは比較にのみ適用でき、検索では使えません。

Available in OS X v10.3 and later.
Declared in NSString.h.

NSDiacriticInsensitiveSearch

（発音）文字を無視しての検索。
For example, ‘ö’ is equal to ‘o’.

Available in OS X v10.5 and later.
Declared in NSString.h.

NSWidthInsensitiveSearch

全幅型（full-width）なのか半幅型（half-width）なのかの文字の違いを無視しての検索。これは東アジアの文字セットで発生する違いです。

たとえば、このオプションをともなうと、全幅ラテン小文字'a' (Unicode code point U+FF41)は基礎ラテン小文字'a' (Unicode code point U+0061)と等価になります。

Available in OS X v10.5 and later.
Declared in NSString.h.

NSForcedOrderingSearch

もし文字列が相当し合うものではあるが厳密には等しくない場合に、強制的にNSOrderedAscendingもしくはNSOrderedDescendingのどちらかを返す比較。

このオプションは、ソートを行う際に安定した結果をあたえます。たとえば、NSCaseInsensitiveSearchを指定すれば、“aaa”は"AAA”より大きくなります。

Available in OS X v10.5 and later.
Declared in NSString.h.

NSRegularExpressionSearch

ICU互換の正規表現をもちいての文字列検索。セットされると、NSCaseInsensitiveSearchとNSAnchoredSearch以外のオプションは適用されなくなります。このオプションは、rangeOfString:...メソッドとstringByReplacingOccurrencesOfString:withString:options:range:メソッドでしか使えません。

Available in OS X v10.7 and later.
Declared in NSString.h.

Discussion

これらオプションの効果についての詳細は、“Searching, Comparing, and Sorting Strings”を参照してください。

Declared In

NSString.h

NSStringEncodingConversionOptions

エンコーディング変換オプションの型。

    typedef NSUInteger NSStringEncodingConversionOptions;

Discussion
取り得る値は、"encoding Conversion Options”を参照してください。

Availability
Available in OS X v10.5 and later.
Declared In
NSString.h

Encoding Conversion Options

文字列エンコードの変換に関するオプション。

enum %#123;
    NSStringEncodingConversionAllowLossy = 1,
    NSStringEncodingConversionExternalRepresentation = 2
};

Constants

NSStringEncodingConversionAllowLossy

ロスレスな（可逆的な）変換を許可。

Available in OS X v10.5 and later.
Declared in NSString.h.

NSStringEncodingConversionExternalRepresentation

外部への表現を指定（バイトオーダー指定子をともなう、もし必要なら、エンディアンを表す）。

Available in OS X v10.5 and later.
Declared in NSString.h.

考慮がに必要な事柄

これらの定数はOS X v10.4で使用できます。しかし違う名前になっています：

typedef enum {
    NSAllowLossyEncodingConversion = 1,
    NSExternalRepresentationEncodingConversion = 2
} NSStringEncodingConversionOptions;

シンボルを外部用の定数として定義すれば、OS X v10.4において使うことができます。

Declared In

NSString.h

NSString Handling Exception Names

NSStringがあたえられたエンコードで表現できないか、プロパティリストとして文字列をパースできないときに発生する例外の名前を、これら定数は定義します。

    extern NSString *NSParseErrorException;
    extern NSString *NSCharacterConversionException;

Declared In
NSString.h

Constants

NSCharacterConversionException

もし文字列がファイルシステムか文字列エンコーディングの形式では表現できないとき、NSStringはNSCharacterConversionExceptionを発生させます

Available in OS X v10.0 and later.
Declared in NSString.h.

NSParseErrorException

もし文字列がプロパティリストとしてパースできないときに、NSStringはNSParseErrorExceptionを発生させます。

Available in OS X v10.0 and later.
Declared in COLOR(#888888){NSString.h.
Declared In
NSString.h.

NSStringEncoding

文字列エンコーディングの型

     typedef NSUInteger NSStringEncoding;

Discussion
取り得る値について“String Encodings”を参照してください。

Availability
Available in OS X v10.0 and later.
Declared In
NSString.h.

String Encodings

つぎの定数が、NSStringが取り得る文字列エンコーディングとして提供されています。

enum {
    NSASCIIStringEncoding = 1,
    NSNEXTSTEPStringEncoding = 2,
    NSJapaneseEUCStringEncoding = 3,
    NSUTF8StringEncoding = 4,
    NSISOLatin1StringEncoding = 5,
    NSSymbolStringEncoding = 6,
    NSNonLossyASCIIStringEncoding = 7,
    NSShiftJISStringEncoding = 8,
    NSISOLatin2StringEncoding = 9,
    NSUnicodeStringEncoding = 10,
    NSWindowsCP1251StringEncoding = 11,
    NSWindowsCP1252StringEncoding = 12,
    NSWindowsCP1253StringEncoding = 13,
    NSWindowsCP1254StringEncoding = 14,
    NSWindowsCP1250StringEncoding = 15,
    NSISO2022JPStringEncoding = 21,
    NSMacOSRomanStringEncoding = 30,
    NSUTF16StringEncoding = NSUnicodeStringEncoding,
    NSUTF16BigEndianStringEncoding = 0x90000100,
    NSUTF16LittleEndianStringEncoding = 0x94000100,
    NSUTF32StringEncoding = 0x8c000100,
    NSUTF32BigEndianStringEncoding = 0x98000100,
    NSUTF32LittleEndianStringEncoding = 0x9c000100,
    NSProprietaryStringEncoding = 65536
}

定数

NSASCIIStringEncoding

8ビット文字で定義されている、厳密な7ビットASCIIエンコーディング。ASCII値は、0 ... 127 のみ。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSNEXTSTEPStringEncoding

NEXTSTEP拡張で定義されている8ビットASCIIエンコーディング。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSJapaneseEUCStringEncoding

日本語テキスト向けの8ビットEUCエンコーディング。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSUTF8StringEncoding

Unicode文字の8ビット表現。ASCIIベースのシステムで通信や保存に適しています。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSISOLatin1StringEncoding

8-ISO Latin 1 encoding.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSSymbolStringEncoding

8-bit Adobe Symbol encoding vector.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSCOLOR(#888888){NonLossyASCIIStringEncoding
すべてのUnicode文字を表す7-bit verbose ASCII。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSShiftJISStringEncoding

日本語テキスト向けの、8-bit Shift-JISエンコーディング。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSISOLatin2StringEncoding

8-bit ISO Latin 2 encoding.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSUnicodeStringEncoding

文字列オブジェクト向けの正規Unicode
Available in OS X v10.0 and later.
Declared in NSString.h.

NSWindowsCP1251StringEncoding

Microsoft Windows codepage 1251, encoding Cyrillic characters; equivalent to AdobeStandardCyrillic font encoding.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSWindowsCP1252StringEncoding

Microsoft Windows codepage 1252; equivalent to WinLatin1.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSWindowsCP1253StringEncoding

Microsoft Windows codepage 1253, encoding Greek characters.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSWindowsCP1254StringEncoding

Microsoft Windows codepage 1254, encoding Turkish characters.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSWindowsCP1250StringEncoding

Microsoft Windows codepage 1250; equivalent to WinLatin2.
Available in OS X v10.0 and later.
Declared in NSString.h.

NSISO2022JPStringEncoding

email向けのISO 2022日本語エンコーディング。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSMacOSRomanStringEncoding}

クラッシックMac Romanエンコーディング。
Available in OS X v10.0 and later.
Declared in NSString.h.

NSUTF16StringEncoding

An alias for NSUnicodeStringEncoding.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSUTF16BigEndianStringEncoding

NSUTF16Stringencoding encoding with explicit endianness specified.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSUTF16LittleEndianStringEncoding

NSUTF16Stringencoding encoding with explicit endianness specified.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSUTF32StringEncoding

32-bit UTF encoding.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSUTF32BigEndianStringEncoding

NSUTF32Stringencoding encoding with explicit endianness specified.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSUTF32LittleEndianStringEncoding

NSUTF32Stringencoding encoding with explicit endianness specified.
Available in OS X v10.5 and later.
Declared in NSString.h.

NSProprietaryStringEncoding

Installation-specific encoding. (Deprecated. This encoding has been deprecated―there is NO replacement.)
Proprietary encodings have not been used since OS X v10.0. You should specify a standard encoding instead.
Available in OS X v10.0 and later.
Declared in NSString.h.

Discussion

これら値は、NSStringクラスでサポートされているさまざまなエンコーディングを表しています。これは、不完全なリストです。追加的なエンコーディングは、String Programming Guide for Core Foundationで定義されています（CFStringEncodingExt.hを参照してください）。これらのエンコーディングは、まずCore Foundation encodingをCFStringConvertEncodingToNSStringEncoding関数に渡すことでNSStringで使えるようになります。

String Enumeration Options

列挙において、部分文字列の種類とスタイルを指定する定数。

    typedef NSUInteger NSStringEnumerationOptions;

enum {
    NSStringEnumerationByLines = 0,}
    NSStringEnumerationByParagraphs = 1,}
    NSStringEnumerationByComposedCharacterSequences = 2,}
    NSStringEnumerationByWords = 3,}
    NSStringEnumerationBySentences = 4,}
    NSStringEnumerationReverse = 1UL << 8,}
    NSStringEnumerationSubstringCOLOR(#888888){NOtRequired = 1UL << 9,}}
    NSStringEnumerationLocalized = 1UL << 10}
}

Constants

NSStringEnumerationByLines

行単位で列挙。lineRangeForRange:と等価。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationByParagraphs

パラグラフ単位で列挙。paragraphRangeForRange:と等価。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationByComposedCharacterSequences

合成文字シーケンス単位で列挙。rangeOfComposedCharacterSequencesForRange:と等価。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationByWords

単語単位で列挙。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationBySentences

センテンス単位で列挙。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationReverse

指定された範囲の終わりから始まり方向への列挙。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationSubstringNotRequired

ブロックが部分文字列を必要としていない、これはnilが渡された場合、というのを示す方法。これは単に、パフォーマンスを稼ぐのに使用します。
Available in OS X v10.6 and later.
Declared in NSString.h.

NSStringEnumerationLocalized

ユーザのデフォルトロケールを使用した列挙。これは行、パラグラフ、合成文字シークエンスの列挙に関して何の違いももたらしません。しかし、単語もしくはセンテンスに関しては有効でしょう。
Available in OS X v10.6 and later.
    Declared in NSString.h.

Dicsussion

これらオプションは、enumerateSubstringsInRange:options:usingBlock:メソッドとともに使います。NSStringEnumerationBy... オプションの１つを渡し、残った列挙スタイルの定数をCのORビット演算子で結合します。

Referred from

NSString Class Reference, Apple Developer Library

Copyright

Copyright © 2013 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2013-09-18

NSStringクラスメソッドへもどる