I couldn’t find documentation for the following behaviour in https://caml.inria.fr/pub/docs/manual-ocaml/libref/Str.html : utop # Str.string_before "test" (-1);; Exception: Invalid_argument "String.sub / Bytes.sub". Anyone able to patch that? PS: Posted this on the caml-list but still hasn’t appea…

If you read the doc string it’s not surprising. n must be a position in the string, see definitions here .

You are right. But I was searching the docs for “raise” to find where my exception was coming from. It is the nature of exceptions to get buried if not handled with early. Seems Str lets through the exceptions but doesn’t document that. Even if I suspected this was happening, it would be hard to kno…

[image] anon72795300: Even if I suspected this was happening, it would be hard to know which exceptions to catch without looking at the source code. You are not supposed to catch Invalid_argument , that exception means that there is a programming error with your code (except in bool_of_string …

But how do I know it’s an Invalid_argument? That’s the point… I either have to wait for my app to crash with that or have some serendipitous intuition and dig into the source code… :roll_eyes: I brought it to the attention of the community; it may bite others too and would save time by adding a lin…

The Str library is more missing a warning to use other regexp library than anything else.

I’d say that it is still surprising. Potentially raised exceptions are often documented for the stdlib. That call to Str.string_before could return an empty string, raise a custom exception - there’s no way to know from the documentation. While I agree with @octachron that the real solution is to…

@anon72795300 Why don’t you submit a pull request to improve the documentation? That’s always the easiest way to get it to happen.

https://discuss.ocaml.org/t/publishing-without-github/3232/8 : [image] Publishing without Github? I have deleted my account many months ago. Ultimately this is not just for me, but for others too. Contributing should not depend on a single company and compelling community members to join them. I …

I will not try to persuade you to do otherwise. But I will note that your ability to get things done will be dramatically limited by your choice.

[image] perry: your ability to get things done will be dramatically limited by your choice. Our internet in 2020 :laughing: I trust that you mean well and I invite you to look at this from another perspective; where the choice of the core team has limited the interoperability with the rest o…

Missing exceptions warnings in Str documentation

Ecosystem

anon72795300 August 8, 2019, 5:55pm 9

https://discuss.ocaml.org/t/publishing-without-github/3232/8:

Topic		Replies	Views
Regexp matches in the Str library Learning	8	1140	May 23, 2022
Error: Unbound value String.ends_with Learning learn-ocaml	7	918	June 10, 2024
String vs StringLabels Learning	8	1368	October 27, 2017
Error handling regarding dimension mismatch: Using invalid_arg? Learning exceptions	8	146	March 25, 2026
Convert CamelCase string to Capitalized_snake_case without regex Learning string	17	3012	September 1, 2017

Missing exceptions warnings in Str documentation

Related topics