KCOUNTC 関数

文字列に含まれる個々の文字を数えます。

カテゴリ:	CAS
カテゴリ:	文字操作
制限事項:	この関数はI18Nレベル2ステータスがアサインされており、SBCS、DBCSおよびMBCS(UTF8)で使用するために設計されています。

構文

KCOUNTC(string,character-list,<modifier(s)>);

必須引数

string

文字定数、変数または式を指定します。この中にある文字を数えます。

ヒント文字のリテラル文字列を引用符で囲みます。

character-list

文字リストを初期化する文字定数、変数または式を指定します。KCOUNTC関数では、modifier引数にV修飾子を指定しない場合、このリストの文字が数えられます。V修飾子を指定すると、このリストにないすべての文字が数えられます。他の修飾子を使うことでリストに文字をさらに追加できます。

ヒント文字のリテラル文字列を引用符で囲みます。

修飾子の処理後にリストに文字がない場合、KCOUNTC関数は0を返します。

オプション引数

modifer(s)

文字定数、変数または式を指定します。ここでは、空白以外の文字のそれぞれによってKCOUNTC関数のアクションが変更されます。空白は無視されます。次の文字を大文字または小文字で修飾子として使用できます。

空白	無視されます。
aまたはA	文字のリストに英文字が追加されます。
bまたはB	stringが、左から右へではなく、右から左へスキャンされます。
cまたはC	文字のリストにコントロール文字が追加されます。
dまたはD	文字のリストに数字が追加されます。
fまたはF	文字のリストにアンダースコアと英文字(VALIDVARNAME=V7を使用したSAS変数名内の有効な最初の文字)を追加します。
gまたはG	文字のリストにグラフィック文字が追加されます。グラフィカル文字は、紙面に印刷するとイメージになる文字です。
hまたはH	文字のリストに水平タブが追加されます。
iまたはI	大文字と小文字を区別しません。
lまたはL	文字のリストに小文字が追加されます。
nまたはN	数字、アンダースコアおよび英文字(すなわち、VALIDVARNAME=V7を使用するSAS変数名に記述できる文字)が文字のリストに追加されます。
oまたはO	KCOUNTC関数のこのインスタンスへの最初の呼び出しで、character-listおよびmodifier引数が1回だけ処理されます。後続の呼び出しでcharacter-listまたはmodifierの値を変更すると、KCOUNTC関数によって変更が無視されることがあります。
pまたはP	文字のリストに句読点が追加されます。
sまたはS	文字のリストに空白文字が追加されます(空白、水平タブ、垂直タブ、キャリッジリターン、ラインフィード、フォームフィード)。
tまたはT	string引数とcharacter-list引数から末尾の空白を取り除きます。両方の文字引数ではなく一方のみから末尾の空白を削除する場合は、KCOUNTCルーチンでT修飾子を使用するかわりに、TRIM関数を使用します。
uまたはU	文字のリストに大文字が追加されます。
vまたはV	文字のリストに出現しない文字を数えます。この修飾子を指定しない場合、KCOUNTC関数は文字のリストに出現する文字を数えます。
wまたはW	文字のリストに印刷可能(書き込み可能)文字が追加されます。
xまたはX	文字のリストに16進数の文字が追加されます。

ヒントmodifierが定数の場合、引用符で囲みます。一組の引用符で複数の定数を指定します。

詳細

基本

KCOUNTC関数では、文字引数にNULLを指定できます。NULL引数は、長さがゼロの文字列として処理されます。数える対象となる文字リストの文字がない場合、KCOUNTC関数はゼロを返します。

比較

KCOUNTC関数は文字列内の個々の文字を数えますが、KCOUNTX関数は文字列内の文字の部分文字列を数えます。

例

例1

これらの例では、UTF-8エンコーディングを使用します。

次に、サポート代理ペア文字のサポート方法の例を示します。HTML形式で表示されます。この例では絵文字を使用しています:

data _null_;
  text=' abc😊';
  result=kcountc(text,'a😊'); /**/
  put result = ;
run;

data _null_;
  text=' abc😊';
  result=kcountc(text,'a😊'); /*1*/
  put result = ;
run;

KCOUNTCは、aと😊の出現回数をカウントします。

result=2

例2

この例では、漢字を使用します。

data _null_ ;
  text='SAS是全球最大的软件公司之一,是全球商业智能和分析软件与服务领袖。';
  result=kcountc(text,'软件'); /**/
  put result = ;
run;

data _null_ ;
  text='SAS是全球最大的软件公司之一,是全球商业智能和分析软件与服务领袖。';
  result=kcountc(text,'软件'); /*1*/
  put result = ;
run;

KCOUNTCは、「软」と「件」の出現回数をカウントします。

上記のステートメントは、次の結果を生成します。

result=4

最終更新: 2026年4月14日