What should the getter for a Vec|String| return, &[&str]? What about Option|Vec|String||?
What should the getter for a Vec|String| return, &[&str]? What about Option|Vec|String||?
When returning an immutable reference to a private struct field. (On mobile and used vertical bars instead of a bunch of HTML codes)
Note: the ᐸᐳ characters used below are Canadian Aboriginal syllabics because Lemmy devs haven’t fixed broken input sanitization yet.
Well, getters are not an official concept in Rust. You can do whatever works best in your case.
Just worth pointing out that a method with a return value of
OptionᐸVecᐸStringᐳᐳwouldn't be really a getter, as you must be constructing values, or moving ownership, or cloning. None of these actions conceptually belong to a getter.Also, you should be clear on the what the
Optionabstraction means. Does it mean the vector is empty? Does it mean the vector does not exist or some sort of null (FFI ore serialization contexts)? And make sure the code does what you expect it to do.Why not &[String]?
You may be better off with
&[String]as a read-only view ofVec. To get&[&str]I think you need to create a new collection to hold the&strvalues. (Stringand&strhave different memory representations.) But the choice depends on what you want to do - maybe providing&strvalues adds a convenience that is worth creating a second collection.For the Option case I would go with
Option<&[String]>. My understanding is thatOption<&T>is the same size as&Tfor anyTso an owned Option wrapper is zero-cost. If the reference pointer is null then Rust interprets that asNone. Besides you usually want ownership of anOptionso you canmapit or whatever else you want to do.Right, I want the convenience of &[&str] , but if it requires creating a second collection then I think &[String] is better. Use cases that require &str can just map to as_str.
A vec and a string are basically the same thing (a series of bytes)
In the context of vectors I prefer my APIs to return an empty set rather than an None-option. This makes handling it much easier because you can still iterate over it, it just has nothing.
This might involve the compiler making an allocation of an empty array but most of them (gcc, ghc) will now what you are doing and optimize the null check on the empty array to a bool check.
Note: the
ᐸᐳcharacters used below are Canadian Aboriginal syllabics because Lemmy devs haven't fixed broken input sanitization yet.
A vec and a string are basically the same thing (a series of bytes)
Everything is a series of bytes! I thought you were going to mention that both are fat pointers. But that "series of bytes" description is quite weird.
This makes handling it much easier because you can still iterate over it
This is not a valid consideration/objection, as
Options are iterable and you can flatten them:fn main() { let v = vec![1,2,3]; for n in Some(&v).into_iter().flatten() { eprintln!("{n}"); } for n in None::ᐸ&Vecᐸi32ᐳᐳ.into_iter().flatten() { eprintln!("{n}"); } }This might involve the compiler making an allocation of an empty array but most of them (gcc, ghc) will now what you are doing and optimize the null check on the empty array to a bool check
This paragraph appears to be out of place in the context of a Rust discussion.
Yes, but it's a pain to iterate over Options of Vec because you need to check/flatten twice. I am aware gcc/ghc is not relevant to rust discussions but I am not sure if rustc performs these specific optimizations. I expect it does because they are trivial. Who knows. I am just some random dude on the internet and a lot of drugs.
Vec::new is const and thus can’t allocate anyways.
In the context of vectors I prefer my APIs to return an empty set rather than an None-option. This makes handling it much easier because you can still iterate over it, it just has nothing.
I can see that argument. But you can also iterate over an Option-wrapped response with something like
for x in xs.into_iter().flatten() { ... }, and theOptiongives you an extra bit of information that can be helpful in certain cases.