<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.