Conversion. Val Метод
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Перегрузки
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Val(Object)
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Параметры
Обязательный. Любое допустимое выражение String , переменная Object или значение Char . Если Expression имеет тип Object , значение должно быть преобразуемым в String . В противном случае возникает ошибка ArgumentException.
Возвращаемое значение
Порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Исключения
InputStr — слишком большое значение.
Object — это выражение типа String , которое нельзя преобразовать в Expression .
Примеры
В следующем примере функция используется Val для возврата чисел, содержащихся в каждой строке. Val останавливает преобразование при первом символе, который не может быть интерпретирован как числовая цифра, числовой модификатор, числовой знак препинания или пробел.
Комментарии
Функция Val перестает считывать строку с первого символа, который не может распознать как часть числа. Символы и символы, которые часто считаются частями числовых значений, такими как знаки доллара и запятые, не распознаются. Однако функция распознает префиксы &O радикса (для восьмерицы) и &H (для шестнадцатеричных). Пробелы, вкладки и символы канала строк удаляются из аргумента.
Следующий вызов возвращает значение 1234123.
Следующий вызов возвращает десятичное значение -1.
Функция Val распознает только точку ( . ) как допустимый десятичный разделитель. Если используются другие десятичные разделители, как и в международных приложениях, используйте CDbl или CInt вместо этого преобразуйте строку в число. Чтобы преобразовать строковое представление числа в определенном языке и региональных параметрах в числовое значение, используйте метод числового типа Parse(String, IFormatProvider) . Например, используйте Double.Parse при преобразовании строки в . Double
Исключение InvalidCastException может быть вызвано в ответ на некоторые нестандартные числовые форматы. Например, следующий код вызывает это исключение.
‘ These examples cause run-time errors.
Конфликт между числом в формате a Double и Integer Long символами типа будет перехватываться компилятором, если конфликт не содержался в строках.
‘ These examples cause compiler errors.
См. также раздел
Применяется к
Val(Char)
Возвращает порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Параметры
Обязательный. Любое допустимое выражение String , переменная Object или значение Char . Если Expression имеет тип Object , значение должно быть преобразуемым в String . В противном случае возникает ошибка ArgumentException.
Возвращаемое значение
Порядковый номер, который содержится в строке в виде числовых значений соответствующего типа.
Исключения
InputStr — слишком большое значение.
Object — это выражение типа String , которое нельзя преобразовать в Expression .
Примеры
В следующем примере функция используется Val для возврата чисел, содержащихся в каждой строке. Val останавливает преобразование при первом символе, который не может быть интерпретирован как числовая цифра, числовой модификатор, числовой знак препинания или пробел.
Комментарии
Функция Val перестает считывать строку с первого символа, который не может распознать как часть числа. Символы и символы, которые часто считаются частями числовых значений, такими как знаки доллара и запятые, не распознаются. Однако функция распознает префиксы &O радикса (для восьмерицы) и &H (для шестнадцатеричных). Пробелы, вкладки и символы канала строк удаляются из аргумента.
Следующий вызов возвращает значение 1615198.
Следующий вызов возвращает десятичное значение -1.
Функция Val распознает только точку ( . ) как допустимый десятичный разделитель. При использовании разных десятичных разделителей, как в международных приложениях, используйте CDbl или CInt вместо этого преобразуйте строку в число. Чтобы преобразовать строковое представление числа в определенном языке и региональных параметрах в числовое значение, используйте метод числового типа Parse(String, IFormatProvider) . Например, используйте Double.Parse при преобразовании строки в . Double
Исключение InvalidCastException может быть вызвано в ответ на некоторые нестандартные числовые форматы. Например, следующий код вызывает это исключение.
Конфликт между числом в формате a Double и Integer Long символами типа перехватывался компилятором, если он не содержался в строке.
Функции <utility>
(C++14) Присваивает объекту новое значение и возвращает его старое значение.
Параметры
val
Объект, который получит значение new_val .
new_val
Объект, значение которого копируется или перемещается в val .
Remarks
В случае со сложными типами exchange не копирует старое значение, если доступен конструктор перемещения, не копирует новое значение, если оно является временным или переносится, и принимает любой тип в качестве нового значения, используя любой доступный оператор назначения с конвертацией. Функция обмена отличается от std::swap того, что левый аргумент не перемещается или не копируется в правый аргумент.
Пример
В следующем примере показано, как использовать exchange . В реальной ситуации exchange наиболее полезен с большими объектами, копирование которых является дорогостоящим:
forward
Условно приводит свой аргумент к ссылке rvalue, если аргумент представляет собой rvalue или ссылку rvalue. Это восстанавливает присущие rvalue характеристики аргумента для функции пересылки для обеспечения точной пересылки.
Параметры
Type
Тип значения, передаваемого в Arg , который может отличаться от типа Arg . Как правило, определяется аргументом шаблона функции пересылки.
Arg
Аргумент для приведения.
Возвращаемое значение
Возвращает ссылку rvalue Arg , если значение, переданное в Arg , изначально было rvalue или ссылкой на rvalue; в противном случае возвращает Arg , не изменяя его тип.
Remarks
Необходимо указать явный аргумент шаблона для вызова forward .
forward не перенаправит его аргумент. Вместо этого путем условного приведения аргумента к ссылке rvalue, как если бы он изначально был rvalue или ссылкой rvalue, forward позволяет компилятору выполнять разрешение перегрузки с использованием сведений об исходном типе пересылаемого аргумента. Очевидный тип аргумента функции пересылки может отличаться от исходного типа, например, если rvalue используется в качестве аргумента функции и привязан к имени параметра; если имя делает его lvalue, причем любое значение на самом деле существует как rvalue, forward восстанавливает значение rvalue-ness аргумента.
Восстановление значения rvalue-ness исходного значения аргумента для разрешения перегрузки называется идеальным переадресациям. Точная пересылка позволяет шаблонной функции принимать аргумент любого ссылочного типа и восстановить его присущие rvalue характеристики, когда это необходимо для правильного разрешения перегрузки. С помощью точной пересылки можно сохранять семантику перемещения для значений rvalue и избегать необходимости предоставления перегрузок функциям, которые отличаются только ссылочным типом их аргументов.
from_chars
Получает элемент из объекта pair по позиции индекса или по типу.
Параметры
Index
0-й индекс выбранного элемента.
T1
Тип первого элемента пары.
T2
Тип второго элемента пары.
pr
Пара для выбора элемента.
Remarks
Каждая функция шаблона возвращает ссылку на элемент аргумента pair .
Для индексированных перегрузок, если значение Index равно 0, функция возвращает pr.first , а если значение Index равно 1, функция возвращает pr.second . Тип RI — это тип возвращаемого элемента.
Для перегрузок, у которых нет Index параметра, возвращаемый элемент выводится аргументом типа. Вызов get<T>(Tuple) приведет к ошибке компилятора, если pr содержит более или менее одного элемента типа T .
Пример
index_sequence
index_sequence_for
make_index_sequence
make_integer_sequence
make_pair
Функция шаблона, которую можно использовать для построения объектов типа pair , где типы компонентов автоматически выбираются на основе типов данных, переданных в качестве параметров.
Параметры
Val1
Значение, которое инициализирует первый элемент pair .
Val2
Значение, которое инициализирует второй элемент pair .
Возвращаемое значение
Объект пары, созданный: pair T <, U >( Val1 , ). Val2
Remarks
make_pair Преобразует объект класса типа reference_wrapper в ссылочные типы и преобразует разлагающиеся массивы и функции в указатели.
В возвращенном объекте pair T определяется следующим образом:
Если тип ввода T имеет значение reference_wrapper<X> , возвращаемый тип T имеет значение X& .
В противном случае возвращаемый тип T имеет значение decay<T>::type . Если decay класс не поддерживается, возвращаемый тип T совпадает с типом T входных данных.
Возвращаемый тип U аналогичным образом определяется по типу ввода U .
Одним из преимуществ make_pair является то, что типы хранимых объектов определяются компилятором автоматически и не должны быть явно указаны. Не используйте явные аргументы шаблона, такие как при использовании make_pair , так как make_pair<int, int>(1, 2) это подробно и добавляет сложные проблемы ссылки rvalue, которые могут привести к сбою компиляции. В данном случае правильный синтаксис — make_pair(1, 2)
Вспомогательная функция make_pair также предоставляет возможность передать два значения в функцию, которой в качестве параметра ввода требуется пара.
Пример
Пример использования вспомогательной функции make_pair для объявления и инициализации пары см. в разделе pair Structure.
Безусловно приводит свой аргумент к ссылке rvalue, тем самым указывая, что его можно переместить, если его тип допускает перемещения.
Параметры
Type
Тип, выведенный из типа аргумента, переданного в Arg , а также правила сворачивания ссылок.
Arg
Аргумент для приведения. Несмотря на то, что тип Arg определен как ссылка rvalue, move также принимает аргументы lvalue, поскольку ссылки lvalue можно привязать к ссылкам rvalue.
Возвращаемое значение
Arg используется в качестве ссылки rvalue вне зависимости от того, является ли его тип ссылочным.
Remarks
Аргумент Type шаблона не предназначен для явного указания, но должен быть выведен из типа передаваемого Arg значения. Тип Type дополнительно адаптируется в соответствии с правилами сворачивания ссылок.
move не перемещает его аргумент. Вместо этого, путем безусловного приведения аргумента (который может являться ссылкой lvalue) к ссылке rvalue он обеспечивает компилятору возможность впоследствии переместить, а не скопировать значение, переданное в Arg , если его тип допускает перемещение. Если его тип не включен, он копируется.
Если значение, переданное в Arg , является ссылкой lvalue, то есть его имя или адрес можно получить, при перемещении оно становится недействительным. Не указывайте на значение, переданное Arg по его имени или адресу после перемещения.
move_if_noexcept
Обмен элементами двух типов или pair объектов Structure .
Параметры
left
Объект типа или типа pair .
right
Объект типа или типа pair .
Remarks
Одним из преимуществ swap является то, что типы хранимых объектов определяются компилятором автоматически и не должны быть явно указаны. Не используйте явные аргументы шаблона, такие как при использовании swap , так как swap<int, int>(1, 2) это подробно и добавляет сложные проблемы ссылки rvalue, которые могут привести к сбою компиляции.
to_chars
Remarks
Преобразует значение в символьную строку путем заполнения диапазона [first, last) , где [first, last) требуется быть допустимым диапазоном.
What do ref, val and out mean on method parameters?
I’m looking for a clear, concise and accurate answer.
Ideally as the actual answer, although links to good explanations welcome.
This also applies to VB.Net, but the keywords are different — ByRef and ByVal .
4 Answers 4
By default (in C#), passing an object to a function actually passes a copy of the reference to that object. Changing the parameter itself only changes the value in the parameter, and not the variable that was specified.
Using out or ref passes a reference to the variable specified in the call to the function. Any changes to the value of an out or ref parameter will be passed back to the caller.
Both out and ref behave identically except for one slight difference: ref parameters are required to be initialised before calling, while out parameters can be uninitialised. By extension, ref parameters are guaranteed to be initialised at the start of the method, while out parameters are treated as uninitialised.
Edit: As dp points out, the difference between out and ref is only enforced by the C# compiler, not by the CLR. As far as I know, VB has no equivalent for out and implements ref (as ByRef ) only, matching the support of the CLR.