はじめに

このヘルプについて

 文字列操作関数をダウンロードしていただき、有り難うございます。
 このヘルプは、W3C HTML4.0で記述されていますので、これに対応したブラウザでご覧下さい。配色及びレイアウトにはCSSを利用しているので、CSS対応のブラウザでご覧になると表示がきれいになります。文字コードはシフトJISです。表示確認は Windows98 + NetscapeNavigator4.05 及び eOS R4 Intel + NetPositive で行っております。
 説明しなくても分かるような事柄は記述しないことがあります。あらかじめご了承下さい。

概要

 文字列を処理する関数を集めたものです。

インストールとアンインストール

アーカイブの内容

 アーカイブには、以下のファイルが含まれています。


SHIString.cpp  …… ソースファイル
SHIString.h    …… ヘッダーファイル
SHIString.htm  …… ヘルプファイル本体
iSHIString.htm ……       〃      目次
_SHIString.htm ……       〃      内容
SHIHelp.css    ……       〃      スタイルシート
*.txt          …… テキスト文書

インストール

 ソースファイルとヘッダーファイルを、インクルードパスの通ったフォルダまたはそのサブフォルダにコピーします。

アンインストール

 コピーしたファイルを全て削除します。

使い方

1.SHIString.cpp をプロジェクトに追加します。
2.関数を利用するソースファイルまたはそのヘッダーファイルで、SHIString.h をインクルードします。

TSHIString リファレンス

instr()

unsigned int instr(const char *szSrc,const char *szTgt,int iBegin = 1)

 文字列の中から部分文字列を探し出し、最初に見つかった位置を返します。
 szSrc は全体の文字列です。この中から部分文字列を探します。
 szTgt は探すべき部分文字列です。
 iBegin は、szSrc の何文字目から検索を始めるかを指定します。szSrc の先頭から検索し始める時は 1、2文字目から検索し始めるときは 2 ……を指定します。
 返り値は、見つかった部分文字列の位置です。位置は 1 からです。部分文字列が見つからない場合は 0 を返します。

 使用例:

instr("12345678901234567890","567");	// 5 が返る
instr("12345678901234567890","567",12);	// 15 が返る

mid()

int mid(char *szDest,const char *szSrc,int iBegin,int iMaxLen = 0);

 文字列の中から部分文字列を抜き出します。
 szDest は抜き出した文字列を格納する配列へのポインタです。szDest は、抜き出した文字列を格納するのに充分な大きさを持っていなければなりません。
 szSrc は元の文字列です。
 iBegin は開始位置です。iBegin 文字目の文字から抜き出しを開始します。開始位置は 1 から始まります。
 iMaxLen は抜き出す文字列の長さ[バイト]です。0 を指定すると、文字列を最後まで抜き出します。
 返り値は、実際に抜き出した文字列の長さ[バイト]です。

 使用例:

mid(szDest,"BeOS is wonderful.",6,2);	// szDest に "is" が入る
mid(szDest,"No Smoking!",4,1000);	// szDest に "Smoking!" が入る

trim()

int trim(char *szDest,const char *szSrc);

 文字列の最初と最後の空白を取り除きます。
 szDest は、空白を取り除いた後の文字列を格納する配列へのポインタです。szDest は、空白を取り除いた文字列を格納するのに充分な大きさを持っていなければなりません。
 szSrc は、空白を取り除きたい文字列へのポインタです。空白を取り除いても、szSrc 自身は変化しません。
 返り値は、空白を取り除いた後の文字列の長さです。

 使用例:

trim(szDest,"   space   world   ");	// szDest に "space   world" が入る

trimleft()

 文字列の最初の空白を取り除きます。
 使い方などは trim() と同じです。

trimright()

 文字列の最後の空白を取り除きます。
 使い方などは trim() と同じです。

困った時は

問題解決の手順

1.ヘルプをよく読みます。特に、Q&Aトラブルシューティングの所は念入りに読みます。そして、ヘルプに書かれていることを元にして問題を解決します。
2.SHINTAのホームページ『翔星ワールド』内の「サポートセンター」を訪れ、そこの情報を元にして問題を解決します。
3.翔星ワールド』内の「ソフトスタンド」から文字列操作関数の最新版をダウンロードし、最新版を使ってみます。
4.もしそれでも解決しなかったら、最終手段として、連絡先にメールを出します。その際は、文字列操作関数のバージョンと、問題の発生状況などを詳しく分かりやすく書いて下さい。そして、サポートセンターの情報の更新や、文字列操作関数のバージョンアップを待ちます。但し、連絡先などの所にも書いてあるとおり、回答には時間がかかることがあります。

Q&A

 現在の所、Q&Aに登録されている質問はありません。

トラブルシューティング

 現在の所、トラブルシューティングに登録されている事例はありません。

その他

著作権など

 このソフトウェア(文字列操作関数)はオープンウェアです。
 このソフトウェア(付属物を含む、以降同)の著作権は、第3者に提供された部分を除き、作者である私SHINTAに帰属します。これらは著作権法上の保護を受けています。
 私はバージョンアップ、サポート、バグ修正の義務を負わないこととします。
 このソフトウェアを使用したことによる結果及びその影響について、私はいかなる責任も負いません。全て各自の責任で使用して下さい。
 このソフトウェアは自由に改変して構いませんが、オリジナルの著作権表示は残して下さい。
 このソフトウェアの一部または全部を、SHINTAから承諾を得ずに販売等することを禁じます。
 その他、明記されていないことについてはSHINTAの意向が優先されます。
 このソフトウェアは以下のことを守って頂ければ自由に転載・配布して構いません。

・オリジナルを再配布する場合は、アーカイブの内容を変えないで下さい。解凍〜再圧縮したものも不可とします。改変した物の場合は、改変したことを明記して下さい。
・金銭その他の物品の授受を行わないで下さい。但し、ディスク代等の実費またはそれに相当する物品はこの限りではありません。
・非商用利用の場合は、事後で構いませんので私にご一報下さい。
・商用利用の場合は、商用利用についてに従って下さい。
・バージョンアップ等があった場合、転載者はなるべく最新版の再配布を行って下さい。

商用利用について

 このソフトウェアを商用で利用する時は、著作権などに記述されていることの他に、以下のことを守って下さい。
・商用BBSでの配布は、非商用利用と同等の扱いをします。
・雑誌や書籍、CD-ROM等に掲載・添付する場合は、掲載誌をお送り下さい。その場合、許可は不要です。その他に何か気持ち程度のもの(図書券でも菓子折りでも構いません)を頂けると幸いです。それ以外の場合は事前に私に許可を求めて下さい。なお、原稿が必要な場合はその旨を伝えて下さい。
・店頭デモは自由に行って構いません。許可は不要です。但し、このソフトウェアを添付しての販売は禁止します。
・その他の場合は、別途条件を考えますので事前に私にお問い合わせ下さい。

データベース

種 類 別オープンウェア
名  称ライブラリ
品  名文字列操作関数
バージョンVer 1.2
動作環境BeOS R4 for Intel
作  者SHINTA
作者Eメールk-shinta@mvb.biglobe.ne.jp
作者ホームページhttp://www.geocities.com/SiliconValley/Station/8180/Trans.htm (自動転送ページ)
http://www2u.biglobe.ne.jp/~shinta/ (メインページ)

動作確認環境

 文字列操作関数の動作確認は、以下の環境で行っております。

パソコン本体GP6-400 (Gateway)
C P UIntel PentiumII 400MHz
メ モ リ128MB
H D D10GB
CD-ROM最大32倍速
O  SBeOS R4 for Intel

改訂履歴

 SHIString.cpp に書いてあります。

連絡先など

 このソフトウェアに関する情報や、このソフトウェアの最新版はSHINTAのホームページ『翔星ワールド』にあります。是非ご利用下さい。
 ご意見、ご感想(このソフトウェアの良い点や悪い点等)、ご要望、ご質問、アドバイス、バグレポート等がございましたら、メールを下さい。その際は、このソフトウェア及びOSの名前とバージョンを書いて下さるようお願いします。また、サポートできるのは最新版のみです(旧バージョンは最新版のコンパイル時に消えて無くなってしまうので)。但し旧バージョンでも、SHINTAの記憶に残っている部分や最新版と仕様が同じ部分についてはこの限りではありません。
 メールアドレスはk-shinta@mvb.biglobe.ne.jpです。いただいたご意見等は、なるべく今後の参考にしていきます。質問をいただいた場合には、次のいずれかの対応をしたいと考えています。

 ・翔星ワールド内のサポートセンターで回答を公開
 ・バージョンアップの時にヘルプ上で回答
 ・直接メールで回答

 メールがたくさん届いてしまった時などは、回答までに時間がかかるかもしれませんがご了承下さい。
 なお、メールを送る時は以下のことをお願いします。

・text/plain形式でお願いします。HTML形式等では読めません。
・いきなりバイナリを送るのはご遠慮下さい。前もってSHINTAに打診して下さるようお願いします。
・返信アドレスは正確にお願いします。返信できない時は困ってしまいます。