comphead commented on code in PR #13925: URL: https://github.com/apache/datafusion/pull/13925#discussion_r1901186795
########## datafusion/functions/src/string/concat_ws.rs: ########## @@ -27,11 +27,34 @@ use crate::strings::{ColumnarValueRef, StringArrayBuilder}; use datafusion_common::cast::{as_string_array, as_string_view_array}; use datafusion_common::{exec_err, internal_err, plan_err, Result, ScalarValue}; use datafusion_expr::expr::ScalarFunction; -use datafusion_expr::scalar_doc_sections::DOC_SECTION_STRING; use datafusion_expr::simplify::{ExprSimplifyResult, SimplifyInfo}; use datafusion_expr::{lit, ColumnarValue, Documentation, Expr, Volatility}; use datafusion_expr::{ScalarUDFImpl, Signature}; +use datafusion_macros::user_doc; +#[user_doc( + doc_section(label = "String Functions"), + description = "Concatenates multiple strings together with a specified separator.", + syntax_example = "concat_ws(separator, str[, ..., str_n])", + sql_example = r#"```sql +> select concat_ws('_', 'data', 'fusion'); ++--------------------------------------------------+ +| concat_ws(Utf8("_"),Utf8("data"),Utf8("fusion")) | ++--------------------------------------------------+ +| data_fusion | ++--------------------------------------------------+ +```"#, + standard_argument(name = "str", prefix = "String"), + argument( + name = "separator", + description = "Separator to insert between concatenated strings." + ), + argument( + name = "str_n", + description = "Subsequent string expressions to concatenate." + ), Review Comment: ```suggestion argument( name = "separator", description = "Separator to insert between concatenated strings." ), argument( name = "str", description = "String expression to operate on. Can be a constant, column, or function, and any combination of operators."), argument( name = "str_n", description = "Subsequent string expressions to concatenate." ), ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: github-unsubscr...@datafusion.apache.org For additional commands, e-mail: github-h...@datafusion.apache.org