Поделиться через


<locale>Функции

has_facet
isalnum
isalpha
iscntrl
isdigit
isgraph
islower
isprint
ispunct
isspace
isupper
isxdigit
tolower
toupper
use_facet

has_facet

Тестирует наличие того или иного аспекта в указанном языковом стандарте.

template <class Facet>
bool has_facet(const locale& Loc);

Параметры

Положение
Языковой стандарт, проверяемый на наличие аспекта.

Возвращаемое значение

true Значение ,если языковой стандарт проверен на аспект; false Значение , если это не так.

Замечания

Функция-шаблон позволяет проверить, перечислены ли необязательные аспекты в языковом стандарте перед вызовом use_facet, чтобы избежать исключения, которое может быть создано, если они не существуют.

Пример

// locale_has_facet.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result = has_facet <ctype<char> > ( loc );
   cout << result << endl;
}
1

isalnum

Проверяет, является ли элемент языкового стандарта буквенным или цифровым символом.

template <class CharType>
bool isalnum(CharType Ch, const locale& Loc)

Параметры

Ch
Буквенно-цифровой элемент для проверки.

Положение
Языковой стандарт, содержащий буквенно-цифровой элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является буквенно-цифровым; false Если это не так.

Пример

// locale_isalnum.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isalnum ( 'L', loc);
   bool result2 = isalnum ( '@', loc);
   bool result3 = isalnum ( '3', loc);

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not alphanumeric." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not alphanumeric." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "alphanumeric." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not alphanumeric." << endl;
}
The character 'L' in the locale is alphanumeric.
The character '@' in the locale is  not alphanumeric.
The character '3' in the locale is alphanumeric.

isalpha

Проверяет, является ли элемент языкового стандарта буквенным символом.

template <class CharType>
bool isalpha(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий буквенный элемент для проверки.

Возвращаемое значение

true Значение ,если тестируемый элемент является алфавитным; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: alpha, Ch).

Пример

// locale_isalpha.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isalpha ( 'L', loc);
   bool result2 = isalpha ( '@', loc);
   bool result3 = isalpha ( '3', loc);

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not alphabetic." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not alphabetic." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "alphabetic." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not alphabetic." << endl;
}

iscntrl

Определяет, является ли элемент языкового стандарта управляющим символом.

template <class CharType>
bool iscntrl(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является символом элемента управления; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: cntrl, Ch).

Пример

// locale_iscntrl.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = iscntrl ( 'L', loc );
   bool result2 = iscntrl ( '\n', loc );
   bool result3 = iscntrl ( '\t', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a control character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a control character." << endl;

   if ( result2 )
      cout << "The character-set 'backslash-n' in the locale\n is "
           << "a control character." << endl;
   else
      cout << "The character-set 'backslash-n' in the locale\n is "
           << " not a control character." << endl;

   if ( result3 )
      cout << "The character-set 'backslash-t' in the locale\n is "
           << "a control character." << endl;
   else
      cout << "The character-set 'backslash-n' in the locale \n is "
           << " not a control character." << endl;
}

isdigit

Определяет, является ли элемент языкового стандарта цифровым символом.

template <class CharType>
bool isdigit(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является числовым символом; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: digit, Ch).

Пример

// locale_is_digit.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isdigit ( 'L', loc );
   bool result2 = isdigit ( '@', loc );
   bool result3 = isdigit ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a numeric character." << endl;

   if ( result2 )
      cout << "The character '@' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character '@' in the locale is "
           << " not a numeric character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a numeric character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a numeric character." << endl;
}

isgraph

Проверяет, является ли элемент языкового стандарта буквенно-цифровым символом или символом пунктуации.

template <class CharType>
bool isgraph(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является буквенно-цифровым или знаком препинания; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: graph, Ch).

Пример

// locale_is_graph.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isgraph ( 'L', loc );
   bool result2 = isgraph ( '\t', loc );
   bool result3 = isgraph ( '.', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character 'L' in the locale is\n "
           << " not an alphanumeric or punctuation character." << endl;

   if ( result2 )
      cout << "The character 'backslash-t' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character 'backslash-t' in the locale is\n "
           << "not an alphanumeric or punctuation character." << endl;

   if ( result3 )
      cout << "The character '.' in the locale is\n "
           << "an alphanumeric or punctuation character." << endl;
   else
      cout << "The character '.' in the locale is\n "
           << " not an alphanumeric or punctuation character." << endl;
}

islower

Определяет, является ли элемент языкового стандарта символом в нижнем регистре.

template <class CharType>
bool islower(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является строчным символом; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: lower, Ch).

Пример

// locale_islower.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = islower ( 'L', loc );
   bool result2 = islower ( 'n', loc );
   bool result3 = islower ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a lowercase character." << endl;

   if ( result2 )
      cout << "The character 'n' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character 'n' in the locale is "
           << " not a lowercase character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a lowercase character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a lowercase character." << endl;
}

isprint

Определяет, является ли элемент языкового стандарта символом, пригодным для печати.

template <class CharType>
bool isprint(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является печатным; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: print, Ch).

Пример

// locale_isprint.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc ( "German_Germany" );

   bool result1 = isprint ( 'L', loc );
   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a printable character." << endl;

   bool result2 = isprint( '\t', loc );
   if ( result2 )
      cout << "The character 'backslash-t' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'backslash-t' in the locale is "
           << " not a printable character." << endl;

   bool result3 = isprint( '\n', loc );
   if ( result3 )
      cout << "The character 'backslash-n' in the locale is "
           << "a printable character." << endl;
   else
      cout << "The character 'backslash-n' in the locale is "
           << " not a printable character." << endl;
}

ispunct

Определяет, является ли элемент языкового стандарта символом пунктуации.

template <class CharType>
bool ispunct(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является символом препинания; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: punct, Ch).

Пример

// locale_ispunct.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = ispunct ( 'L', loc );
   bool result2 = ispunct ( ';', loc );
   bool result3 = ispunct ( '*', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a punctuation character." << endl;

   if ( result2 )
      cout << "The character ';' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character ';' in the locale is "
           << " not a punctuation character." << endl;

   if ( result3 )
      cout << "The character '*' in the locale is "
           << "a punctuation character." << endl;
   else
      cout << "The character '*' in the locale is "
           << " not a punctuation character." << endl;
}

isspace

Определяет, является ли элемент языкового стандарта символом пустого пространства.

template <class CharType>
bool isspace(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является символом пробела; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: space, Ch).

Пример

// locale_isspace.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isspace ( 'L', loc );
   bool result2 = isspace ( '\n', loc );
   bool result3 = isspace ( ' ', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a whitespace character." << endl;

   if ( result2 )
      cout << "The character 'backslash-n' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character 'backslash-n' in the locale is "
           << " not a whitespace character." << endl;

   if ( result3 )
      cout << "The character ' ' in the locale is "
           << "a whitespace character." << endl;
   else
      cout << "The character ' ' in the locale is "
           << " not a whitespace character." << endl;
}

isupper

Определяет, является ли элемент языкового стандарта символом в верхнем регистре.

template <class CharType>
bool isupper(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является символом верхнего регистра; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: upper, Ch).

Пример

// locale_isupper.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isupper ( 'L', loc );
   bool result2 = isupper ( 'n', loc );
   bool result3 = isupper ( '3', loc );

   if ( result1 )
      cout << "The character 'L' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'L' in the locale is "
           << " not a uppercase character." << endl;

   if ( result2 )
      cout << "The character 'n' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character 'n' in the locale is "
           << " not a uppercase character." << endl;

   if ( result3 )
      cout << "The character '3' in the locale is "
           << "a uppercase character." << endl;
   else
      cout << "The character '3' in the locale is "
           << " not a uppercase character." << endl;
}

isxdigit

Определяет, является ли элемент языкового стандарта символом, используемым для представления шестнадцатеричных чисел.

template <class CharType>
bool isxdigit(CharType Ch, const locale& Loc)

Параметры

Ch
Проверяемый элемент.

Положение
Языковой стандарт, содержащий элемент для проверки.

Возвращаемое значение

true Значение , если тестируемый элемент является символом, используемым для представления шестнадцатеричного числа; false Если это не так.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc is( ctype<CharType>:: xdigit, Ch).

В шестнадцатеричной системе для представления чисел используется база 16. С помощью цифр от 0 до 9, а также букв от A до F без учета регистра представляются десятичные числа от 0 до 15.

Пример

// locale_isxdigit.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>

using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   bool result1 = isxdigit ( '5', loc );
   bool result2 = isxdigit ( 'd', loc );
   bool result3 = isxdigit ( 'q', loc );

   if ( result1 )
      cout << "The character '5' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character '5' in the locale is "
           << " not a hexidecimal digit-character." << endl;

   if ( result2 )
      cout << "The character 'd' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character 'd' in the locale is "
           << " not a hexidecimal digit-character." << endl;

   if ( result3 )
      cout << "The character 'q' in the locale is "
           << "a hexidecimal digit-character." << endl;
   else
      cout << "The character 'q' in the locale is "
           << " not a hexidecimal digit-character." << endl;
}

tolower

Преобразует символ в нижний регистр.

template <class CharType>
CharType tolower(CharType Ch, const locale& Loc)

Параметры

Ch
Символ для преобразования в нижний регистр.

Положение
Языковой стандарт, содержащий символ для преобразования.

Возвращаемое значение

Символ, преобразованный в нижний регистр.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc tolower(Ch).

Пример

// locale_tolower.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   char result1 = tolower ( 'H', loc );
   cout << "The lower case of 'H' in the locale is: "
        << result1 << "." << endl;
   char result2 = tolower ( 'h', loc );
   cout << "The lower case of 'h' in the locale is: "
        << result2 << "." << endl;
   char result3 = tolower ( '$', loc );
   cout << "The lower case of '$' in the locale is: "
        << result3 << "." << endl;
}

toupper

Преобразует символ в верхний регистр.

template <class CharType>
CharType toupper(CharType Ch, const locale& Loc)

Параметры

Ch
Символ для преобразования в верхний регистр.

Положение
Языковой стандарт, содержащий символ для преобразования.

Возвращаемое значение

Символ, преобразованный в верхний регистр.

Замечания

Функция шаблона возвращает use_facet<ctype<CharType>>( ). Loc toupper(Ch).

Пример

// locale_toupper.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc ( "German_Germany" );
   char result1 = toupper ( 'h', loc );
   cout << "The upper case of 'h' in the locale is: "
        << result1 << "." << endl;
   char result2 = toupper ( 'H', loc );
   cout << "The upper case of 'H' in the locale is: "
        << result2 << "." << endl;
   char result3 = toupper ( '$', loc );
   cout << "The upper case of '$' in the locale is: "
        << result3 << "." << endl;
}

use_facet

Возвращает ссылку на аспект указанного типа, сохраненный в языковом стандарте.

template <class Facet>
const Facet& use_facet(const locale& Loc);

Параметры

Положение
Языковой стандарт const, содержащий тип аспекта, на который приведена ссылка.

Возвращаемое значение

Ссылка на аспект класса Facet внутри аргумента — языкового стандарта.

Замечания

Ссылка на аспект, возвращаемая функцией-шаблоном, остается действительной, пока существует любая копия содержащего этот аспект языкового стандарта. Если в аргументе — языковом стандарте не перечислен такой объект — аспект класса Facet, функция создает исключение bad_cast.

Пример

// locale_use_facet.cpp
// compile with: /EHsc
#include <locale>
#include <iostream>
using namespace std;

int main( )
{
   locale loc1 ( "German_Germany" ), loc2 ( "English_Australia" );
   bool result1 = use_facet<ctype<char> > ( loc1 ).is(
   ctype_base::alpha, 'a'
);
   bool result2 = use_facet<ctype<char> > ( loc2 ).is( ctype_base::alpha, '!'
   );

   if ( result1 )
      cout << "The character 'a' in locale loc1 is alphabetic."
           << endl;
   else
      cout << "The character 'a' in locale loc1 is not alphabetic."
           << endl;

   if ( result2 )
      cout << "The character '!' in locale loc2 is alphabetic."
           << endl;
   else
      cout << "The character '!' in locale loc2 is not alphabetic."
           << endl;
}
The character 'a' in locale loc1 is alphabetic.
The character '!' in locale loc2 is not alphabetic.

См. также

<локаль>