文字列操作プログラミングガイド ( i 0.0.0)

Transcription

1 文 字 列 操 作 プログラミングガイド

2 目 次 文 字 列 操 作 プログラミングガイド(Cocoa):はじめに 5 対 象 読 者 5 この 書 類 の 構 成 5 関 連 項 目 6 文 字 列 7 文 字 列 オブジェクトの 生 成 と 変 換 8 文 字 列 を 生 成 する 8 C 文 字 列 やデータからNSStringを 生 成 する 8 文 字 列 の 整 形 10 ユーザ 向 けに 表 示 する 文 字 列 10 文 字 列 を 結 合 抽 出 する 11 C 文 字 列 を 取 得 する 12 変 換 メソッドの 概 要 12 文 字 列 オブジェクトの 整 形 13 書 式 整 形 の 基 本 事 項 13 文 字 列 と 非 ASCII 文 字 14 NSLogとNSLogv 14 文 字 列 の 書 式 指 定 子 16 書 式 指 定 子 16 プラットフォームによる 違 い 18 ファイルやURLに 対 する 文 字 列 の 読 み 書 き 20 ファイルやURLから 読 み 込 む 20 エンコーディングが 分 かっているデータを 読 み 込 む 20 エンコーディングが 未 知 のデータを 読 み 込 む 21 ファイルやURLに 書 き 出 す 22 まとめ 22 文 字 列 の 検 索 比 較 整 列 23 検 索 / 比 較 メソッド 23 2

3 文 字 列 を 検 索 する 23 文 字 列 を 比 較 整 列 する 24 検 索 / 比 較 のオプション 25 例 25 大 文 字 と 小 文 字 を 区 別 しない 前 方 一 致 / 後 方 一 致 の 検 索 25 文 字 列 の 比 較 26 Finderに 現 れるのと 同 じ 順 序 に 整 列 する 27 単 語 段 落 改 行 29 単 語 の 区 切 り 29 行 や 段 落 の 区 切 り 文 字 29 文 字 列 を 段 落 ごとに 区 切 る 30 文 字 と 書 記 素 クラスタ 31 文 字 集 合 34 文 字 集 合 に 関 する 基 本 事 項 34 文 字 集 合 を 生 成 する 34 処 理 性 能 に 関 する 考 慮 事 項 35 文 字 集 合 ファイルを 生 成 する 36 標 準 文 字 集 合 とUnicode 規 格 における 定 義 36 字 句 解 析 器 37 字 句 解 析 器 を 生 成 する 37 字 句 解 析 器 の 使 い 方 37 例 39 ローカライズ 40 ファイルパスの 文 字 列 表 現 41 パスの 表 現 41 ユーザディレクトリ 42 パスの 構 成 要 素 43 ファイル 名 の 補 完 44 文 字 列 の 描 画 45 書 類 の 改 訂 履 歴 46 索 引 49 3

4 表 文 字 列 の 書 式 指 定 子 16 表 1 NSStringやCFStringの 整 形 メソッド/ 関 数 で 使 える 書 式 指 定 子 16 表 2 NSStringやCFStringの 整 形 メソッド/ 関 数 に 指 定 できる 長 さ 修 飾 子 17 表 3 データ 型 に 応 じた 書 式 指 定 子 18 4

5 文 字 列 操 作 プログラミングガイド(Cocoa): はじめに 本 資 料 文 字 列 操 作 プログラミングガイド(Cocoa) では 文 字 列 を 生 成 検 索 連 結 描 画 する 方 法 を 解 説 します さらに 文 字 列 からある 一 群 の 文 字 を 検 索 するために 用 いる 文 字 集 合 や 数 値 と 文 字 列 を 相 互 に 変 換 する 字 句 解 析 器 についても 説 明 します 対 象 読 者 文 字 列 や 文 字 集 合 を 直 接 操 作 するプログラムの 開 発 者 を 読 者 として 想 定 しています この 書 類 の 構 成 この 資 料 は 次 の 各 章 から 成 ります 文 字 列 (7 ページ)ではCocoaの 文 字 列 オブジェクトの 特 徴 を 説 明 します 文 字 列 オブジェクトの 生 成 と 変 換 (8 ページ)では NSStringやそのサブクラスである NSMutableStringのインスタンス( 文 字 列 オブジェクト)を 生 成 する 方 法 各 種 の 文 字 エンコー ド 方 式 を 変 換 する 方 法 を 解 説 します 文 字 列 オブジェクトの 整 形 (13 ページ)ではNSStringオブジェクトの 整 形 方 法 を 説 明 します 文 字 列 の 書 式 指 定 子 (16 ページ)では printf 方 式 の 書 式 指 定 子 のうち NSStringオブジェ クトに 対 して 適 用 できるものを 紹 介 します ファイルやURLに 対 する 文 字 列 の 読 み 書 き (20 ページ)では ファイルやURLを 指 定 して 文 字 列 を 読 み 書 きする 方 法 を 述 べます 文 字 列 の 検 索 比 較 整 列 (23 ページ)では 文 字 列 中 の 文 字 や 部 分 文 字 列 を 検 索 する 方 法 他 の 文 字 列 と 比 較 する 方 法 を 説 明 します 単 語 段 落 改 行 (29 ページ)では 単 語 段 落 改 行 を 判 定 する 方 法 を 説 明 します 文 字 と 書 記 素 クラスタ (31 ページ)では 文 字 列 をユーザが 認 識 できる 文 字 群 に 分 割 する 方 法 を 解 説 します 文 字 集 合 (34 ページ)では 文 字 集 合 オブジェクトの 使 い 方 NSCharacterSetのメソッドを 使 って 標 準 あるいは 独 自 の 文 字 集 合 を 生 成 する 手 順 を 説 明 します 5

6 文 字 列 操 作 プログラミングガイド(Cocoa):はじめに 関 連 項 目 字 句 解 析 器 (37 ページ)ではNSScannerオブジェクトについて 解 説 します NSStringオブジェ クト 中 の 文 字 を 分 析 し 数 値 や 文 字 列 値 に 変 換 する 機 構 です ファイルパスの 文 字 列 表 現 (41 ページ)では 文 字 列 をファイルシステム 上 のパスとして 操 作 する NSStringのメソッドを 紹 介 します 文 字 列 の 描 画 (45 ページ)では NSViewに 直 接 文 字 列 を 描 画 する NSStringクラスのメソッ ドを 紹 介 します 関 連 項 目 さらに 詳 しくは 以 下 の 資 料 を 参 照 してください AttributedStringProgrammingGuide は 本 資 料 文 字 列 操 作 プログラミングガイド(Cocoa) と 密 接 に 関 連 します 文 字 列 や 個 々の 文 字 に 関 する 属 性 (フォント カーニングなど)を 管 理 す る NSAttributedStringオブジェクトについて 説 明 しています Data Formatting Guide では テキストを 生 成 解 釈 検 証 するオブジェクトを 使 って デー タを 整 形 する 手 順 を 解 説 しています Internationalization and Localization Guide には プロジェクトで 扱 う 文 字 列 のローカライズ 方 法 が 載 っています 文 字 列 整 形 用 の 引 数 の 順 序 づけに 関 する 説 明 もあります String Programming Guide for Core Foundation では Core Foundationの 不 透 過 型 であるCFString について 説 明 しています NSStringクラスとは 相 互 に 入 れ 替 えて 使 えます 6

7 文 字 列 Cocoaフレームワークにおいて 文 字 列 オブジェクトは 文 字 の 並 びを 表 します 文 字 列 をオブジェク トとして 表 現 することにより オブジェクトが 使 えるところであればどこでも 文 字 列 が 使 えるように なります カプセル 化 による 効 用 もあり エンコーディングを 管 理 する 効 率 的 に 格 納 する などの 恩 恵 を 受 けながら 単 なる 文 字 の 配 列 として 扱 うことも 可 能 になっています 文 字 列 オブジェクトは Unicode 文 字 の 配 列 (すなわちテキスト 文 字 列 )として 実 装 されます 不 変 (immutable) 文 字 列 とは 生 成 時 に 内 容 が 決 まり その 後 は 変 更 できないテキスト 文 字 列 のことで す 不 変 文 字 列 の 生 成 や 管 理 にはNSStringクラスを 利 用 します 一 方 生 成 後 いつでも 変 更 できる 可 変 (mutable) 文 字 列 の 構 築 や 管 理 には NSMutableStringクラスを 使 います NSStringやNSMutableStringで 生 成 他 オブジェクトを 文 字 列 オブジェクト( 混 乱 の 虞 がなければ 単 に 文 字 列 )と 呼 びます C 文 字 列 とは 標 準 Cの char * 型 を 表 します 文 字 列 オブジェクトは Unicode 文 字 列 の 配 列 として 表 されます 文 字 列 中 の 文 字 数 はlengthメソッ ドで 調 べることができます また characteratindex:メソッドで 文 字 列 中 の 文 字 を 取 得 できま す この2つの プリミティブ メソッドが 文 字 列 オブジェクト 操 作 の 基 本 となります しかし 一 般 には 文 字 列 全 体 をひとつの 単 位 として 扱 うことが 多 いでしょう 他 の 文 字 列 と 比 較 する 部 分 文 字 列 を 抽 出 する 他 の 文 字 列 と 組 み 合 わせて 新 しい 文 字 列 を 生 成 する などの 操 作 です 個 々の 文 字 に 対 する 操 作 が 必 要 な 場 合 Unicode 文 字 エンコーディング 特 に 結 合 文 字 列 について 理 解 しておか なければなりません 詳 しくは 以 下 の 資 料 を 参 照 してください The Unicode Standard, Version 4.0 The Unicode Consortium Boston: Addison-Wesley 2003 ISBN Unicode Consortiumのウェブサイト: 7

8 文 字 列 オブジェクトの 生 成 と 変 換 NSStringおよびそのサブクラスであるNSMutableStringには 文 字 列 オブジェクトを 生 成 する 手 段 がいくつかあり いずれもさまざまな 文 字 エンコーディング 方 式 に 対 応 しています 文 字 列 オブジェ クトはその 内 容 を 常 にUnicode 文 字 で 表 現 するようになっていますが 7ビットASCII ISO Latin 1 EUC Shift-JISなどさまざまなエンコーディングの 文 字 列 と 相 互 に 変 換 可 能 です クラスメソッド availablestringencodingsで 変 換 可 能 なエンコーディングを 取 得 できます C 文 字 列 と 文 字 列 オ ブジェクトを 変 換 する 際 には 明 示 的 にエンコーディングを 指 定 できます あるいは C 文 字 列 のデ フォルトのエンコーディング(プラットフォームによって 異 なり クラスメソッド defaultcstringencodingで 判 定 可 能 )を 仮 定 することも 可 能 です 文 字 列 を 生 成 する ソースコード 内 で 文 字 列 オブジェクトを 生 成 する 最 も 簡 単 な 方 法 は という 構 文 を 使 うことでしょう NSString *temp この 方 法 で 文 字 列 定 数 を 生 成 する 場 合 UTF-8の 文 字 を 使 わなければなりません このオブジェクト はコンパイル 時 に 生 成 され プログラムの 実 行 中 は 常 に 存 在 します コンパイラはモジュール 単 位 で このオブジェクト 定 数 を 生 成 するようになっており 実 行 中 に 破 棄 されることはありません 文 字 列 定 数 に 対 しても 他 のオブジェクトと 同 様 直 接 メッセージを 送 信 することができます BOOL same = [@"comparison" isequaltostring:mystring]; C 文 字 列 やデータからNSStringを 生 成 する C 文 字 列 からNSStringオブジェクトを 生 成 するには たとえばinitWithCString:encoding:メソッ ドを 使 います この 場 合 C 文 字 列 の 文 字 エンコーディングを 正 しく 指 定 しなければなりません ほ かにも さまざまなエンコーディングの 文 字 から 文 字 列 オブジェクトを 生 成 するメソッドがいくつ かあります たとえばinitWithData:encoding:メソッドは NSDataオブジェクトに 収 容 された 文 字 列 データを NSStringオブジェクトに 変 換 します char *utf8string = /* 何 らかの 値 があるものと 仮 定 */ ; 8

9 文 字 列 オブジェクトの 生 成 と 変 換 文 字 列 を 生 成 する NSString *stringfromutfstring = [[NSString alloc] initwithutf8string:utf8string]; char *macosromanencodedstring = /* 何 らかの 値 があるものと 仮 定 */ ; NSString *stringfrommorstring = [[NSString alloc] initwithcstring:macosromanencodedstring encoding:nsmacosromanstringencoding]; NSData *shiftjisdata = /* 何 らかの 値 があるものと 仮 定 */ ; NSString *stringfromshiftjisdata = [[NSString alloc] initwithdata:shiftjisdata encoding:nsshiftjisstringencoding]; 以 下 に UTF-8 文 字 から 成 るNSStringオブジェクトをASCIIデータに 変 換 した 後 NSStringオブジェ クトに 逆 変 換 する 例 を 示 します unichar ellipsis = 0x2026; NSString *thestring = [NSString stringwithformat:@"to be continued%c", ellipsis]; NSData *asciidata = [thestring datausingencoding:nsasciistringencoding allowlossyconversion:yes]; NSString *asciistring = [[NSString alloc] initwithdata:asciidata encoding:nsasciistringencoding]; NSLog(@"Original: %@ (length %d)", thestring, [thestring length]); NSLog(@"Converted: %@ (length %d)", asciistring, [asciistring length]); // output: // Original: To be continued (length 16) // Converted: To be continued... (length 18) 9

10 文 字 列 オブジェクトの 生 成 と 変 換 文 字 列 を 生 成 する 注 意 : NSStringは 任 意 のバイト 列 を 収 容 できるデータコンテナではありません そのよ うな 機 能 が 必 要 な 場 合 はNSDataを 使 ってください 文 字 列 の 整 形 文 字 列 の 書 式 整 形 には 通 常 stringwithformat:メソッドやinitwithformat:メソッド(ローカラ イズする 場 合 はlocalizedStringWithFormat:)を 使 います この 系 列 のメソッド 群 は 書 式 文 字 列 をテンプレートとして 用 い 別 に 指 定 する 値 ( 文 字 列 他 のオブジェクト 数 値 など)を 埋 め 込 んで 新 たな 文 字 列 を 生 成 します テンプレートに 記 述 できる 書 式 指 定 子 については 文 字 列 オブジェク トの 整 形 (13 ページ)を 参 照 してください 既 存 の 文 字 列 オブジェクトに 別 の 文 字 列 を 追 記 して 新 しい 文 字 列 を 生 成 したいときは stringbyappendingstring:やstringbyappendingformat:を 使 います 後 者 は 書 式 文 字 列 を 指 定 す るようになっています NSString *hstring NSString *hwstring = [hstring stringbyappendingstring:@", world!"]; ユーザ 向 けに 表 示 する 文 字 列 ユーザに 向 けて 表 示 する 文 字 列 を 生 成 する 場 合 アプリケーションのローカライズにも 配 慮 してくだ さい 一 般 に アプリケーション 上 でユーザが 目 にすることになる 文 字 列 を コード 中 に 直 接 記 述 し てはなりません 代 わりにローカライズ 用 辞 書 のキーを 記 述 してください この 辞 書 に 言 語 設 定 に 応 じた 文 字 列 を 収 容 します 具 体 的 には 次 の 例 のように NSLocalizedStringやその 系 列 のマク ロを 使 います NSString *greeting = NSLocalizedStringFromTable to present in first launch アプリケーションの 国 際 化 について 詳 しくは Internationalization and Localization Guide を 参 照 し てください Localizing String Resources には ローカライズ 済 み 文 字 列 中 に 可 変 部 分 を 設 け その 順 序 を 調 整 する 方 法 の 説 明 が 載 っています 10

11 文 字 列 オブジェクトの 生 成 と 変 換 文 字 列 を 結 合 抽 出 する 文 字 列 を 結 合 抽 出 する 文 字 列 を 結 合 抽 出 する 手 段 もさまざま 揃 っています 2つの 文 字 列 を 結 合 する 最 も 簡 単 な 手 段 は 追 記 でしょう stringbyappendingstring:メソッドは レシーバの 文 字 列 と 引 数 として 指 定 された 文 字 列 を 結 合 し 新 たに 文 字 列 を 生 成 して 返 します NSString *beginning NSString *alphaandomega = [beginning stringbyappendingstring:@" and end"]; // alphaandomega and end" テンプレートに 従 って 文 字 列 を 結 合 することも 可 能 で それにはinitWithFormat: stringwithformat: stringbyappendingformat:などのメソッドを 使 います 詳 しくは 文 字 列 オ ブジェクトの 整 形 (13 ページ)を 参 照 してください 文 字 列 の 先 頭 または 末 尾 から 数 えた 文 字 数 や 範 囲 を 指 定 して 部 分 文 字 列 を 抽 出 することも 可 能 で substringtoindex: substringfromindex: substringwithrange:などのメソッドを 使 います 区 切 り 文 字 を 指 定 して 部 分 文 字 列 に 分 割 するためにはcomponentsSeparatedByString:メソッドが あります 使 用 例 を 以 下 に 示 します インデックスを 指 定 するメソッドの 場 合 番 号 は0から 始 まる ことに 注 意 してください NSString *source NSString *firstfour = [source substringtoindex:4]; // firstfour NSString *allbutfirstthree = [source substringfromindex:3]; // allbutfirstthree NSRange twotosixrange = NSMakeRange(2, 4); NSString *twotosix = [source substringwithrange:twotosixrange]; // twotosix NSArray *split = [source componentsseparatedbystring:@"45"]; // split } インデックスではなくパターン 照 合 の 方 法 で 文 字 列 を 抽 出 したい 場 合 は 字 句 解 析 器 を 使 ってくださ い( 字 句 解 析 器 (37 ページ)を 参 照 ) 11

12 文 字 列 オブジェクトの 生 成 と 変 換 C 文 字 列 を 取 得 する C 文 字 列 を 取 得 する 文 字 列 オブジェクトからC 文 字 列 を 取 得 するには UTF8Stringメソッドを 使 うとよいでしょう 戻 り 値 型 はconst char *で UTF8エンコーディングの 文 字 列 になります const char *cstring = [@"Hello, world" UTF8String]; 戻 り 値 であるC 文 字 列 を 所 有 するのは 一 時 オブジェクトで 自 動 解 放 の 機 構 が 働 くと 無 効 になります 永 続 的 なC 文 字 列 が 必 要 な 場 合 は バッファを 生 成 し const char * 型 の 戻 り 値 の 内 容 をコピーしな ければなりません 同 様 に Unicodeその 他 任 意 のエンコーディングの 文 字 から 文 字 列 オブジェクトを 生 成 し あるいは 任 意 のエンコーディングでデータを 抽 出 することも 可 能 です initwithdata:encoding:および datausingencoding:は NSDataオブジェクトとの 間 でこのような 変 換 を 行 います 変 換 メソッドの 概 要 文 字 列 オブジェクトの 生 成 や 変 換 によく 使 われる 方 法 を 要 約 して 示 します 生 成 / 変 換 元 コード 中 に 記 述 UTF8エンコーディングの 文 字 列 生 成 方 構 築 ) stringwithutf8string: 書 き 出 し 該 当 なし UTF8String Unicodeエンコーディングの 文 字 列 任 意 のエンコーディングの 文 字 列 既 存 の 文 字 列 書 式 文 字 列 ローカライズ 済 み 文 字 列 stringwithcharacters: length: initwithdata: encoding: stringbyappendingstring: stringbyappendingformat: localizedstringwithformat: initwithformat: locale: NSLocalizedStringおよびその 系 列 getcharacters: getcharacters:range: datausingencoding: 該 当 なし NSScannerを 使 用 該 当 なし 12

13 文 字 列 オブジェクトの 整 形 この 章 では 書 式 文 字 列 を 使 って 文 字 列 を 生 成 する 方 法 書 式 文 字 列 中 に 非 ASCII 文 字 を 入 れる 方 法 を 解 説 し NSLogやNSLogvを 利 用 する 際 によくある 誤 りを 示 します 書 式 整 形 の 基 本 事 項 NSStringは 書 式 文 字 列 が 使 えます その 構 文 は 他 の 書 式 整 形 オブジェクトに 倣 っています すな わち ANSI Cの 関 数 printf()で 定 義 されている 書 式 文 字 および 任 意 のオブジェクトを 表 す で す( 文 字 列 の 書 式 指 定 子 (16 ページ)および IEEE printf specification を 参 照 ) 書 式 文 字 列 中 に %@ があると 該 当 するオブジェクトがdescriptionWithLocale:メッセージに 応 答 できる 場 合 NSStringは 当 該 メッセージを 送 信 してそのテキスト 表 現 を 取 得 します そうでなければdescription メッセージを 使 います Localizing String Resources には ローカライズ 済 み 文 字 列 中 に 可 変 部 分 を 設 け その 順 序 を 調 整 する 方 法 の 説 明 が 載 っています 書 式 文 字 列 中 % という 文 字 は 値 を 埋 め 込 む 位 置 これに 続 く 文 字 が 整 形 方 法 を 表 します たと えば"%d houses"という 書 式 文 字 列 ならば %d の 部 分 を 整 数 値 で 置 き 換 えることになります NSStringは ANSI Cの 関 数 printf()で 定 義 されている 書 式 文 字 および 任 意 のオブジェクトを 表 が 使 えるようになっています 書 式 文 字 列 中 に %@ があると 該 当 するオブジェクトが descriptionwithlocale:メッセージに 応 答 できる 場 合 NSStringは 当 該 メッセージを 送 信 してそ のテキスト 表 現 を 取 得 します そうでなければdescriptionメッセージを 使 います 値 の 書 式 整 形 方 法 は ユーザが 現 在 選 択 しているロケール すなわち 数 値 日 付 その 他 の 書 式 を 指 定 するNSDictionaryオブジェクトにも 依 存 します もっとも NSStringが 使 うロケール 設 定 は 10 進 数 値 の 区 切 り 文 字 (NSDecimalSeparatorキーで 指 定 )だけです ロケールを 指 定 しないメソッ ドの 場 合 デフォルトのロケールを 使 うものと 想 定 します NSStringのstringWithFormat:メソッドやその 系 列 を 使 うと printf 型 の 書 式 指 定 子 を 使 った 整 形 文 字 列 に 基 づき 値 を 埋 め 込 んだ 文 字 列 を 生 成 できます( Creating and Converting String Objects (8 ページ)を 参 照 ) 各 種 の 書 式 指 定 子 と 引 数 を 使 って 文 字 列 を 生 成 する 例 を 示 します NSString *string1 = [NSString stringwithformat:@"a string: %@, a float: %1.2f", // string1 is "A string: string, a float: ]; 13

14 文 字 列 オブジェクトの 整 形 文 字 列 と 非 ASCII 文 字 NSNumber *number NSDictionary *dictionary [NSDate date]}; NSString *basestring string."; NSString *string2 = [basestring A number: %@, a dictionary: %@", number, dictionary]; // string2 is "Base string. A number: 1234, a dictionary: {date = :02: ; }" 文 字 列 と 非 ASCII 文 字 文 字 列 中 に 非 ASCII 文 字 (Unicodeを 含 む)を 入 れたいときは stringwithformat: stringwithutf8string:などのメソッドを 使 います NSString *s = [NSString stringwithformat:@"long %C dash", 0x2014]; Unicodeの 文 字 0x2014(コードポイント)をUTF-8でエンコードすると \xe2\x80\x94 という3バイ トになるので 次 のようにも 記 述 できます NSString *s = [NSString stringwithutf8string:"long \xe2\x80\x94 dash"]; NSLogとNSLogv ユーティリティ 関 数 NSLog()およびNSLogv()は NSStringの 文 字 列 整 形 機 能 を 援 用 してエラーメッ セージをログに 出 力 します したがって この 関 数 に 引 数 を 指 定 する 際 には 注 意 してください 次 の ように 文 字 列 中 に 書 式 指 定 子 を 含 めてしまう という 誤 りがよくあります NSString *string contrived string %@"; NSLog(string); // The application will probably crash here due to signal 10 (SIGBUS) したがって 次 のように 別 の 文 字 列 を 出 力 するための 整 形 文 字 列 を 指 定 する 方 が 安 全 です NSString *string contrived string %@"; NSLog(@"%@", string); 14

15 文 字 列 オブジェクトの 整 形 NSLogとNSLogv // Output: A contrived string %@ 15

16 文 字 列 の 書 式 指 定 子 この 章 では 文 字 列 整 形 メソッド/ 関 数 に 指 定 できる 書 式 指 定 子 を 要 約 して 示 します 書 式 指 定 子 NSStringやCFStringの 整 形 メソッド/ 関 数 に 指 定 できる 書 式 指 定 子 は IEEE printf specification に 従 っています その 要 約 を 表 1 (16 ページ)に 示 します なお 位 置 指 定 子 n$ を 使 って %1$@ %2$s のように 指 定 することも 可 能 です 詳 しくは IEEE printf specification を 参 照 してください この 書 式 指 定 子 はNSLog 関 数 でも 使 えます 表 1 指 定 子 %@ %% %d %D %u %U %x %X %o %O %f %e %E NSStringやCFStringの 整 形 メソッド/ 関 数 で 使 える 書 式 指 定 子 説 明 Objective-Cのオブジェクトの 文 字 列 表 現 descriptionwithlocale:メソッドがあ ればその 戻 り 値 なければdescriptionメソッドの 戻 り 値 になります CFTypeRef オブジェクトに 対 しても 適 用 可 能 で この 場 合 CFCopyDescription 関 数 の 戻 り 値 を 使 います '%'という 文 字 自 身 符 号 付 き32ビット 整 数 (int) 符 号 なし32ビット 整 数 (unsigned int) 符 号 なし32ビット 整 数 (unsigned int)の16 進 表 示 数 字 (0-9)と 英 小 文 字 (a-f) で 表 記 符 号 なし32ビット 整 数 (unsigned int)の16 進 表 示 数 字 (0-9)と 英 大 文 字 (A-F) で 表 記 符 号 なし32ビット 整 数 (unsigned int)の8 進 表 示 64ビット 浮 動 小 数 点 数 (double) 64ビット 浮 動 小 数 点 数 (double)の 指 数 表 記 指 数 部 の 先 頭 は 小 文 字 の e 64ビット 浮 動 小 数 点 数 (double)の 指 数 表 記 指 数 部 の 先 頭 は 大 文 字 の E 16

17 文 字 列 の 書 式 指 定 子 書 式 指 定 子 指 定 子 %g %G %c %C %s %S %p %a %A %F 説 明 64ビット 浮 動 小 数 点 数 (double) 指 数 部 が-4 未 満 または 精 度 以 上 であれば%eと 同 じ そうでなければ%fと 同 じ 64ビット 浮 動 小 数 点 数 (double) 指 数 部 が-4 未 満 または 精 度 以 上 であれば%Eと 同 じ そうでなければ%fと 同 じ 8ビット 符 号 なし 文 字 (unsigned char) NSLog()でASCII 文 字 として 出 力 非 ASCII 文 字 は8 進 形 式 (\\ddd) またはUnicodeの16 進 形 式 (\\udddd 但 しdは 数 字 ) 16ビットUnicode 文 字 (unichar) NSLog()でASCII 文 字 として 出 力 非 ASCII 文 字 は8 進 形 式 (\\ddd) またはUnicodeの16 進 形 式 (\\udddd 但 しdは 数 字 ) 8ビット 符 号 なし 文 字 の 配 列 ( 末 尾 はNull) %s 指 定 子 があると システムデフォル トのエンコーディングとして 文 字 を 解 釈 するので 特 に 書 字 方 向 が 右 から 左 (RTL Right-To-Left)の 言 語 の 場 合 結 果 が 変 わる 可 能 性 があります たとえば 強 い 方 向 付 けがない 文 字 の 場 合 %s 書 字 方 向 マーカが 挿 入 されるのです したがって %sの 使 用 を 避 け エンコーディングを 明 示 的 に 指 定 する 方 がよいでしょう 16ビットUnicode 文 字 の 配 列 ( 末 尾 はNull) voidポインタ(void *) 先 頭 に 0x を 置 いた16 進 表 示 数 字 (0-9)および 英 小 文 字 (a-f)で 表 記 64ビット 浮 動 小 数 点 数 (double)の 指 数 表 記 先 頭 に 0x 小 数 点 の 前 に16 進 数 字 を1つ 指 数 部 の 先 頭 は 小 文 字 の p 64ビット 浮 動 小 数 点 数 (double)の 指 数 表 記 先 頭 に 0X 小 数 点 の 前 に16 進 数 字 を1つ 指 数 部 の 先 頭 は 大 文 字 の P 64ビット 浮 動 小 数 点 数 (double)の10 進 表 記 表 2 長 さ 修 飾 子 h hh l ll q NSStringやCFStringの 整 形 メソッド/ 関 数 に 指 定 できる 長 さ 修 飾 子 説 明 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がshortまたはunsigned short であることを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がsigned charまたはunsigned charであることを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がlongまたはunsigned longで あることを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がlong longまたはunsigned long longであることを 指 定 17

18 文 字 列 の 書 式 指 定 子 プラットフォームによる 違 い 長 さ 修 飾 子 L z t j 説 明 変 換 指 定 子 a A e E f F g Gの 前 に 置 いて 引 数 がlong doubleである ことを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がsize_tまたはこれに 類 する 符 号 つき 整 数 であることを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がptrdiff_tまたはこれに 類 する 符 号 なし 整 数 であることを 指 定 変 換 指 定 子 d o u x Xの 前 に 置 いて 引 数 がintmax_tまたはuintmax_tで あることを 指 定 プラットフォームによる 違 い OS Xは NSInteger NSUInteger CGFloat CFIndexなどさまざまなデータ 型 を 使 っており 32 ビット 環 境 64ビット 環 境 それぞれにおいて 値 の 意 味 は 一 貫 しています 32ビット 環 境 では NSIntegerとNSUIntegerはそれぞれ int 型 とunsigned int 型 を 表 します 一 方 64ビット 環 境 の 場 合 NSIntegerとNSUIntegerはそれぞれ long 型 とunsigned long 型 を 表 します プラットフォー ムが 変 わるとprintf 方 式 の 型 指 定 子 が 違 ってしまうのに 対 処 するため 表 3のように 指 定 するとよいで しょう なお 値 をキャストしなければならないこともあります 表 3 データ 型 に 応 じた 書 式 指 定 子 型 NSInteger NSUInteger CGFloat CFIndex ポインタ 書 式 指 定 子 %ldまたは%lx %luまたは%lx %fまたは%g %ldまたは%lx %pまたは%zx 考 慮 点 値 をlongにキャスト 値 をunsigned longにキャスト 整 形 の 場 合 %fはfloat doubleの 両 方 に 有 効 ただし 書 式 指 定 に 従 って 文 字 列 を 解 析 するときは 下 記 の 注 意 点 を 参 照 NSIntegerと 同 様 %pならば 先 頭 に 0x と 印 字 これが 不 要 であれば%zxを 指 定 し 型 のキャストはしない NSInteger 型 の 値 にキャストを 施 して%ldを 適 用 する 例 を 示 します 18

19 文 字 列 の 書 式 指 定 子 プラットフォームによる 違 い NSInteger i = 42; printf("%ld\n", (long)i); 表 3に 示 した 考 慮 点 以 外 にも 書 式 指 定 に 従 って 文 字 列 を 解 析 する 場 合 考 えなければならない 点 が あります すなわち この 場 合 floatとdoubleを 区 別 しなければなりません floatならば%f double ならば%lfを 指 定 してください また scanf(またはその 系 列 )で 変 換 結 果 をCGFloat 型 変 数 に 取 り 込 みたい 場 合 は いったんdouble 型 の 変 数 に 取 り 込 んだ 後 double 型 変 数 にCGFloatをコピーし てください CGFloat imagewidth; double tmp; sscanf (str, "%lf", &tmp); imagewidth = tmp; 重 要 なのは 32ビット/64ビット 環 境 のどちらでも %lfがcgfloat 型 変 数 を 正 しく 表 さないことで す %ldがどちらの 環 境 でもlongに 正 しく 適 用 できるのとは 状 況 が 違 います 19

20 ファイルやURLに 対 する 文 字 列 の 読 み 書 き ファイルから あるいはURLを 指 定 して 文 字 列 をNSStringに 読 み 込 む 処 理 は エンコーディングが 分 かっていれば 何 の 問 題 もありませんが 不 明 な 場 合 はいろいろと 難 しい 点 があります 一 方 書 き 出 しの 場 合 は エンコーディングの 指 定 が 必 須 です( 効 率 のため 可 能 な 限 りURLを 使 ってくださ い) ファイルやURLから 読 み 込 む NSStringにはファイルやURLを 指 定 してデータを 読 み 込 む 各 種 のメソッドがあります 一 般 に エン コーディングが 分 かっていれば データの 読 み 込 みは 容 易 です 一 方 プレーンテキストであること しか 分 からなければ その 時 点 で 問 題 をひとつ 抱 えていることになります できる 限 りこのような 状 況 は 回 避 しなければなりません プレーンテキストファイルを 対 象 とする 関 数 /メソッドは エンコー ディングの 指 定 が 必 須 です(UTF-8やUTF-16+BOMであれば 理 想 的 ) エンコーディングが 分 かっているデータを 読 み 込 む エンコーディングが 分 かっている 場 合 次 の 例 のように stringwithcontentsoffile:encoding:error: stringwithcontentsofurl:encoding:error: あるいはinit... 系 のメソッドで 読 み 込 むことができます NSURL *URL =...; NSError *error; NSString *stringfromfileaturl = [[NSString alloc] initwithcontentsofurl:url encoding:nsutf8stringencoding error:&error]; if (stringfromfileaturl == nil) { // an error occurred NSLog(@"Error reading file at %@\n%@", URL, [error localizedfailurereason]); // implementation continues... 20

21 ファイルやURLに 対 する 文 字 列 の 読 み 書 き ファイルやURLから 読 み 込 む 次 の 例 のように データオブジェクトを 使 って 文 字 列 を 初 期 化 することも 可 能 です この 場 合 もエン コーディングを 正 しく 指 定 しなければなりません NSURL *URL =...; NSData *data = [NSData datawithcontentsofurl:url]; // Assuming data is in UTF8. NSString *string = [NSString stringwithutf8string:[data bytes]]; // if data is in another encoding, for example ISO NSString *string = [[NSString alloc] initwithdata:data encoding: NSISOLatin1StringEncoding]; エンコーディングが 未 知 のデータを 読 み 込 む エンコーディングが 未 知 のテキストを 扱 う 場 合 エラー 発 生 時 の 対 処 法 があるかどうか 確 認 しておく とよいでしょう たとえば Appleの Mail や Safari にはエンコーディングを 指 定 するメニュー TextEdit には 明 示 的 にエンコーディングを 指 定 してファイルを 開 き 直 す 機 能 があります エンコーディングを 推 測 せざるを 得 ない 場 合 ( 明 示 的 に 情 報 が 与 えられなければ 推 測 は 不 可 避 ) 次 のようにするとよいでしょう 1. stringwithcontentsoffile:usedencoding:error:または initwithcontentsoffile:usedencoding:error:(あるいはurlを 指 定 して 呼 び 出 す 同 等 のメ ソッド)を 実 行 してみてください このメソッドはエンコーディングの 判 定 を 試 み 成 功 した 場 合 は 参 照 渡 しでそのエンコーディン グを 返 します 2. (1)に 失 敗 した 場 合 UTF-8を 指 定 して 試 します 3. (2)にも 失 敗 した 場 合 は 何 らかの 適 当 なエンコーディングを 試 します 適 当 な の 意 味 は 状 況 にも 依 存 します C 文 字 列 のデフォルトエンコーディング ISO Windows Latin 1など データの 供 給 元 に 応 じて 判 断 してください 4. 最 後 に Application Kitに 付 属 する NSAttributedStringの 読 み 込 みメソッド (initwithurl:options:documentattributes:error:など)を 試 してください これはプレーンテキストファイルの 読 み 込 みを 試 み 実 際 に 用 いたエンコーディングを 返 しま す ほぼあらゆるテキスト 文 書 を 対 象 とすることができるので テキストに 関 する 前 提 知 識 が 何 もない 場 合 は 試 してみる 価 値 があるでしょう もっとも 自 然 言 語 ではない Foundationレベル のツールや 文 書 には 向 かないかも 知 れません 21

22 ファイルやURLに 対 する 文 字 列 の 読 み 書 き ファイルやURLに 書 き 出 す ファイルやURLに 書 き 出 す データの 書 き 出 しは 読 み 込 みに 比 べれば 分 かりやすいでしょう NSStringには writetofile:atomically:encoding:error:およびwritetourl:atomically:encoding:error:と いう 便 利 なメソッドがあります どちらの 場 合 も エンコーディングと アトミックに 書 き 込 むか 否 かを 指 定 しなければなりません アトミックでないとした 場 合 文 字 列 は 指 定 したパスに 直 接 書 き 込 まれます アトミックであると 指 定 すれば 補 助 ファイルにいったん 書 き 込 んだ 後 ファイル 名 を 変 更 するようになります こうすれば 既 存 のファイルに 上 書 きする 際 書 き 込 み 中 にシステムがク ラッシュしても 元 のファイルは 破 損 せずに 残 ります ただし URLを 指 定 して 書 き 込 む 場 合 書 き 込 み 先 にアトミックにアクセスできなければこの 指 定 は 無 視 されます NSURL *URL =...; NSString *string =...; NSError *error; BOOL ok = [string writetourl:url atomically:yes encoding:nsunicodestringencoding error:&error]; if (!ok) { // an error occurred NSLog(@"Error writing file at %@\n%@", path, [error localizedfailurereason]); // implementation continues... まとめ ファイルやURLを 対 象 として 文 字 列 オブジェクトを 読 み 書 きする よく 使 われる 方 法 を 表 にまとめま す 読 み 込 み 元 / 書 き 出 し 先 URLの 内 容 ファイルの 内 容 生 成 方 法 stringwithcontentsofurl: encoding:error: stringwithcontentsofurl: usedencoding:error: stringwithcontentsoffile: encoding:error: stringwithcontentsoffile: usedencoding:error: 書 き 出 し writetourl: atomically:encoding: error: writetofile: atomically:encoding: error: 22

23 文 字 列 の 検 索 比 較 整 列 文 字 列 クラスには 文 字 列 中 の 文 字 や 部 分 文 字 列 を 検 索 する あるいは 他 の 文 字 列 と 比 較 するための メソッドがあります いずれもUnicode 規 格 に 従 って 2つの 文 字 の 並 びが 同 等 か 否 かを 判 定 するよう になっています 文 字 列 クラスの 比 較 メソッドは 結 合 文 字 列 を 適 切 に 扱 いますが 処 理 効 率 を 重 視 す る 場 合 結 合 文 字 列 が 何 らかの 標 準 形 になっていると 保 証 できるならば ( 結 合 文 字 列 を 考 慮 しな い)リテラル 検 索 を 指 定 しても 構 いません 検 索 / 比 較 メソッド 検 索 / 比 較 メソッドにはさまざまな 変 種 があります 最 も 単 純 なのは 文 字 列 全 体 を 対 象 とするもの です それ 以 外 に 結 合 文 字 列 の 比 較 方 法 を 変 更 できる 文 字 列 中 のある 範 囲 を 指 定 して 検 索 / 比 較 する ロケールを 指 定 して 検 索 / 比 較 する などの 変 種 もあります 以 下 に 基 本 的 な 検 索 / 比 較 メソッドを 示 します 検 索 メソッド rangeofstring: rangeofstring: options: rangeofstring: options:range: rangeofstring: options:range: locale: 比 較 メソッド compare: compare:options: compare:options: range: compare:options: range:locale: rangeofcharacterfromset: rangeofcharacterfromset: options: rangeofcharacterfromset: options:range: 文 字 列 を 検 索 する rangeofstring:... 系 のメソッドで レシーバである 文 字 列 中 の 部 分 文 字 列 を 検 索 できます rangeofcharacterfromset:... 系 のメソッドは 文 字 の 集 合 を 指 定 して そのいずれかの 文 字 を 検 索 します 23

24 文 字 列 の 検 索 比 較 整 列 検 索 / 比 較 メソッド 部 分 文 字 列 が 見 つかるのは 指 定 した 範 囲 内 に 完 全 に 当 該 文 字 列 が 含 まれている 場 合 に 限 ります NSLiteralSearch( 下 記 参 照 )を 指 定 した 場 合 を 除 き 検 索 / 比 較 メソッドに 指 定 する 範 囲 が 結 合 文 字 列 を 分 断 するようなものであってはなりません 分 断 する 場 合 誤 った 結 果 になる 可 能 性 があり ます( 分 断 しないよう 範 囲 を 調 整 するコード 例 が rangeofcomposedcharactersequenceatindex: メソッドを 説 明 している 節 に 載 っています) また NSScannerのインスタンスを 使 うと 文 字 列 オブジェクトを 走 査 し 数 値 や 文 字 列 値 を 抽 出 で きます 字 句 解 析 器 については 字 句 解 析 器 (37 ページ)を 参 照 してください NSString NSScannerのいずれも NSCharacterSetクラスクラスタを 用 いる 検 索 が 可 能 です 文 字 集 合 につい ては 文 字 集 合 (34 ページ)を 参 照 してください あるパターンに 合 致 する 箇 所 が 文 字 列 中 にあるかどうか 判 定 したいだけであれば 術 語 を 利 用 すると よいでしょう BOOL match = [mypredicate evaluatewithobject:mystring]; 術 語 について 詳 しくは Predicate Programming Guide を 参 照 してください 文 字 列 を 比 較 整 列 する compare:... 系 のメソッドは レシーバである 文 字 列 と 引 数 として 指 定 した 文 字 列 を 比 較 し 辞 書 的 順 序 を 返 します ほかに 一 方 の 文 字 列 がもう 一 方 に 完 全 一 致 / 前 方 一 致 / 後 方 一 致 しているかどうか を 判 定 するメソッドもありますが これに 検 索 オプションや 範 囲 を 指 定 できる 変 種 はありません 文 字 列 を 比 較 する 最 も 単 純 なメソッドはcompare:でしょう これは オプションを 指 定 せず 文 字 列 全 体 を 比 較 範 囲 として compare:options:range:メソッドを 呼 び 出 すのと 同 等 です 比 較 オプ ション(NSCaseInsensitiveSearch NSLiteralSearch NSNumericSearch)を 指 定 する 場 合 は compare:options:メソッド さらにロケールも 指 定 する 場 合 はcompare:options:range:locale: メソッドを 使 います NSStringにはさらに 範 囲 やオプションを 指 定 しなくても 一 般 的 な 比 較 がで きる caseinsensitivecompare: localizedcompare:などのメソッドもあります Important: ユーザ 向 けに 表 示 する 目 的 で 文 字 列 を 整 列 する 場 合 は 必 ず ローカライズを 考 慮 して 比 較 してください したがって 通 常 compare:やcaseinsensitivecompare:の 代 わりに localizedcompare:やlocalizedcaseinsensitivecompare:を 使 うことになります Finderに 現 れるのと 同 じ 順 序 に 並 ぶよう 文 字 列 を 比 較 するためには compare:options:range:locale: メソッドを 用 い ユーザのロケールのほか オプションとしてNSCaseInsensitiveSearch, NSNumericSearch NSWidthInsensitiveSearch NSForcedOrderingSearchを 指 定 してください Finderに 現 れるのと 同 じ 順 序 に 整 列 する (27 ページ)にその 例 が 載 っています 24

25 文 字 列 の 検 索 比 較 整 列 検 索 / 比 較 のオプション 検 索 / 比 較 のオプション 検 索 / 比 較 メソッドの 中 には 引 数 options を 指 定 できるものがあります これはビットマスクの 形 になっており 必 要 に 応 じていくつでも 指 定 できます 以 下 のオプションを 組 み 合 わせてマスクを 生 成 してください(メソッドによっては 指 定 しても 何 の 効 果 もないオプションがあります) 検 索 オプション NSCaseInsensitive- Search NSLiteralSearch NSBackwardsSearch NSAnchoredSearch NSNumericSearch 効 果 大 文 字 と 小 文 字 を 区 別 しません バイト 単 位 で 比 較 します ( 結 合 文 字 列 などの 規 則 によって) 同 等 と 看 做 されるものであっても バイト 列 として 違 いがあれば 異 なる 文 字 列 として 扱 います 状 況 によっては 処 理 速 度 が 劇 的 に 向 上 しま す 範 囲 の 末 尾 から 先 頭 に 向 かって 検 索 します 範 囲 の 先 頭 (NSBackwardsSearchも 指 定 した 場 合 は 末 尾 )のみを 検 索 の 対 象 とします 先 頭 / 末 尾 で 見 つからなければ 文 字 列 中 のほか の 位 置 にあっても 見 つからなかったことになります compare:options:メソッドに 指 定 すれば 比 較 の 際 数 字 の 並 びを 数 値 として 扱 うようになります たとえば Filename9.txt < Filename20.txt < Filename100.txtとなります 現 在 は 検 索 や 比 較 を NSLiteralSearchオプションが 指 定 されているものとして 実 行 するように なっています 例 大 文 字 と 小 文 字 を 区 別 しない 前 方 一 致 / 後 方 一 致 の 検 索 NSStringにはhasPrefix:およびhasSuffix:というメソッドがあり 先 頭 / 末 尾 部 分 の 完 全 一 致 によ る 検 索 をすることができます rangeofstring:options:にオプションを 指 定 して 大 文 字 と 小 文 字 を 区 別 しない 検 索 を 行 う 例 を 示 します NSString *searchstring NSString *beginstest NSRange prefixrange = [beginstest rangeofstring:searchstring 25

26 文 字 列 の 検 索 比 較 整 列 例 options:(nsanchoredsearch NSCaseInsensitiveSearch)]; // prefixrange = {0, 3} NSString *endstest NSRange suffixrange = [endstest rangeofstring:searchstring options:(nsanchoredsearch NSCaseInsensitiveSearch NSBackwardsSearch)]; // suffixrange = {6, 3} 文 字 列 の 比 較 各 種 の 文 字 列 比 較 メソッド および 関 係 するオプションの 使 用 例 を 示 します まず 最 も 単 純 な 比 較 メソッドです NSString *string1 NSString *string2 NSComparisonResult result; result = [string1 compare:string2]; // result = -1 (NSOrderedAscending) NSNumericSearchオプションを 指 定 すれば 数 字 の 並 びを 数 値 と 看 做 して 比 較 できます NSString *string10 NSString *string2 NSComparisonResult result; result = [string10 compare:string2]; // result = -1 (NSOrderedAscending) result = [string10 compare:string2 options:nsnumericsearch]; // result = 1 (NSOrderedDescending) 簡 易 メソッド(caseInsensitiveCompare: localizedcaseinsensitivecompare:)で 大 文 字 と 小 文 字 を 区 別 しない 比 較 ができます 26

27 文 字 列 の 検 索 比 較 整 列 例 NSString *string_a NSString *string_a result = [string_a compare:string_a]; // result = 1 (NSOrderedDescending) result = [string_a caseinsensitivecompare:string_a]; // result = 0 (NSOrderedSame) // equivalent to [string_a compare:string_a options:nscaseinsensitivesearch] Finderに 現 れるのと 同 じ 順 序 に 整 列 する OS X v10.6 以 降 のFinderに 現 れるのと 同 じ 順 序 に 文 字 列 を 整 列 する 場 合 localizedstandardcompare: メソッドで 比 較 します リストや 表 に ファイル 名 その 他 の 文 字 列 を Finderと 同 じような 順 序 で 並 べたい 場 合 に 利 用 してください 具 体 的 な 動 作 はローカライズの 状 況 によっても 違 うので クライア ント 側 で 特 定 の 整 列 順 序 になることを 前 提 とした 処 理 をしてはなりません 以 下 の 例 では Finderと 同 じ 規 則 で 比 較 する 処 理 を 別 の 方 法 で 実 装 した 後 文 字 列 の 配 列 を 整 列 する 方 法 を 示 します まず 比 較 オプションを 適 切 に 設 定 した 整 列 関 数 を 定 義 します( 便 宜 上 ロケール はコンテキストとして 指 定 ) int findersortwithlocale(id string1, id string2, void *locale) { static NSStringCompareOptions comparisonoptions = NSCaseInsensitiveSearch NSNumericSearch NSWidthInsensitiveSearch NSForcedOrderingSearch; NSRange string1range = NSMakeRange(0, [string1 length]); return [string1 compare:string2 options:comparisonoptions range:string1range locale:(nslocale *)locale]; } この 関 数 を 引 数 としてsortedArrayUsingFunction:context:に 渡 します ロケールはcontext: 引 数 で 指 定 します 27

28 文 字 列 の 検 索 比 較 整 列 例 NSArray *stringsarray 02"]; NSArray *sortedarray = [stringsarray sortedarrayusingfunction:findersortwithlocale context:[nslocale currentlocale]]; // sortedarray contains { "string 1", "String 02", "String 11", "string 12", "String 21" } 28

29 単 語 段 落 改 行 この 章 では 単 語 や 段 落 の 区 切 りを 定 義 する 方 法 改 行 を 表 示 する 方 法 文 字 列 を 段 落 に 区 切 る 方 法 を 解 説 します 単 語 の 区 切 り テキスト 処 理 系 が 単 語 の 区 切 りを 判 断 する 方 法 は 言 語 によって 異 なります Unicode Standard Annex #29 にもとづき ロケールに 応 じて 追 加 のカスタマイズを 施 してあります OS Xの 場 合 Cocoa には 単 語 の 区 切 りに 関 するAPIとして NSAttributedStringのdoubleClickAtIndex:メソッド nextwordfromindex:forward:メソッドがありますが 判 定 アルゴリズムそのものの 方 式 を 変 えるこ とはできません 行 や 段 落 の 区 切 り 文 字 行 や 段 落 の 区 切 りを 表 す 方 法 はいくつか 考 えられます 歴 史 的 には \n \r \r\nなどが 使 われて きました Unicodeには 明 確 に 定 義 した 段 落 区 切 り 文 字 U+2029(Cocoaでは 定 数 NSParagraphSeparatorCharacterで 参 照 可 能 )や 行 区 切 り 文 字 U+2028(Cocoaでは 定 数 NSLineSeparatorCharacterで 参 照 可 能 )があります Cocoaのテキスト 処 理 系 では NSParagraphSeparatorCharacterは 一 貫 して 段 落 区 切 り NSLineSeparatorCharacterは 一 貫 して 段 落 区 切 りではない 行 区 切 り すなわち 段 落 の 内 部 にある 行 区 切 りとして 扱 われます しかし 他 の 環 境 で このような 取 り 扱 いが 保 証 されていることはほとんど ありません たとえばPOSIXレベルのソフトウェアでは 多 くの 場 合 \nが 区 切 りと 認 識 されるだけ です 旧 Macintoshソフトウェアは\r 一 部 のWindowsソフトウェアは\r\nだけを 区 切 りと 認 識 しま す 行 区 切 りと 段 落 区 切 りの 区 別 はありません 適 切 な 行 / 段 落 区 切 り 文 字 は データの 使 い 方 やプラットフォームに 依 存 します Cocoaのテキスト 処 理 系 は \n \r \r\nをいずれも NSParagraphSeparatorCharacterと 同 等 の 段 落 区 切 り 文 字 と 認 識 します たとえばinsertNewline:メソッドで 段 落 区 切 りを 挿 入 する 場 合 実 際 に 使 うのは\nで す NSLineSeparatorCharacterは 元 々 たとえばinsertLineBreak:メソッドやHTMLの<br> 要 素 で 段 落 区 切 りではなく 行 区 切 りのために 使 われていました 29

30 単 語 段 落 改 行 文 字 列 を 段 落 ごとに 区 切 る 段 落 区 切 りではなく 特 に 行 区 切 りを 意 図 している 場 合 一 般 にNSLineSeparatorCharacterを 用 い るべきです そうでなければ テキストを 処 理 する 他 のソフトウェアに 合 わせて \n \r \r\nの いずれかを 使 ってください Cocoaのデフォルト 値 は\nとなっています 文 字 列 を 段 落 ごとに 区 切 る 一 般 に 文 字 列 を 段 落 ごとに 区 切 るには 次 のようにするのが 簡 単 です NSArray *arr = [mystring componentsseparatedbystring:@"\n"]; しかしこれは 段 落 や 行 を 区 切 る 方 法 が \rや\r\n あるいはUnicodeの 分 割 文 字 など 他 にもさま ざまあるという 事 実 に 目 をつぶっています 代 わりに linerangeforrange: getparagraphstart:end:contentsend:forrange:など 各 種 の 行 末 文 字 を 考 慮 したメソッドを 使 い 次 の 例 のようにするとよいでしょう NSString *string = /* 何 らかの 値 があるものと 仮 定 */; unsigned length = [string length]; unsigned parastart = 0, paraend = 0, contentsend = 0; NSMutableArray *array = [NSMutableArray array]; NSRange currentrange; while (paraend < length) { [string getparagraphstart:&parastart end:&paraend contentsend:&contentsend forrange:nsmakerange(paraend, 0)]; currentrange = NSMakeRange(paraStart, contentsend - parastart); [array addobject:[string substringwithrange:currentrange]]; } 30

31 文 字 と 書 記 素 クラスタ 文 字 列 は 文 字 の 並 びであると 考 えるのが 普 通 ですが NSStringオブジェクトやUnicode 文 字 列 一 般 を 扱 う 場 合 個 々の 文 字 ではなく 部 分 文 字 列 を 対 象 として 操 作 する 方 がよいでしょう というのも ユーザがテキスト 中 の 文 字 と 認 識 するものが 文 字 列 の 中 では 複 数 の 文 字 で 表 されていることも 少 な くないからです NSStringにはUnicode 文 字 列 を 適 切 に 処 理 するためのメソッドが 豊 富 に 揃 ってお り 容 易 にUnicode 規 格 に 沿 った 操 作 ができますが いくつか 注 意 事 項 があります NSStringオブジェクトは 概 念 的 にはUTF-16で 実 装 されています(エンディアンはプラットフォー ムに 依 存 ) といっても 内 部 のストレージ 機 構 がそうなっているとは 限 りません NSStringの 長 さ 文 字 インデックス 範 囲 はUTF-16の 単 位 で 表 され NSStringのメソッド 名 に 現 れる character とはUTF-16における 単 位 (16ビット 長 プラットフォームに 依 存 したエンディアン)である という だけのことです これは 文 字 列 オブジェクトに 関 する 一 般 的 な 取 り 決 めです 多 くの 場 合 クライア ント 側 は 特 別 に 意 識 しなくてもよいでしょう 部 分 文 字 列 を 扱 っている 限 り 範 囲 やインデックスの 厳 密 な 解 釈 は それほど 重 要 ではありません 現 用 言 語 の 記 述 に 用 いる Unicodeの 大 部 分 のコードポイントは 単 一 のUTF-16の 単 位 で 表 されます しかし あまり 一 般 的 でないコードポイントの 中 には 代 用 対 (surrogate pair)で 表 されるものがあ ります これは 所 定 の 範 囲 から 選 んだUTF-16の 単 位 を2つ 並 べたもので 組 になって 単 一 のUnicode コードポイントを 表 します CFStringには 代 用 対 と 対 応 するUnicodeコードポイントのUTF-32 表 現 とを 相 互 に 変 換 する 関 数 があります NSStringオブジェクトを 扱 う 際 の 制 約 のひとつに 部 分 文 字 列 の 境 界 が 代 用 対 を 分 断 してはならない という 規 則 があります Cocoaの 大 部 分 のメソッドが 返 す 範 囲 は 自 動 的 にこの 制 約 を 満 たすようになっていますが 部 分 文 字 列 の 範 囲 を 自 分 で 計 算 して 組 み 立 てる 場 合 は 頭 に 入 れておく 必 要 があります しかし 考 慮 するべき 制 約 は これだけではありませ ん 多 くの 書 記 体 系 で ひとつの 文 字 を 基 底 となる 文 字 にアクセント 記 号 その 他 の 装 飾 を 付 け 加 える 形 で 構 成 することがあります 文 字 もアクセント 類 も 数 が 多 いので Unicodeではその 組 み 合 わせすべ てにコードポイントを 与 えず 基 底 文 字 (base character)の 後 に 結 合 記 号 (combining mark)をいく つか 並 べて 表 現 するようにしています 互 換 性 を 考 慮 して 一 般 的 な 組 み 合 わせには 独 立 したコード ポイントを 与 えています これを 合 成 済 み 文 字 (precomposed character)と 言 います Unicode 正 規 化 変 換 により 合 成 済 み 文 字 とその 分 解 表 現 (decomposed representation)とを 相 互 に 変 換 できます しかし 文 字 列 を 可 能 な 限 り 合 成 済 み 文 字 で 構 成 しようとしても 基 底 文 字 と 結 合 記 号 でしか 表 現 で きない 組 み 合 わせは 多 数 あります 多 くのテキスト 処 理 では 部 分 文 字 列 の 範 囲 を 調 整 して その 境 界 が 基 底 文 字 と 結 合 記 号 を 分 断 しないようにしなければなりません 31

32 文 字 と 書 記 素 クラスタ さらに 書 記 体 系 によっては アクセント 記 号 よりも 複 雑 な 部 品 を 組 み 合 わせて 表 現 する 文 字 もあり ます たとえば 韓 国 語 の 場 合 ハングルのひとつの 音 節 文 字 が 字 母 (jamo) と 呼 ばれる2つか 3つの 部 分 から 成 り 立 っていることもあります 南 アジアから 東 南 アジアにかけて 広 がる インド 語 派 およびその 影 響 下 にある 書 記 体 系 では ひとつの 文 字 が 子 音 母 音 ビラーマその 他 の 記 号 の 組 み 合 わせで 表 されます Unicodeでは 個 々の 部 分 にのみコードポイントを 与 えていることが 多 く そ の 場 合 文 字 は 複 数 のコードポイントから 合 成 することになります テキスト 処 理 においては 部 分 文 字 列 の 範 囲 を 調 整 して ハングルの 音 節 文 字 中 の 字 母 や インド 語 派 の 子 音 群 (consonant cluster) の 構 成 要 素 を 分 断 しないようにしなければなりません 一 般 に 代 用 対 基 底 文 字 と 結 合 記 号 ハングルの 字 母 インド 語 派 の 子 音 群 などの 組 み 合 わせを 書 記 素 クラスタ(grapheme cluster)と 呼 びます これを 考 慮 して 処 理 するためには NSStringの rangeofcomposedcharactersequencesforrange:メソッドや rangeofcomposedcharactersequenceatindex:メソッド あるいは CFStringGetRangeOfComposedCharactersAtIndexを 使 うとよいでしょう 文 字 列 のインデックス や 部 分 文 字 列 の 範 囲 を 書 記 素 クラスタの 境 界 に 合 わせて 調 整 し 上 記 の 制 約 が 満 たされるようにす ることができます ユーザが 認 識 する 文 字 境 界 をプログラムで 判 定 する 必 要 があれば まずこのメ ソッドが 使 えないか 検 討 してください : Unicodeのアルゴリズムはときに 書 記 素 クラスタの 境 界 をも 越 えるような 形 で 複 数 の 文 字 を 扱 う ことがあります たとえば 小 文 字 から 大 文 字 への 変 換 アルゴリズムは 単 一 の 文 字 を 複 数 の 文 字 に 変 換 することがあります たとえばドイツ 文 字 ß を 大 文 字 で 表 すと SS という2つの 文 字 の 並 び になります また 言 語 によっては 文 字 照 合 アルゴリズムが 複 数 の 文 字 の 並 びをひとつの 単 位 と して 扱 うことがあります たとえばヨーロッパの 一 部 の 言 語 では 整 列 順 を 決 める 際 ch を 独 立 した 文 字 として 扱 います このような 場 合 でも 適 切 に 処 理 できるよう 大 文 字 小 文 字 変 換 整 列 検 索 においては NSStringの 標 準 メソッドを 文 字 列 全 体 に 適 用 することが 重 要 です NSStringメソッ ドである lowercasestring uppercasestring capitalizedstring compare:およびその 変 種 rangeofstring:およびその 変 種 rangeofcharacterfromset:およびその 変 種 あるいはCFString に 定 義 された 同 等 のメソッドを 使 ってください Unicode 文 字 列 の 複 雑 な 処 理 をすべて 考 慮 し 特 に 検 索 や 整 列 のメソッドは 何 を 同 じ 文 字 と 看 做 すか さまざまな 選 択 肢 を 組 み 込 んで 実 装 してあ ります ごく 稀 に 特 殊 な 使 い 方 に 合 わせて 書 記 素 クラスタの 定 義 を 微 調 整 しなければならないことがあり ます 書 記 素 クラスタの 境 界 を 判 定 調 整 する 際 の 問 題 点 については Unicode Standard Annex #29 を 参 照 してください さまざまな 例 に 加 え アルゴリズムもいくつか 載 っています Unicode 規 格 は 全 般 的 に Unicodeアルゴリズムや Unicode 文 字 列 処 理 に 関 する 検 討 事 項 についての 第 一 の 情 報 源 になっています カーソル 移 動 や 挿 入 位 置 の 処 理 という 観 点 から 書 記 素 クラスタ 境 界 について 詳 しく 知 りたい あるい はCocoaのテキスト 処 理 系 を 使 いたい 場 合 OS X v10.5 以 降 のNSLayoutManagerには レイアウトした テキストの 行 内 で 挿 入 位 置 を 判 定 するためのAPIがあるので 参 考 にするとよいでしょう なお 32

33 文 字 と 書 記 素 クラスタ 挿 入 点 境 界 とグリフ 境 界 は 同 じとは 限 りません たとえばラテン 文 字 の fi リガチャのように 目 に 見 える 文 字 境 界 とは 別 の 所 に 挿 入 点 が 必 要 になる 場 合 があります 詳 しくは CocoaTextArchitecture Guide を 参 照 してください 33

34 文 字 集 合 NSCharacterSetオブジェクトはUnicode 文 字 の 集 合 を 表 します NSStringやNSScannerは NSCharacterSetオブジェクトを 使 って 検 索 対 象 である 文 字 をグループ 化 し この 集 合 に 属 する 任 意 の 文 字 を 見 つけられるようにしています 文 字 集 合 に 関 する 基 本 事 項 文 字 集 合 オブジェクトは Unicode 文 字 の 集 合 を 表 します 実 際 には クラスクラスタのインスタン スで 表 すようになっています クラスタに 属 する2つの 公 開 クラス NSCharacterSetおよび NSMutableCharacterSetはそれぞれ 不 変 および 可 変 な 文 字 集 合 に 対 するプログラムインターフェ イスを 宣 言 しています 不 変 文 字 集 合 は 生 成 時 に 定 義 され 後 で 変 更 することはできません 一 方 可 変 文 字 集 合 は 生 成 後 でも 変 更 できます 文 字 集 合 オブジェクト 自 身 は 何 もタスクを 実 行 しません 文 字 列 に 対 する 処 理 を 制 約 するために 用 い る 文 字 値 の 集 合 を 保 持 するだけです NSStringおよびNSScannerクラスには 引 数 として NSCharacterSetオブジェクトを 取 り ある 文 字 集 合 に 属 する 文 字 を 検 索 するメソッドがあります たとえば 次 のコードは mystring: 中 の 最 初 の 英 大 文 字 を 範 囲 の 形 で 求 めます NSString *mystring text in an NSString..."; NSCharacterSet *characterset = [NSCharacterSet uppercaselettercharacterset]; NSRange letterrange = [mystring rangeofcharacterfromset:characterset]; rangeofcharacterfromset:を 実 行 した 結 果 letterrange.locationは NSString の 先 頭 にあ る N という 文 字 のインデックスに 等 しい 値 になります 文 字 列 の 先 頭 文 字 が S であったとすれ ば letterrange.locationの 値 は0になるはずです 文 字 集 合 を 生 成 する NSCharacterSetには 英 字 ( 大 文 字 小 文 字 ) 10 進 数 字 空 白 など よく 使 う 文 字 集 合 を 返 すク ラスメソッドがあります こういった 標 準 の 文 字 集 合 は NSMutableCharacterSetにメッセー ジを 送 信 して 取 得 したとしても 常 に 不 変 です 標 準 文 字 集 合 については 標 準 文 字 集 合 とUnicode 規 格 における 定 義 (36 ページ)を 参 照 してください 34

35 文 字 集 合 処 理 性 能 に 関 する 考 慮 事 項 標 準 文 字 集 合 を 出 発 点 として その 可 変 なコピーを 作 り 変 更 を 施 して 独 自 の 文 字 集 合 を 構 築 でき ます(allocとinitで 可 変 の 文 字 集 合 を 生 成 し 必 要 な 文 字 を 追 加 するという 方 法 もあります) た とえば 次 のコードは 英 数 字 や 主 な 句 読 点 から 成 る 文 字 集 合 を 生 成 します NSMutableCharacterSet *workingset = [[NSCharacterSet alphanumericcharacterset] mutablecopy]; [workingset addcharactersinstring:@";:,."]; NSCharacterSet *finalcharacterset = [workingset copy]; Unicodeのコードポイントで 文 字 を 指 定 して 独 自 の 文 字 集 合 を 定 義 する 場 合 は 次 のように 記 述 する とよいでしょう(これは 用 紙 送 り 文 字 と 行 区 切 り 文 字 から 成 る 文 字 集 合 を 生 成 する 例 ) UniChar chars[] = {0x000C, 0x2028}; NSString *string = [[NSString alloc] initwithcharacters:chars NSCharacterSet *characterset = [NSCharacterSet charactersetwithcharactersinstring:string]; length:sizeof(chars) / sizeof(unichar)]; 処 理 性 能 に 関 する 考 慮 事 項 文 字 集 合 を 扱 うコードは 処 理 性 能 のネックになることが 多 いので 性 能 に 影 響 を 与 えうる 要 因 を 意 識 しておかなければなりません 可 変 な 文 字 集 合 は 一 般 に 不 変 な 文 字 集 合 よりも 性 能 面 で 劣 ります 必 要 なメモリ 容 量 が 多 く ( 字 句 解 析 によく 現 れる) 反 転 処 理 にも 時 間 がかかります 次 のガイドラ インに 従 って 実 装 するとよいでしょう 可 変 な 文 字 集 合 はできるだけ 使 わないでください 必 要 の 都 度 生 成 し 直 すのではなく (グローバル 辞 書 などに)キャッシュしてください 独 自 の 文 字 集 合 を 生 成 し その 後 変 更 する 必 要 がない 場 合 は 不 変 な 文 字 集 合 を 生 成 してコピー し 元 の 可 変 な 文 字 集 合 は 破 棄 するとよいでしょう あるいは 文 字 集 合 のファイルを 生 成 し ( 文 字 集 合 ファイルを 生 成 する (36 ページ)を 参 照 ) アプリケーションの 主 バンドルに 格 納 しておく という 方 法 もあります 同 様 に 文 字 集 合 オブジェクトをアーカイブすることも 避 け 代 わりに 文 字 集 合 ファイルに 保 存 してください アーカイブすると 異 なるアーカイブファイルに 文 字 集 合 を 複 製 することにな り ディスク 空 間 の 無 駄 になるだけでなく アーカイブを 読 み 込 む 都 度 メモリを 消 費 すること になります 35

36 文 字 集 合 文 字 集 合 ファイルを 生 成 する 文 字 集 合 ファイルを 生 成 する 独 自 の 文 字 集 合 を 頻 繁 に 使 う 場 合 必 要 の 都 度 個 々の 文 字 を 追 加 して 生 成 する 代 わりに 定 義 をリ ソースファイルに 保 存 しておき 実 行 時 に 読 み 込 んで 使 うとよいでしょう 文 字 集 合 は そのビット マップ 表 現 (NSDataオブジェクト)を 取 得 し ファイルに 保 存 することができます NSData *charsetrep = [finalcharacterset bitmaprepresentation]; NSURL *dataurl = <#URL for character set#>; NSError *error; BOOL result = [charsetrep writetourl:dataurl options:nsdatawritingatomic error:&error]; 文 字 集 合 ファイルの 拡 張 子 は.bitmapとするのが 慣 習 になっています 文 字 集 合 ファイルを 他 のユー ザも 使 えるようにしたい 場 合 は この 慣 習 に 従 ってください 拡 張 子 が.bitmapの 文 字 集 合 ファイル は charactersetwithcontentsoffile:メソッドで 簡 単 に 読 み 込 めます 標 準 文 字 集 合 とUnicode 規 格 における 定 義 標 準 文 字 集 合 (lettercharactersetの 戻 り 値 として 得 られるものなど)は Unicode 規 格 で Uppercase Letter Combining Mark などが 規 定 (normative)または 参 考 (informative)のカ テゴリとして 正 式 に 定 義 されています 標 準 文 字 集 合 の 正 式 な 定 義 は ほとんどの 場 合 規 格 に 定 義 されたカテゴリに 基 づきます たとえばlowercaseLetterCharacterSetの 戻 り 値 である 文 字 集 合 に は 規 定 カテゴリである Lowercase Letters の 文 字 がすべて 含 まれます 同 様 に lettercharactersetの 戻 り 値 である 文 字 集 合 は Letter カテゴリの 文 字 から 成 ります なお カテゴリ 自 身 の 定 義 は Unicode 規 格 の 版 によって 変 わることがあります カテゴリを 定 義 し ているファイルは 可 能 です 36

37 字 句 解 析 器 NSScannerオブジェクトはNSStringオブジェクト 中 の 文 字 を 解 析 し 数 値 や 文 字 列 値 として 変 換 し ます 解 析 対 象 の 文 字 列 を 指 定 して 生 成 した 後 先 頭 から 順 次 要 件 に 合 致 する 文 字 を 抽 出 変 換 す るようになっています 字 句 解 析 器 を 生 成 する NSScannerはクラスクラスタで その 公 開 クラスはNSScannerです 一 般 にそのインスタンスは ク ラスメソッドであるscannerWithString:またはlocalizedScannerWithString:で 生 成 します い ずれも 指 定 した 文 字 列 を 解 析 するよう 初 期 化 した 字 句 解 析 器 オブジェクトを 返 します その 後 字 句 解 析 器 は 文 字 列 の 先 頭 から 解 析 を 始 めます scan... 系 列 のメソッド(scanInt: scandouble: scanstring:intostring:など)で 字 句 要 素 を 取 り 出 すことになります 複 数 の 字 句 要 素 を 抽 出 す る 場 合 は whileループ 内 に 組 み 込 み 文 字 列 の 末 尾 まで 繰 り 返 すのが 普 通 です(コード 例 を 参 照 ) float afloat; NSScanner *thescanner = [NSScanner scannerwithstring:astring]; while ([thescanner isatend] == NO) { } [thescanner scanfloat:&afloat]; // implementation continues... 解 析 の 際 大 文 字 と 小 文 字 を 区 別 するかどうかは setcasesensitive:メソッドで 設 定 可 能 です デフォルトでは 区 別 しない 設 定 になっています 字 句 解 析 器 の 使 い 方 文 字 列 の 走 査 は 現 在 位 置 から 始 め 要 件 に 合 致 する 表 現 を 見 つけて その 最 後 の 文 字 を 通 り 過 ぎた 位 置 まで 進 めます たとえば 137 small cases of bananas という 文 字 列 から 整 数 値 を 抽 出 すると 現 在 位 置 は3 すなわち 数 字 直 後 の 空 白 になります 解 析 対 象 外 の 文 字 を 飛 ばすため 単 に 位 置 を 進 めたいこともよくあります その 場 合 setscanlocation:メソッドで 所 定 の 位 置 まで 37

38 字 句 解 析 器 字 句 解 析 器 の 使 い 方 進 める という 方 法 があります(このメソッドは エラー 時 に 戻 って 走 査 し 直 すためにも 使 えます) しかし 通 常 は ある 文 字 集 合 に 属 する 文 字 や 指 定 した 文 字 列 を 読 み 飛 ばしたり 指 定 した 文 字 列 が 現 れるまで 位 置 を 進 めたりしたいことが 多 いでしょう ある 文 字 集 合 に 属 する 文 字 を 読 み 飛 ばしたい 場 合 は setcharacterstobeskipped:メソッドを 使 い ます 処 理 に 先 立 って 該 当 する 文 字 を 読 み 飛 ばし それ 以 外 の 文 字 が 見 つかった 後 はすべて 照 合 の 対 象 にします デフォルトでは 空 白 と 改 行 文 字 を 読 み 飛 ばすようになっています なお この 指 定 で は 常 に 大 文 字 と 小 文 字 を 区 別 することに 注 意 してください たとえば 英 語 の 母 音 文 字 を 読 み 飛 ばした い 場 合 AEIOUaeiou という 形 で 指 定 しなければなりません 現 在 位 置 以 降 指 定 した 文 字 列 の 手 前 までを 抽 出 したい 場 合 は scanuptostring:intostring:メ ソッドを 使 います( 第 2 引 数 としてNULLを 指 定 すれば 指 定 した 文 字 列 まで 単 に 読 み 飛 ばすことにな ります) たとえば 次 の 文 字 列 を 考 えましょう 137 small cases of bananas scanuptostring:intostring:を 次 のように 使 えば 容 器 の 個 数 (137)と 種 類 (small cases)を 取 り 出 すことができます NSString *bananas small cases of bananas"; NSString *separatorstring of"; NSScanner *ascanner = [NSScanner scannerwithstring:bananas]; NSInteger aninteger; [ascanner scaninteger:&aninteger]; NSString *container; [ascanner scanuptostring:separatorstring intostring:&container]; ここで 重 要 なのは 検 索 文 字 列 (separatorstring)が" of"であることです デフォルトでは 字 句 解 析 器 は 空 白 類 を 無 視 するので 数 字 の 直 後 にある 空 白 は 読 み 飛 ばされます しかし 指 定 した 文 字 列 の 手 前 までを 抽 出 する 場 合 そこまでの 文 字 はすべて 出 力 文 字 列 に 入 ります したがって 検 索 文 字 列 が"of"( 先 頭 に 空 白 なし)であったとすれば containerの 最 初 の 値 は small cases ( 末 尾 の 空 白 を 含 む)となります これに 対 し " of"( 先 頭 に 空 白 あり)であったとすれば 結 果 は small cases ( 末 尾 に 空 白 なし)containerとなります 指 定 した 文 字 列 の 手 前 までを 抽 出 した(あるいは 読 み 飛 ばした) 時 点 で 現 在 位 置 は 見 つかっ た 文 字 列 の 先 頭 になります したがって 見 つかった 文 字 列 の 直 後 から 続 行 したい 場 合 は この 文 字 列 を 読 み 飛 ばさなければなりません 次 のコード 例 では 検 索 文 字 列 ( of)までを 読 み 飛 ばした 後 38

39 字 句 解 析 器 例 その 直 後 から 末 尾 までを 抽 出 して 容 器 に 入 っている 商 品 (bananas)を 調 べています substringfromindex:を 使 って 実 質 的 に 検 索 文 字 列 の 末 尾 まで 読 み 飛 ばしていることに 注 意 し てください [ascanner scanstring:separatorstring intostring:null]; NSString *product; product = [[ascanner string] substringfromindex:[ascanner scanlocation]]; // could also use: // product = [bananas substringfromindex:[ascanner scanlocation]]; 例 次 の 行 から 成 る 文 字 列 を 考 えましょう Product: Acme Potato Peeler; Cost: Product: Chef Pierre Pasta Fork; Cost: Product: Chef Pierre Colander; Cost: 次 の 例 では 各 種 の 走 査 演 算 を 使 って 製 品 名 と 金 額 ( 簡 単 のためfloat 型 として 読 み 取 り)を 抽 出 します 部 分 文 字 列 Product: や Cost: およびセミコロンは 読 み 飛 ばします 字 句 解 析 器 は デフォルトでは 空 白 や 改 行 を 読 み 飛 ばすようになっているので ループ 内 で 特 別 な 処 理 をする 必 要 は ありません( 特 に 行 末 の 整 数 値 を 取 り 出 す 際 空 白 を 読 み 飛 ばす 処 理 は 不 要 です) NSString *string Acme Potato Peeler; Cost: \n\ Product: Chef Pierre Pasta Fork; Cost: \n\ Product: Chef Pierre Colander; Cost: \n"; NSCharacterSet *semicolonset; NSScanner *thescanner; NSString *PRODUCT NSString *COST NSString *productname; float productcost; NSInteger productsold; 39

40 字 句 解 析 器 ローカライズ semicolonset = [NSCharacterSet charactersetwithcharactersinstring:@";"]; thescanner = [NSScanner scannerwithstring:string]; while ([thescanner isatend] == NO) { if ([thescanner scanstring:product intostring:null] && [thescanner scanuptocharactersfromset:semicolonset intostring:&productname] && [thescanner scanstring:@";" intostring:null] && [thescanner scanstring:cost intostring:null] && [thescanner scanfloat:&productcost] && [thescanner scaninteger:&productsold]) { NSLog(@"Sales of %@: $%1.2f", productname, productcost * productsold); } } ローカライズ 字 句 解 析 器 の 動 作 はロケール( 言 語 値 を 表 現 する 際 の 慣 習 など)にも 依 存 します もっとも NSScannerが 使 うロケール 設 定 は 10 進 数 値 の 区 切 り 文 字 (NSDecimalSeparatorキーで 指 定 )だけ です ロケールを 指 定 した 字 句 解 析 器 はlocalizedScannerWithString:で 生 成 できるほか setlocale:で 明 示 的 に 指 定 することも 可 能 です ロケールを 指 定 しなければ デフォルトのロケー ル 値 を 仮 定 して 動 作 するようになっています 40

41 ファイルパスの 文 字 列 表 現 NSStringには 文 字 列 をファイルシステム 上 のパスとして 扱 うメソッドが 豊 富 に 揃 っています パ スからディレクトリやファイル 名 拡 張 子 を 抽 出 する ティルダ 表 記 ( ~me など)を 展 開 する ホームディレクトリを 表 すパスを 生 成 する シンボリックリンクや 冗 長 なスラッシュ. (カレン トディレクトリ)や.. ( 親 ディレクトリ)の 参 照 を 除 去 する などの 処 理 が 可 能 です 注 意 : パスの 表 現 にはできるだけNSURLのインスタンスを 使 ってください オペレーティン グシステムは パスの 文 字 列 表 現 よりもURLの 方 が 効 率 よく 扱 えるようになっています パスの 表 現 NSStringでパスを 表 す 場 合 一 般 に パス 区 切 り 文 字 を / 拡 張 子 の 区 切 り 文 字 として. を 使 います パスを 表 す 引 数 として 文 字 列 を 受 け 付 けるメソッドは 必 要 ならばこの 表 現 を システム 固 有 の 形 式 に 変 換 します 暗 黙 のルートディレクトリがあるシステムの 場 合 絶 対 パスの 先 頭 は パス 区 切 り 文 字 またはティルダ 表 現 ( ~/... ~user/... など)になります デバイスの 指 定 を 要 するシステムの 場 合 明 示 的 に 指 定 すればシステムへの 依 存 性 が 生 じますが 文 字 列 オブジェクト に 任 せて デフォルトのデバイスを 追 加 させることも 可 能 です パスの 標 準 表 現 は stringbystandardizingpathで 生 成 できます これは 次 のような 数 々の 処 理 を 行 います 先 頭 のティルダ 表 現 を 展 開 する 空 の 要 素 カレントディレクトリの 参 照 ( // /./ )を 除 去 して 単 一 のパス 区 切 り 文 字 に 置 き 換 える 絶 対 パスの 場 合 親 ディレクトリの 参 照 (.. )を 実 際 の 親 ディレクトリに 置 き 換 える たとえば 次 のように 使 います NSString *path NSString *standardizedpath = [path stringbystandardizingpath]; // standardizedpath: /usr/bin/grep 41

42 ファイルパスの 文 字 列 表 現 ユーザディレクトリ path standardizedpath = [path stringbystandardizingpath]; // standardizedpath (assuming conventional naming scheme): /Users/Me path standardizedpath = [path stringbystandardizingpath]; // standardizedpath: /usr/include path standardizedpath = [path stringbystandardizingpath]; // standardizedpath: /usr/include ユーザディレクトリ NSStringのパスユーティリティや 他 のCocoa 関 数 を 使 って ユーザディレクトリを 取 得 する 例 を 示 し ます // Assuming that users home directories are stored in /Users NSString *mehome = [@"~me" stringbyexpandingtildeinpath]; // mehome NSString *mepublic = [@"~me/public" stringbyexpandingtildeinpath]; // mepublic カレントユーザや 指 定 したユーザのホームディレクトリはそれぞれ NSHomeDirectoryや NSHomeDirectoryForUserで 取 得 できます NSString *currentuserhomedirectory = NSHomeDirectory(); NSString *mehomedirectory = NSHomeDirectoryForUser(@"me"); なお カレントユーザの 標 準 ディレクトリは NSSearchPathForDirectoriesInDomains 関 数 で 取 得 してください たとえば 42

43 ファイルパスの 文 字 列 表 現 パスの 構 成 要 素 NSString *documentsdirectory = [NSHomeDirectory() stringbyappendingpathcomponent:@"documents"]; という 記 述 ではなく 次 のように 記 述 します NSString *documentsdirectory; NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES); if ([paths count] > 0) { } documentsdirectory = [paths objectatindex:0]; パスの 構 成 要 素 NSStringには 文 字 列 をファイルシステム 上 のパスとして 扱 うメソッドが 豊 富 に 揃 っています pathextension stringbydeletingpathextension stringbydeletinglastpathcomponent <Offline> <Offline> <Offline> この 系 統 のメソッド( NSStringClassReference を 参 照 )を 使 って 次 のように パスからディレク トリ ファイル 名 拡 張 子 を 取 得 できます NSString *documentpath NSString *documentdirectory = [documentpath stringbydeletinglastpathcomponent]; // documentdirectory NSString *documentfilename = [documentpath lastpathcomponent]; // documentfilename NSString *documentextension = [documentpath pathextension]; // documentextension 43

44 ファイルパスの 文 字 列 表 現 ファイル 名 の 補 完 ファイル 名 の 補 完 ファイル 名 の 一 部 を 与 え completepathintostring:casesensitive:matchesintoarray:filtertypes:メソッドで 補 完 する ことができます たとえば ディレクトリ~/Demo 以 下 に 次 のファイルがあるとしましょう ReadMe.txt readme.html readme.rtf recondite.txt test.txt このとき ~/Demo/r というパスは 次 のようにして 補 完 できます NSString *partialpath NSString *longestcompletion; NSArray *outputarray; unsigned allmatches = [partialpath completepathintostring:&longestcompletion casesensitive:no matchesintoarray:&outputarray filtertypes:null]; // allmatches = 3 // longestcompletion // outputarray = (@"~/Demo/readme.html", "~/Demo/readme.rtf", "~/Demo/recondite.txt") また パス ~/Demo/r のうち 拡 張 子 が.txt または.rtf であるものは 次 のようにして 補 完 で きます NSArray unsigned textmatches = [partialpath completepathintostring:&outputname casesensitive:no matchesintoarray:&outputarray filtertypes:filtertypes]; // allmatches = 2 // longestcompletion // outputarray = 44

45 文 字 列 の 描 画 文 字 列 オブジェクトは フォーカスがあるNSViewに drawatpoint:withattributes:などのメソッ ドで 直 接 描 画 できます(フォントを 途 中 で 切 り 替 えるなど 属 性 を 複 数 設 定 した 文 字 列 の 描 画 には NSAttributedStringオブジェクトを 使 用 ) このメソッドについては Cocoa Drawing Guide の Text に 概 要 が 載 っています しかしこの 簡 単 なメソッドは 少 量 のテキストを 描 画 する あるいはごく 稀 に 描 画 することを 想 定 し たものであり 呼 び 出 しのたびに 関 係 するオブジェクトの 生 成 と 破 棄 を 繰 り 返 すことになります 頻 繁 に 描 画 する 場 合 はNSLayoutManagerを 使 う 方 が 効 率 的 です( Drawing Strings を 参 照 ) NSLayoutManagerをはじめとするCocoaのテキスト 処 理 系 については CocoaTextArchitectureGuide を 参 照 してください 45

46 書 類 の 改 訂 履 歴 この 表 は 文 字 列 操 作 プログラミングガイド の 改 訂 履 歴 です 日 付 メモ 単 語 区 切 りの 判 定 に 関 する 説 明 を 追 加 し 章 見 出 しを 単 語 段 落 改 行 に 変 更 しました 文 字 列 オブジェクトの 整 形 の 章 に 現 れるコード 例 の 誤 記 を 修 正 しました NSAnchoredSearchオプションの 説 明 を 分 かりやすくしました Objective-Cの 新 機 能 を 取 り 入 れてコード 例 を 更 新 しました 文 字 列 定 数 の 文 字 集 合 をUTF-8に 訂 正 しました Finderと 同 じ 規 則 で 整 列 する localizedstandardcompare:の 使 い 方 に 関 するガイドを 追 加 しました RTL 言 語 の 場 合 に %s を 避 けるよう 注 記 を 追 加 しま した 文 字 列 の 書 式 指 定 子 の 章 を 改 訂 しました Cocoa Core Competencies へのリンクを 追 加 しました 文 字 クラスタに 関 する 章 を 追 加 し 文 字 列 書 式 指 定 子 のリストを 更 新 しました 細 かな 誤 字 を 訂 正 しました 文 字 列 の 書 式 指 定 子 にNSIntegerおよびNSUIntegerに 関 する 注 記 を 追 加 しました 46

47 書 類 の 改 訂 履 歴 日 付 メモ 細 かな 誤 字 を 訂 正 しました 字 句 解 析 器 の 記 載 を 修 正 し 例 を 改 善 しました 検 索 やパス 操 作 のコード 例 を 追 加 しました 字 句 解 析 器 の 章 に 細 かな 修 正 を 施 しました パス 操 作 メソッドへのリンクを 追 加 しました 誤 字 を 訂 正 しました ファイルやURLに 対 する 文 字 列 の 読 み 書 き の 章 を 追 加 し 文 字 列 オブジェクトの 生 成 と 変 換 を 大 幅 に 改 訂 しました 文 字 集 合 ファイルを 生 成 する を 文 字 集 合 (34 ページ) の 章 に 移 動 しました 文 書 名 を Strings から 変 更 しました ガイドラインに 従 い 一 貫 性 のある 題 名 にするためです Formatting String Objects (13 ページ) の 章 を 追 加 しました 導 入 部 分 に Data Formatting およびCore Foundationの Strings プログラミングトピックスを 追 加 しました 文 字 集 合 に 独 自 のUnicode 文 字 集 合 に 関 する 情 報 を 追 加 し 文 字 集 合 ファイルを 生 成 する に 欠 けていたコード 例 を 修 復 しまし た 文 字 列 の 描 画 (45 ページ) に 必 要 な 情 報 とクロスリファレ ンスを 追 加 しました 導 入 部 分 を 書 き 直 し 索 引 を 追 加 しました 文 字 列 の 検 索 比 較 整 列 (23 ページ) にNSNumericSearch の 記 述 を 追 加 しました 47