string_editor - v1.1.0

string_editor

Values

after

</> 
pub fn after(
  string: String,
  on pattern: String,
) -> Result(String, Nil)

Returns the part of a string after the first occurrence of a given substring.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

after(“hello world”, on: “ “) Ok(“world”)

after(“gleam is fun”, on: “!”) Error(Nil)

after_all

</> 
pub fn after_all(
  string: String,
  on pattern: String,
) -> List(String)

Returns all parts of a string after each occurrence of a given substring.

Examples

after_all(“a.b.c.d”, on: “.”) [“b.c.d”, “c.d”, “d”]

after_all(“hello world”, on: “!”) []

after_at

</> 
pub fn after_at(
  string: String,
  on pattern: String,
  at index: Int,
) -> Result(String, Nil)

Returns the part of a string after the nth occurrence of a given substring.

Index is 0-based. If the pattern doesn’t occur enough times, returns Error(Nil).

Examples

after_at(“a.b.c.d”, on: “.”, at: 1) Ok(“c.d”)

after_at(“hello world”, on: “ “, at: 5) Error(Nil)

after_last

</> 
pub fn after_last(
  string: String,
  on pattern: String,
) -> Result(String, Nil)

Returns the part of a string after the last occurrence of a given substring.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

after_last(“/home/user/document.txt”, on: “/”) Ok(“document.txt”)

after_last(“gleam is fun”, on: “!”) Error(Nil)

before

</> 
pub fn before(
  string: String,
  on pattern: String,
) -> Result(String, Nil)

Returns the part of a string before the first occurrence of a given substring.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

before(“hello world”, on: “ “) Ok(“hello”)

before(“gleam is fun”, on: “!”) Error(Nil)

before_all

</> 
pub fn before_all(
  string: String,
  on pattern: String,
) -> List(String)

Returns all parts of a string before each occurrence of a given substring.

Examples

before_all(“a.b.c.d”, on: “.”) [“a”, “a.b”, “a.b.c”]

before_all(“hello world”, on: “!”) []

before_at

</> 
pub fn before_at(
  string: String,
  on pattern: String,
  at index: Int,
) -> Result(String, Nil)

Returns the part of a string before the nth occurrence of a given substring.

Index is 0-based. If the pattern doesn’t occur enough times, returns Error(Nil).

Examples

before_at(“a.b.c.d”, on: “.”, at: 1) Ok(“a.b”)

before_at(“hello world”, on: “ “, at: 5) Error(Nil)

before_last

</> 
pub fn before_last(
  string: String,
  on pattern: String,
) -> Result(String, Nil)

Returns the part of a string before the last occurrence of a given substring.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

before_last(“/home/user/document.txt”, on: “/”) Ok(“/home/user”)

before_last(“gleam is fun”, on: “!”) Error(Nil)

between

</> 
pub fn between(
  string: String,
  from start: String,
  to end: String,
) -> Result(String, Nil)

Returns the part of a string between two given substrings.

It finds the first occurrence of start and then the first occurrence of end after start. If either is not found in the correct order, or is empty, it returns Error(Nil).

Examples

between(“b”, from: “”, to: “”) Ok(“b”)

between(“

title

”, from: “

”, to: “

”) Error(Nil)

between_all

</> 
pub fn between_all(
  string: String,
  from start: String,
  to end: String,
) -> List(String)

Returns all parts of a string between each occurrence of start and the next occurrence of end.

Examples

between_all(“123”, from: “”, to: “”) [“1”, “3”]

between_all(“no matches here”, from: “

”, to: “
”) []

between_at

</> 
pub fn between_at(
  string: String,
  from start: String,
  to end: String,
  at index: Int,
) -> Result(String, Nil)

Returns the part of a string between the nth occurrence of start and the first occurrence of end after that.

Index is 0-based for the start pattern. If patterns don’t occur enough times, returns Error(Nil).

Examples

between_at(“12”, from: “”, to: “”, at: 1) Ok(“2”)

between_at(“

title

”, from: “

”, to: “

”, at: 0) Error(Nil)

count

</> 
pub fn count(string: String, of pattern: String) -> Int

Counts the number of non-overlapping occurrences of a substring in a string. An empty pattern always counts as 0.

Examples

count(“hello hello world”, of: “hello”) 2

count(“gleam is fun”, of: “rust”) 0

count(“aaaa”, of: “aa”) 2

replace_after

</> 
pub fn replace_after(
  string: String,
  on pattern: String,
  with replacement: String,
) -> Result(String, Nil)

Replaces the part of a string after the first occurrence of a given substring, keeping the pattern itself.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

replace_after(“hello world”, on: “ “, with: “gleam”) Ok(“hello gleam”)

replace_after(“gleam is fun”, on: “!”, with: “x”) Error(Nil)

replace_before

</> 
pub fn replace_before(
  string: String,
  on pattern: String,
  with replacement: String,
) -> Result(String, Nil)

Replaces the part of a string before the first occurrence of a given substring, keeping the pattern itself.

If the substring is not found, or is empty, it returns Error(Nil).

Examples

replace_before(“hello world”, on: “ “, with: “goodbye”) Ok(“goodbye world”)

replace_before(“gleam is fun”, on: “!”, with: “x”) Error(Nil)

replace_between

</> 
pub fn replace_between(
  string: String,
  from start: String,
  to end: String,
  with replacement: String,
) -> Result(String, Nil)

Replaces the part of a string between two given substrings, keeping both delimiters.

It finds the first occurrence of start and then the first occurrence of end after start. If either is not found in the correct order, or is empty, it returns Error(Nil).

Examples

replace_between(“old”, from: “”, to: “”, with: “new”) Ok(“new”)

replace_between(“

title

”, from: “

”, to: “

”, with: “x”) Error(Nil)

✨ Search Document