次の方法で共有

_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 はそのパラメーターを検証します。 string1またはstring2が null ポインターの場合、「パラメーターの検証で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、_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