feat: Example/SchemaExample: allow \r \n \t

operation.go

@@ -535,6 +535,9 @@ func setDefault(param *spec.Parameter, schemaType string, value string) error {
 	return nil
 }
 
+// controlCharReplacer replaces \r \n \t in example string values
+var controlCharReplacer = strings.NewReplacer(`\r`, "\r", `\n`, "\n", `\t`, "\t")
+
 func setSchemaExample(param *spec.Parameter, schemaType string, value string) error {
 	val, err := defineType(schemaType, value)
 	if err != nil {
@@ -544,7 +547,14 @@ func setSchemaExample(param *spec.Parameter, schemaType string, value string) er
 	if param.Schema == nil {
 		return nil
 	}
-	param.Schema.Example = val
+
+	switch v := val.(type) {
+	case string:
+		param.Schema.Example = controlCharReplacer.Replace(v)
+	default:
+		param.Schema.Example = val
+	}
+
 	return nil
 }
 

operation_test.go

@@ -1918,13 +1918,16 @@ func TestParseParamCommentBySchemaExampleUnsupportedType(t *testing.T) {
 
 	param.Schema = &spec.Schema{}
 	setSchemaExample(&param, STRING, "string value")
-	assert.Equal(t, param.Schema.Example, "string value")
+	assert.Equal(t, "string value", param.Schema.Example)
 
 	setSchemaExample(&param, INTEGER, "10")
-	assert.Equal(t, param.Schema.Example, 10)
+	assert.Equal(t, 10, param.Schema.Example)
 
 	setSchemaExample(&param, NUMBER, "10")
-	assert.Equal(t, param.Schema.Example, float64(10))
+	assert.Equal(t, float64(10), param.Schema.Example)
+
+	setSchemaExample(&param, STRING, "string \\r\\nvalue")
+	assert.Equal(t, "string \r\nvalue", param.Schema.Example)
 }
 
 func TestParseParamArrayWithEnums(t *testing.T) {