strndup

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

技術仕様

組込みプロセッサ向けの拡張

動的メモリ拡張

浮動小数点拡張 パート1: 2進浮動小数点

浮動小数点拡張 パート4: 補足関数

 

動的メモリ拡張

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

ヘッダー <string.h> で定義
char *strndup( const char *str, size_t size );		(動的メモリーTR)

strが指す文字列から、最大sizeバイトをコピーした、ヌル終端のバイト文字列へのポインタを返します。最初のsizeバイト内にヌル終端文字が見つからない場合は、複製された文字列に追加されます。

メモリリークを避けるために、返されたポインタはfreeに渡す必要があります。

エラーが発生した場合、ヌルポインタが返され、errnoが設定される場合があります。

Dynamic Memory TRのすべての関数と同様に、strndupは、実装によって__STDC_ALLOC_LIB__が定義され、ユーザーがstring.hをインクルードする前に__STDC_WANT_LIB_EXT2__を整数定数1として定義した場合にのみ、利用が保証されます。

パラメータ

str	-	複製するヌル終端バイト文字列へのポインタ
size	-	strからコピーする最大バイト数

戻り値

新しく割り当てられた文字列へのポインタ、またはエラーが発生した場合はヌルポインタ。

注記

この関数は、POSIXのstrndupと同一ですが、エラー時にerrnoを設定してもよい（必須ではない）点が異なります。

例

このコードを実行

#ifdef __STDC_ALLOC_LIB__
#define __STDC_WANT_LIB_EXT2__ 1
#else
#define _POSIX_C_SOURCE 200809L
#endif
 
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char *s1 = "String";
    char *s2 = strndup(s1, 2);
    printf("strndup(\"String\", 2) == %s\n", s2);
    free(s2);
}

出力

strndup("String", 2) == St

関連項目

strdup (動的メモリーTR)	文字列のコピーを確保する (関数)
strncpystrncpy_s (C11)	ある文字列から別の文字列に指定された文字数をコピーする (関数)
malloc	メモリを割り当てる (関数)