関数decomposeString マニュアル

(The documentation of function decomposeString)

Last Update: 2021/12/13


◆機能・用途(Purpose)

文字列を指定した区切り文字の前の部分と後の部分に分割する。 区切り文字が複数回登場する場合は最初のものを用いる。
Decompose a string into parts before and after a specified character (separater). If the separater appears twice or more, the first one is used.


◆形式(Format)

#include <mystring.h>
inline void decomposeString
(const char ∗original,const char separater, char ∗before,char ∗after)


◆引数(Arguments)

original 分解する前の文字列。
The string before the decomposition.
separater 区切り文字。
The character by which the string will be decomposed (i.e., the separater).
before 最初の区切り文字よりも前の部分文字列の代入先。 空の文字列を渡す。
A memory into which the partial text before the first separater will be inserted. Give an empty string.
after 最初の区切り文字よりも後の部分文字列の代入先。
A memory into which the partial text after the first separater will be inserted. Give an empty string.


◆使用例(Example)

char string[]="abc-def-ghi";
char string1[strsize];
char string2[strsize];
decomposeString(string,′-′,string1,string2);

この例ではstring1="abc", string2="def-ghi"となる。
This example gives string1="abc" and string2="def-ghi".


◆補足(Additional remarks)

区切り文字が見つからない場合はプログラムがエラー終了する。
If the separater is not found, the program finishes as an error.