srtemplate 0.3.3

Template String blazing fast with dependencyless
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use crate::prelude::FuncResult;
use crate::template::validations;

/// Convert strings to lowercase.
///
/// This function takes a slice of strings and converts each string to lowercase.
/// It then concatenates the converted strings into a single string, separated by space.
///
/// # Arguments
///
/// * `args`: A slice of strings to be converted to lowercase.
///
/// # Returns
///
/// * A [`FuncResult`] containing the concatenated lowercase strings.
///
/// # Errors
///
/// This function can return an error of [`crate::function::FunctionError`] variant:
/// - `FunctionError::InvalidArgument` if there are insufficient input arguments.
#[cfg_attr(docsrs, doc(cfg(feature = "text")))]
#[cfg(feature = "text")]
pub fn to_lower(args: &[String]) -> FuncResult {
    validations::args_min_len(args, 1)?;

    Ok(args
        .iter()
        .map(|a| a.to_lowercase())
        .collect::<Vec<_>>()
        .join(" "))
}

/// Convert strings to uppercase.
///
/// This function takes a slice of strings and converts each string to uppercase.
/// It then concatenates the converted strings into a single string, separated by space.
///
/// # Arguments
///
/// * `args`: A slice of strings to be converted to uppercase.
///
/// # Returns
///
/// * A [`FuncResult`] containing the concatenated uppercase strings.
///
/// # Errors
///
/// This function can return an error of [`crate::function::FunctionError`] variant:
/// - `FunctionError::InvalidArgument` if there are insufficient input arguments.
#[cfg_attr(docsrs, doc(cfg(feature = "text")))]
#[cfg(feature = "text")]
pub fn to_upper(args: &[String]) -> FuncResult {
    validations::args_min_len(args, 1)?;

    Ok(args
        .iter()
        .map(|a| a.to_uppercase())
        .collect::<Vec<_>>()
        .join(" "))
}

/// Trim leading and trailing whitespace from strings.
///
/// This function takes a slice of strings and removes leading and trailing whitespace
/// from each string. It then concatenates the trimmed strings into a single string, separated by space.
///
/// # Arguments
///
/// * `args`: A slice of strings to be trimmed.
///
/// # Returns
///
/// * A [`FuncResult`] containing the concatenated trimmed strings.
///
/// # Errors
///
/// This function can return an error of [`crate::function::FunctionError`] variant:
/// - `FunctionError::InvalidArgument` if there are insufficient input arguments.
#[cfg_attr(docsrs, doc(cfg(feature = "text")))]
#[cfg(feature = "text")]
pub fn trim(args: &[String]) -> FuncResult {
    validations::args_min_len(args, 1)?;

    Ok(args.iter().map(|a| a.trim()).collect::<Vec<_>>().join(" "))
}