Method format

src/ore/src/sql.rs:186–220

Formats this SQL fragment by replacing each `{}` with the next SQL argument. Use `{{` and `}}` to escape literal braces.

(self, args: impl IntoIterator<Item = Sql>)

    ///
    /// Use `{{` and `}}` to escape literal braces.
    pub fn format(self, args: impl IntoIterator<Item = Sql>) -> Result<Self, SqlFormatError> {
        let mut args = args.into_iter();
        let mut out = String::with_capacity(self.0.len());
        let mut chars = self.0.chars().peekable();

        while let Some(ch) = chars.next() {
            match ch {
                '{' => match chars.peek() {
                    Some('{') => {
                        chars.next();
                        out.push('{');
                    }
                    Some('}') => {
                        chars.next();
                        let arg = args.next().ok_or(SqlFormatError::MissingArgument)?;
                        out.push_str(arg.as_str());
                    }
                    _ => return Err(SqlFormatError::InvalidOpenBrace),
                },
                '}' => match chars.peek() {
                    Some('}') => {
                        chars.next();
                        out.push('}');
                    }
                    _ => return Err(SqlFormatError::InvalidCloseBrace),
                },
                _ => out.push(ch),
            }
        }

        if args.next().is_some() {
            return Err(SqlFormatError::ExtraArgument);
        }
        Ok(Sql(Cow::Owned(out)))
    }

    /// Like [`Sql::format`], but panics on invalid input instead of returning
    /// an error.