Description
Format a literal iCalendar TEXT-list with per-value escaping, preserving empty elements and source order; no property-specific semantics.
iCalendar separates content-line framing, property values, parameters and component nesting. TEXT escaping protects separators, while line folding is based on encoded octets. DATE, floating time, UTC and named-zone representations carry different information; a token-level operation does not resolve a timezone or expand recurrence rules.1
Format a literal iCalendar TEXT-list with per-value escaping, preserving empty elements and source order; no property-specific semantics.
When to use this tool
Use this tool to format a literal iCalendar TEXT-list with per-value escaping, preserving empty elements and source order; no property-specific semantics.
How to use the tool and how it works
- Enter values using the field definitions below.
- Run the operation. Correct input errors before interpreting an output.
- Read result.text. Use the ordering, boundary rules and absence conditions described below.
Escape each supplied TEXT value independently and join the escaped strings with commas.2
| Input field | Meaning and units | Accepted input |
|---|---|---|
| values | Explicit unescaped TEXT values to encode. | Dense list of at most 128 strings, each at most 8,192 UTF-16 code units. |
| Output field | Interpretation |
|---|---|
| result | Object containing the named fields below. |
| result.text | Decoded or joined TEXT-value string under the stated escaping operation. |
{
"input": {
"values": [
"a,b",
"c"
]
},
"output": {
"result": {
"text": "a\\,b,c"
}
}
}Limitations and assumptions
- The supplied list is explicit; no content-line name, parameters or folding is added.
- Content spans use zero-based UTF-16 offsets; fold limits use UTF-8 bytes including the continuation space. Token helpers handle the stated subset only, without a timezone database, recurrence engine or calendar import.
- Every declared top-level input field is required and unexpected fields are rejected. Ordinary strings are limited to 8,192 UTF-16 code units and lists to 128 entries, with tighter operation-specific bounds where stated. JSON text has bounded nesting and node counts.
- Numeric outputs must be finite and no larger in absolute magnitude than the safe-integer limit; operations returning exact large integers use decimal text. Positions are zero-based and spans end exclusively unless the operation explicitly states a different convention.
Alternative or Complementary methods
Keep content-line syntax, value escaping and timezone interpretation separate. Use a complete iCalendar implementation for recurrence expansion, timezone transitions and property-specific validation.
References
Similar or alternative tools
- iCalendar Text List Value Splitter
Split an iCalendar TEXT-list only at unescaped commas, then decode defined TEXT escapes; repeated empty elements remain explicit.
- iCalendar Text Value Escaper
Escape iCalendar TEXT backslash, comma, semicolon and newline; lone CR is rejected, no colon or parameter encoding.