Skip to main content

Type Conversion in Rust

Type conversion is not special in Rust. It's just a function that takes ownership of the value and returns the other type. So you can name convert functions anything. However, it's a convention to use as_, to_, and into_ prefixed name or to use from_ prefixed constructor.

From

You can create any function for type conversion. However, if you want to provide generic interfaces, you'd better implement the From trait. For instance, you should implement From<X> for Y when you want the interface that converts the X type value to the Y type value.

The From trait have an associated function named from. You can call this function like From::from(x). You also can call it like Y::from(x) if the compiler cannot infer the type of the destination type.

Into

From have an associated function, it makes you be able to specify the destination type. It's why From has an associated function instead of a method, but on the other hands, you cannot use it as a method, like a.from().

You should implement the Into trait to use a method for type conversion. This trait allows a variable to be converted to another type with the method. You can use into as X::into(x) or Into::into, but no one needs to do it. It's merely a verbose code. Use x.into() as long as the compiler can infer the destination type. Otherwise, use From.

TryFrom

From and Into are traits to provide a conversion function that would not fail. However, some conversions can fail. For instance, converting from i128 to i32 can fail because some values of i128 are not in the range of i32. To do these conversions, you should use TryFrom and TryInto. For instance, Rust uses TryFrom that returns TryFromIntError on the failure for the above example.

TryInto

The relation between TryFrom and TryInto is the same as From and Into. TryFrom has an associated function named try_from and TryInto has a method named try_into.

From Implies Into

from and into should have the same behavior. The different behavior confuses the users; in fact, you cannot implement them differently. If you simultaneously implement From<Y> for X and Into<X> for Y, you would see the below error message.

error[E0119]: conflicting implementations of trait `std::convert::Into<X>` for type `Y`:

It's because From implies Into. It's called a blanket implementation.

Because of this blanket implementation, you'd better implement From instead of Into when you need a type converting method.

As far as I know, there is only one exception that you should implement Into instead of From. If the output type of the conversion function is a generic type that is not declared in the current crate, you cannot implement From. It's the only case(at least as far as I know). The same rule is applied to TryFrom and TryInto.

Labels:

Comments

Post a Comment

Popular posts from this blog

[C++] Handling Exceptions in Constructors

When you use RAII idiom, there are often situations where constructors have to do complex tasks. These complex tasks can sometimes fail, resulting in throwing exceptions. This raises a concern: Is it okay to throw exceptions in constructors? The first concern is memory leaks. Fortunately, memory leaks do not occur. Variables created on the stack are released through stack unwinding, and if an exception occurs during heap allocation with the new operator, the new operator automatically deallocates the memory and returns nullptr . The next concern is whether the destructor of the member variables will be called correctly. However, this is also not a problem. When an exception occurs, member variables can be divided into three categories: fully initialized member variables, member variables being initialized, and uninitialized member variables. Fully initialized member variables have had their constructors called and memory allocations completed successfully. In the example code, t...
Post a Comment
Read more

Iterator Adapters in Rust

An Iterator that takes another iterator and returns a new one is called an iterator adapter . The name "adapter" comes from one of the GoF's design patterns, the adapter pattern . However, in reality, it corresponds more to the decorator pattern , so if you pay too much attention to the name, you might get confused about its purpose. So it's better not to worry too much about the name. Enough complaining about the name, what does an iterator adapter do? An iterator adapter adds a task to be performed when the iterator iterates. This will be easier to understand when you see an example. The map function is one of the famous adapters. The iterator returned by the map function for those who have used functional languages iterates over new values transformed from the original values. Besides, various adapters are already implemented in the standard library. Among them, the most frequently used are those that are convenient to use with loops. Examples include the ...
Post a Comment
Read more

Clear Screen with CSI Sequence

Today, following my previous post , I will explain how to clear the screen using CSI Sequences. There are two sequences in the CSI Sequence for clearing. The first one is the Erase in Line sequence, called EL . It is composed of CSI # K ; it is used to erase lines, as the name suggests. If the # is not provided, the default value is 0, and if a value is provided, it must be one of the three: 0, 1, or 2. The terminal will ignore the sequence if any other value is provided. For example, if you print 0x311b5b334b32 (or 1^[3K2 ), the terminal ignores ^[3K , and the screen displays only 12 . The behavior of 0, 1, and 2 can be summarized as follows. 0 Erases from the cursor to the end of the line. 1 Erases from the beginning of the line to the cursor. 2 Erases the entire line, regardless of the cursor's position. Remember that the EL sequence does not move the cursor's position. Therefore, if you want to erase the current line and write a new line on the c...
Post a Comment
Read more