_strrev, _wcsrev, _mbsrev, _mbsrev_l

文字列の文字を反転させます。

重要

_mbsrev および _mbsrev_l は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

char *_strrev(
   char *str
);
wchar_t *_wcsrev(
   wchar_t *str
);
unsigned char *_mbsrev(
   unsigned char *str
);
unsigned char *_mbsrev_l(
   unsigned char *str,
   _locale_t locale
);

パラメーター

str
NULL で終わる反転対象の文字列。

locale
使用するロケール。

戻り値

変更された文字列へのポインターを返します。 エラーを示す戻り値は予約されていません。

解説

_strrev 関数は、str の文字の順序を反転させます。 終端の NULL 文字はそのまま保持されます。 _wcsrev 関数と _mbsrev 関数は、_strrev 関数のワイド文字バージョンとマルチバイト文字バージョンです。 引数と戻り値 _wcsrev はワイド文字列です。 引数と戻り値 _mbsrev はマルチバイト文字列です。 の場合 _mbsrev、各マルチバイト文字の str バイト数の順序は変更されません。 それ以外では、これらの関数の動作は同じです。

_mbsrev はそのパラメーターを検証します。 null ポインターのstring2string1場合は、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、_mbsrev は NULL を返し、errno を EINVAL に設定します。 _strrev パラメーター _wcsrev を検証しません。

出力値は、ロケールの LC_CTYPE カテゴリ設定の設定によって影響を受けます。 詳細については、setlocaleを参照してください。 _l サフィックスが付いていないバージョンが現在のロケールを使用し、_l サフィックスが付いているバージョンが渡されたロケール パラメーターを代わりに使用する点を除いて、これらの関数のバージョンは同じです。 詳細については、「 Locale」を参照してください。

重要

これらの関数は、バッファー オーバーランの脅威に対して脆弱な場合があります。 バッファー オーバーランは、認められていない特権の昇格の原因となるため、システムの攻撃に使用される可能性があります。 詳細については、「バッファー オーバーランの回避」を参照してください。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT のグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

TCHAR.H のルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tcsrev	_strrev	_mbsrev	_wcsrev
該当なし	該当なし	_mbsrev_l	該当なし

必要条件

ルーチンによって返される値	必須ヘッダー
_strrev	<string.h>
_wcsrev	<string.h> または <wchar.h>
_mbsrev, _mbsrev_l	<mbstring.h>

互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_strrev.c
// This program checks a string to see
// whether it is a palindrome: that is, whether
// it reads the same forward and backward.
//

#include <string.h>
#include <stdio.h>

int main( void )
{
   char* string = "Able was I ere I saw Elba";
   int result;

   // Reverse string and compare (ignore case):
   result = _stricmp( string, _strrev( _strdup( string ) ) );
   if( result == 0 )
      printf( "The string \"%s\" is a palindrome\n", string );
   else
      printf( "The string \"%s\" is not a palindrome\n", string );
}

The string "Able was I ere I saw Elba" is a palindrome

関連項目

文字列操作
ロケール
マルチバイト文字シーケンスの解釈
strcpy, wcscpy, _mbscpy
_strset, _strset_l, _wcsset, _wcsset_l, _mbsset, _mbsset_l