Справочник по C# Герберт Шилдт ббк 32. 973. 26018 75 Ш57 удк 681 07 Издательский дом "Вильямс" Зав редакцией
 Скачать 5.05 Mb.
|
|
516 Часть II. Библиотека C# Таблица 19.7. Методы, определенные в структуре Decimal Метод Описание public static decimal Add( decimal v1 , decimal v2 ) Возвращает значение v1 + v2 public static int CompareTo( decimal v1 , decimal v2 ) Сравнивает числовые значения параметров v1 и v2 Возвращает нуль, если сравниваемые значения равны. Возвращает отрицательное число, если v1 меньше v2 , и — положительное, если v1 больше v2 public int CompareTo( object v ) Сравнивает числовое значение вызывающего объекта со значением параметра v . Возвращает нуль, если сравниваемые значения равны. Возвращает отрицательное число, если вызывающий объект имеет меньшее значение, и положительное, если вызывающий объект имеет большее значение public static decimal Divide( decimal v1 , decimal v2 ) Возвращает значение v1 / v2 public override bool Equals( object v ) Возвращает значение ИСТИНА, если значение вызывающего объекта равно значению параметра v public static bool Equals( decimal v1 , decimal v2 ) Возвращает значение ИСТИНА, если v1 равно v2 public static decimal Floor( decimal v ) Возвращает наибольшее целое число (представленное в виде значения типа decimal ), которое не больше параметра v . Например, при v , равном 1.02, метод Floor() возвратит 1.0. А при v , равном -1.02, метод Floor() возвратит -2 public static decimal FromOACurrency( long v ) Преобразует значение, предоставленное приложением OLE Automation и переданное в параметре v , в его decimal - эквивалент и возвращает результат public static int[] GetBits( decimal v ) Возвращает двоичное представление значения параметра v и возвращает его в массиве int -элементов. Организация этого массива описана в тексте этого раздела public override int GetHashCode() Возвращает хеш-код для вызывающего объекта public TypeCode GetTypeCode() Возвращает значение перечисления TypeCode для структуры Decimal , т.е. TypeCode.Decimal public static decimal Multiply( decimal v1 , decimal v2 ) Возвращает значение v1 * v2 public static decimal Negate(decimal v ) Возвращает значение -v public static decimal Parse( string str ) Возвращает двоичный эквивалент строкового представления числа, заданного в параметре str . Если содержимое строки не представляет значение типа decimal , генерируется исключение public static decimal Parse( string str , IFormatProvider fmtpvdr ) Возвращает двоичный эквивалент строкового представления числа, заданного в параметре str с использованием форматов данных (присущих конкретному естественному языку, диалекту или территориальному образованию), заданных посредством параметра fmtpvdr Если содержимое строки не представляет значение типа decimal , генерируется исключение Глава 19. Пространство имен System 517 Продолжение табл. 19.7 Метод Описание public static decimal Parse( string str , MumberStyles styles ) Возвращает двоичный эквивалент строкового представления числа, заданного в параметре str , с использованием информации стилевого характера, заданной в параметре styles , Если содержимое строки не представляет значение типа decimal , генерируется исключение public static decimal Parse( string str , NumberStyles styles , IFormatProvider fmtpvdr ) Возвращает двоичный эквивалент строкового представления числа, заданного в параметре str , с использованием информации стилевого характера, заданной в параметре styles , а также форматов данных {присущих конкретному естественному языку, диалекту или территориальному образованию), заданных посредством параметра fmtpvdr . Если содержимое строки не представляет значение типа decimal , генерируется исключение public static decimal Remainder( decimal v1 , decimal v2 ) Возвращает остаток от целочисленного деления v1 / v2 public static decimal Round( decimal v , int decPlaces ) Возвращает значение v , округленное до числа, количество цифр дробной части которого равно значению параметра decPlaces , которое должно находиться в диапазоне 0-28 public static decimal Subtract( decimal v1 , decimal v2 ) Возвращает значение v1 - v2 public static byte ToByte( decimal v ) Возвращает byte -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу byte , генерируется исключение типа OverflowException public static double ToDouble( decimal v ) Возвращает double -эквивалент параметра v . При этом возможна потеря точности, поскольку тип double имеет меньше значащих цифр, чем тип decimal public static short ToInt16( decimal v ) Возвращает short -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу short , генерируется исключение типа OverflowException public static int ToInt32( decimal v ) Возвращает int -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу int , генерируется исключение типа OverflowException public static long ToInt64( decimal v ) Возвращает long -эквивалент параметра v . Дробная часть отбрасывается, Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу long , генерируется исключение типа OverflowException public static long ToOACurrency( decimal v ) Преобразует значение параметра v в эквивалентное значение OLE Automation и возвращает результат public static sbyte ToSByte( decimal v ) Возвращает sbyte -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу sbyte , генерируется исключение типа OverflowException public static float ToSingle( decimal v ) Возвращает float -эквивалент параметра v . При этом возможна потеря точности, поскольку тип float имеет меньше значащих цифр, чем тип decimal 518 Часть II. Библиотека C# Окончание табл. 19.7 Метод Описание public override string ToString() Возвращает строковое представление значения вызывающего объекта public string ToString( string format ) Возвращает строковое представление значения вызывающего объекта в соответствии с требованиями форматирующей строки, переданной в параметре format public string ToString( IFormatProvider fmtpvdr ) Возвращает строковое представление значения вызывающего объекта с использованием форматов данных (присущих конкретному естественному языку, диалекту или территориальному образованию), заданных посредством параметра fmtpvdr public string ToString( string format , IFormatProvider fmtpvdr ) Возвращает строковое представление значения вызывающего объекта с использованием форматов данных (присущих конкретному естественному языку, диалекту или территориальному образованию), заданных посредством параметра fmtpvdr , а также форматирующей строки, переданной в параметре format public static ushort ToUInt16( decimal v ) Возвращает ushort -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу ushort , генерируется исключение типа OverflowException public static uint ToUInt32( decimal v ) Возвращает uint -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу uint , генерируется исключение типа OverflowException public static ulong ToUInt64( decimal v ) Возвращает ulong -эквивалент параметра v . Дробная часть отбрасывается. Если значение параметра v не попадает в диапазон представления чисел, соответствующий типу ulong , генерируется исключение типа OverflowException public static decimal Truncate( decimal v ) Возвращает целую часть числа, заданного параметром v Соответственно, любая дробная часть при этом отбрасывается Таблица 19.8. Поля, поддерживаемые структурой Decimal Поле Описание public static readonly decimal MaxValue Наибольшее значение, которое позволяет хранить тип decimal public static readonly decimal MinusOne Представление числа -1 в формате decimal - значения public static readonly decimal MinValue Наименьшее значение, которое позволяет хранить тип decimal public static readonly decimal One Представление числа 1 в формате decimal - значения public static readonly decimal Zero Представление числа 0 в формате decimal - значения. Структура char Пожалуй, наиболее используемой (можно сказать, структурой “каждодневного применения”) является структура Char . Она предоставляет большое количество методов, которые позволяют обрабатывать символы и определять, к какой категории они относятся. Например, вызвав метод ToUpper() , можно преобразовать строчный символ Глава 19. Пространство имен System 519 в его прописной эквивалент. А с помощью метода IsDigit() можно определить, является ли анализируемый символ цифрой. Методы, определяемые в структуре Char , перечислены в табл. 19.9. В структуре Char также определены следующие поля: public const char MaxValue public const char MinValue Они представляют наибольшее и наименьшее значения, которые может хранить переменная типа char . Структура Char реализует интерфейсы IComparable и IConvertible Таблица 19.9. Методы, определенные в структуре Char Метод Описание public int CompareTo( object v ) Сравнивает символ в вызывающем объекте с символом параметра v , Возвращает нуль, если сравниваемые символы равны. Возвращает отрицательное число, если вызывающий объект имеет меньшее значение, и — положительное, если вызывающий объект имеет большее значение public override bool Equals( object v ) Возвращает значение ИСТИНА, если значение вызывающего объекта равно значению параметра v public override int GetHashCode() Возвращает хеш-код для вызывающего объекта public static double GetHumericValue( char ch ) Возвращает числовое значение параметра ch , если ch - цифра. В противном случае возвращает -1 public static double GetHumericValue( string str , int idx ) Возвращает числовое значение символа str[idx] , если он является цифрой. В противном случае возвращает -1 public TypeCode GetTypeCode() Возвращает значение перечисления TypeCode для структуры Char , т.е. TypeCode.Char public static UnicodeCategory GetUnicodeCategory( char ch ) Возвращает значение перечисления UnicodeCategory для параметра ch UnicodeCategory — это перечисление, определенное в пространстве имен System.Globalization , В котором символы Unicode разделены по категориям public static UnicodeCategory GetUnicodeCategory( string str , int idx ) Возвращает значение перечисления UnicodeCategory для символа str[idx]. UnicodeCategory —это перечисление, определенное в пространстве имен System.Globalization , в котором символы Unicode разделены по категориям public static bool IsControl( char ch ) Возвращает значение ИСТИНА, если параметр ch является управляющим символом. В противном случае возвращает значение ЛОЖЬ public static bool IsControl( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является управляющим символом. В противном случае возвращает значение ЛОЖЬ public static bool IsDigit( char ch ) Возвращает значение ИСТИНА, если параметр ch является цифрой. В противном случае возвращает значение ЛОЖЬ public static bool IsDigit( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является цифрой. В противном случае возвращает значение ЛОЖЬ public static bool IsLetter( char ch ) Возвращает значение ИСТИНА, если параметр ch является буквой алфавита. В противном случае возвращает значение ЛОЖЬ 520 Часть II. Библиотека C# Продолжение табл. 19.9 Метод Описание public static bool IsLetter( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является буквой алфавита. В противном случае возвращает значение ЛОЖЬ public static bool IsLetterOrDigit( char ch ) Возвращает значение ИСТИНА, если параметр ch является буквой алфавита или цифрой. В противном случае возвращает значение ЛОЖЬ public static bool IsLetterOrDigit( string s t r, int idx ) Возвращает значение ИСТИНА, если символ str[idx] является буквой алфавита или цифрой. В противном случае возвращает значение ЛОЖЬ public static bool IsLower( char ch ) Возвращает значение ИСТИНА, если параметр ch является строчной буквой алфавита В противном случае возвращает значение ЛОЖЬ public static bool IsLower( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является строчной буквой алфавита. В противном случае возвращает значение ЛОЖЬ public static bool IsNumber( char ch ) Возвращает значение ИСТИНА, если параметр ch является шестнадцатеричной цифрой (0-9 или A-F). В противном случае возвращает значение ЛОЖЬ public static bool IsNumber( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является шестнадцатеричной цифрой (0-9 или A-F). В противном случае возвращает значение ЛОЖЬ public static bool IsPunctuation( char ch ) Возвращает значение ИСТИНА, если параметр ch является знаком пунктуации. В противном случае возвращает значение ЛОЖЬ public static bool IsPunctuation( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является знаком пунктуации. В противном случае возвращает значение ЛОЖЬ public static bool IsSeparator( char ch ) Возвращает значение ИСТИНА, если параметр ch является разделительным знаком, например пробелом. В противном случае возвращает значение ЛОЖЬ public static bool IsSeparator( string str, int idx) Возвращает значение ИСТИНА, если символ str[idx] является разделительным знаком, например пробелом. В противном случае возвращает значение ЛОЖЬ public static bool IsSurrogate( char ch ) Возвращает значение ИСТИНА, если параметр ch является псевдосимволом Unicode. В противном случае возвращает значение ЛОЖЬ public static bool IsSurrogate( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является псевдосимволом Unicode. В противном случае возвращает значение ЛОЖЬ public static bool IsSymbol( char ch ) возвращает значение ИСТИНА, если параметр ch является символическим знаком, например валютным символом. В противном случае возвращает значение ЛОЖЬ public static bool IsSymbol( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является символическим знаком, например валютным символом. В противном случае возвращает значение ЛОЖЬ public static bool IsUpper( char ch ) Возвращает значение ИСТИНА, если параметр ch является прописной буквой алфавита. В противном случае возвращает значение ЛОЖЬ public static bool IsUpper( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является прописной буквой алфавита. В противном случае возвращает значение ЛОЖЬ Глава 19. Пространство имен System 521 Окончание табл. 19.9 Метод Описание public static bool IsWhiteSpace( char ch ) Возвращает значение ИСТИНА, если параметр ch является пробелом, символом табуляции или пустой строки. В противном случае возвращает значение ЛОЖЬ public static bool IsWhiteSpace( string str , int idx ) Возвращает значение ИСТИНА, если символ str[idx] является пробелом, символом табуляции или пустой строки. В противном случае возвращает значение ЛОЖЬ public static char Parse( string str ) Возвращает char -эквивалент символа в параметре str Если строка str содержит более одного символа, генерируется исключение типа FormatException public static char ToLower( char ch ) Возвращает строчный эквивалент параметра ch , если ch — прописная буква. В противном случае возвращает значение ch неизменным public static char ToLower( char ch , CultureInfo c ) Возвращает строчный эквивалент параметра ch , если ch — прописная буква. В противном случае возвращает значение ch неизменным. Преобразование выполняется в соответствии с заданной в параметре с информацией о представлении данных, соответствующем конкретному естественному языку, диалекту или территориальному образованию. CultureInfo — это класс, определенный в пространстве имен System.Globalization public static char ToUpper( char ch ) Возвращает прописной эквивалент параметра ch , если ch — строчная буква. В противном случае возвращает значение ch неизменным public static char ToUpper( char ch , CultureInfo c ) Возвращает прописной эквивалент параметра ch , если ch — строчная буква. В противном случае возвращает значение ch неизменным. Преобразование выполняется в соответствии с заданной в параметре с информацией о представлении данных, соответствующем конкретному естественному языку, диалекту или территориальному образованию. CultureInfo —это класс, определенный В пространстве имен System.Globalization public override string ToString() Возвращает строковое представление значения вызывающего Char -объекта public static string ToString( char ch ) Возвращает строковое представление значения параметра ch public string ToString( IFormatProvider fmtpvdr) Возвращает строковое представление значения вызывающего Char -объекта с использованием заданной в параметре fmtpvdr информации о представлении данных, соответствующем конкретному естественному языку, диалекту или территориальному образованию Рассмотрим программу, которая демонстрирует использование методов, определенных в структуре Char : // Демонстрация использования нескольких методов, // определенных в структуре Char. using System; class CharDemo { public static void Main() { string str = "Это простой тест. $23"; int i; |