annotate vendor/sabre/vobject/lib/Property/FlatText.php @ 41:d2414df68d78

Updated by Alex S Grebenschikov (www.poralix.com) to make it compatible with RoundCube 1.3.0
author Charlie Root
date Fri, 24 Jan 2025 14:20:15 -0500
parents 430dbd5346f7
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
1 <?php
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
2
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
3 namespace Sabre\VObject\Property;
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
4
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
5 /**
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
6 * FlatText property
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
7 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
8 * This object represents certain TEXT values.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
9 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
10 * Specifically, this property is used for text values where there is only 1
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
11 * part. Semi-colons and colons will be de-escaped when deserializing, but if
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
12 * any semi-colons or commas appear without a backslash, we will not assume
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
13 * that they are delimiters.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
14 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
15 * vCard 2.1 specifically has a whole bunch of properties where this may
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
16 * happen, as it only defines a delimiter for a few properties.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
17 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
18 * vCard 4.0 states something similar. An unescaped semi-colon _may_ be a
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
19 * delimiter, depending on the property.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
20 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
21 * @copyright Copyright (C) 2011-2015 fruux GmbH (https://fruux.com/).
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
22 * @author Evert Pot (http://evertpot.com/)
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
23 * @license http://sabre.io/license/ Modified BSD License
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
24 */
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
25 class FlatText extends Text {
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
26
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
27 /**
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
28 * Field separator
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
29 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
30 * @var string
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
31 */
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
32 public $delimiter = ',';
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
33
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
34 /**
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
35 * Sets the value as a quoted-printable encoded string.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
36 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
37 * Overriding this so we're not splitting on a ; delimiter.
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
38 *
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
39 * @param string $val
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
40 * @return void
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
41 */
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
42 public function setQuotedPrintableValue($val) {
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
43
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
44 $val = quoted_printable_decode($val);
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
45 $this->setValue($val);
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
46
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
47 }
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
48
430dbd5346f7 vendor sabre as distributed
Charlie Root
parents:
diff changeset
49 }