VCardAddress::parseFullAddress() - Code Metrics - Inspection of "scrutinizer / phpstan fixes" - Stefanius67/VCard - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — master ( 7393e4...370734 )

by Stefan

created 2023-05-08 15:15 UTC

VCardAddress::parseFullAddress() A

↳ Parent: VCardAddress

Complexity

Conditions	1
Paths	1

Size

Total Lines	12
Code Lines	9

Duplication

Lines	0
Ratio	0 %

Importance

Changes	3
Bugs	0	Features	1

Metric	Value
eloc	9
c	3
b	0
f	1
dl	0
loc	12
rs	9.9666
cc	1
nc	1
nop	2

<?php
declare(strict_types=1);

namespace SKien\VCard;

/**
 * Class representing one address within a contact.
 *
 * #### Add an address to a contact for writing:
 * Create a new instance of a `VCardAdress`, set its property and add the address
 * to a contact using `VCardContact::addAddress()`
 *
 * #### Retrieve an address within a contact:
 * Use `VCardContact::getAddress()` to retrieve existing address within a given
 * contact.
 *
 * @see  VCardContact::addAddress()
 * @see  VCardContact::getAddress()
 *
 * @package VCard
 * @author Stefanius <[email protected]>
 * @copyright MIT License - see the LICENSE file for details
 */
class VCardAddress
{
    use VCardHelper;

    /** @var string  street (including house number)    */
    protected string $strStr = '';
    /** @var string  city   */
    protected string $strCity = '';
    /** @var string  postcode   */
    protected string $strPostcode = '';
    /** @var string  country */
    protected string $strCountry = '';
    /** @var string  region */
    protected string $strRegion = '';
    /** @var string  post office box */
    protected string $strPOBox = '';
    /** @var string  extended address (e.g. apartment or suite number) */
    protected string $strExtAddress = '';
    /** @var string  type (VCard::HOME, VCard::WORK, VCard::POSTAL, VCard::PARCEL)  */
    protected string $strType = '';
    /** @var bool  preferred address  */
    protected bool $bPreferred = false;

    /**
     * Full address information.
     * Build semicolon delimitered string containing:
     *  - post office address (postbox)
     *  - extended address (e.g. apartment or suite number)
     *  - street (including house number)
     *  - city
     *  - region
     *  - postal code
     *  - country
     * @return string
     * @internal only should be called by the VCardContactWriter
     */
    public function buildFullAddress() : string
    {
        $strField = 'ADR;TYPE=' . $this->strType;
        if ($this->bPreferred) {
            $strField .= ',PREF';
        }
        // postbox
        // extended address
        // street (including house number)
        // city
        // region
        // postal code
        // country
        // values separated by semikolon
        $strValue  = $this->maskString($this->strPOBox) . ';';
        $strValue .= $this->maskString($this->strExtAddress) . ';';
        $strValue .= $this->maskString($this->strStr) . ';';
        $strValue .= $this->maskString($this->strCity) . ';';
        $strValue .= $this->maskString($this->strRegion) . ';';
        $strValue .= $this->maskString($this->strPostcode) . ';';
        $strValue .= $this->maskString($this->strCountry);

        return $this->buildProperty($strField, $strValue, false);
    }

    /**
     * Build label for ther address.
     * @return string
     * @internal only should be called by the VCardContactWriter
     */
    public function buildLabel(): string
    {
        $strField = 'LABEL;TYPE=' . $this->strType;
        if ($this->bPreferred) {
            $strField .= ',PREF';
        }

        // values separated by semikolon
        $strValue  = $this->strStr . PHP_EOL;
        $strValue .= $this->strPostcode . ' ' . $this->strCity . PHP_EOL;
        if (strlen($this->strRegion) > 0 || strlen($this->strCountry) > 0) {
            $strSep = (empty($this->strRegion) || empty($this->strCountry)) ? '' : ' - ';
            $strValue .= $this->strRegion . $strSep . $this->strCountry . PHP_EOL;
        }

        return $this->buildProperty($strField, $strValue);
    }

    /**
     * explode string into address components:
     *  - post office address (postbox)
     *  - extended address (e.g. apartment or suite number)
     *  - street (including house number)
     *  - city
     *  - region
     *  - postal code
     *  - country
     *  delimitered by semicolon (be aware of masked delimiters)
     *
     * @param string $strValue
     * @param array<string,string>  $aParams
     * @internal only should be called by the VCardContactReader
     */
    public function parseFullAddress(string $strValue, array $aParams) : void
    {
        $aSplit = $this->explodeMaskedString(';', $strValue);

        $this->strPOBox = $this->unmaskString($aSplit[0] ?? '');
        $this->strExtAddress = $this->unmaskString($aSplit[1] ?? '');
        $this->strStr = $this->unmaskString($aSplit[2] ?? '');
        $this->strCity = $this->unmaskString($aSplit[3] ?? '');
        $this->strRegion = $this->unmaskString($aSplit[4] ?? '');
        $this->strPostcode = $this->unmaskString($aSplit[5] ?? '');
        $this->strCountry = $this->unmaskString($aSplit[6] ?? '');
        $this->strType = $aParams['TYPE'] ?? VCard::HOME;
    }

    /**
     * Set street.
     * @param string $strStr
     */
    public function setStr(string $strStr) : void
    {
        $this->strStr = $strStr;
    }

    /**
     * Set city.
     * @param string $strCity
     */
    public function setCity(string $strCity) : void
    {
        $this->strCity = $strCity;
    }

    /**
     * Set Postcode
     * @param string $strPostcode
     */
    public function setPostcode(string $strPostcode) : void
    {
        $this->strPostcode = $strPostcode;
    }

    /**
     * Set country.
     * @param string $strCountry
     */
    public function setCountry(string $strCountry) : void
    {
        $this->strCountry = $strCountry;
    }

    /**
     * Set region.
     * @param string $strRegion
     */
    public function setRegion(string $strRegion) : void
    {
        $this->strRegion = $strRegion;
    }

    /**
     * Set post office box.
     * @param string $strPOBox
     */
    public function setPOBox(string $strPOBox) : void
    {
        $this->strPOBox = $strPOBox;
    }

    /**
     * Set extended address (e.g. apartment or suite number).
     * @param string $strExtAddress
     */
    public function setExtAddress(string $strExtAddress) : void
    {
        $this->strExtAddress = $strExtAddress;
    }

    /**
     * Set type.
     * Any combination of the predefined types VCard::PREF, VCard::WORK, VCard::HOME
     * VCard::POSTAL, VCard::PARCEL, VCard::INTER or VCard::DOMESTIC can be set.
     * @param string|array<string> $type    one single type or an array of multiple types
     */
    public function setType($type) : void
    {
        $this->strType = is_array($type) ? implode(',', $type) : $type;
    }

    /**
     * Set this address as preferred.
     * @param bool $bPreferred
     */
    public function setPreferred(bool $bPreferred) : void
    {
        $this->bPreferred = $bPreferred;
    }

    /**
     * Get street.
     * @return string $strStr
     */
    public function getStr() : string
    {
        return $this->strStr;
    }

    /**
     * Get city.
     * @return string  $strCity
     */
    public function getCity() : string
    {
        return $this->strCity;
    }

    /**
     * Get postcode.
     * @return string  $strPostcode
     */
    public function getPostcode() : string
    {
        return $this->strPostcode;
    }

    /**
     * Get country.
     * @return string  $strCountry
     */
    public function getCountry() : string
    {
        return $this->strCountry;
    }

    /**
     * Get region.
     * @return string  $strRegion
     */
    public function getRegion() : string
    {
        return $this->strRegion;
    }

    /**
     * Get post office box.
     * @return string  $strPOBox
     */
    public function getPOBox() : string
    {
        return $this->strPOBox;
    }

    /**
     * Get extended address (e.g. apartment or suite number).
     * @return string  $strRegion
     */
    public function getExtAddress() : string
    {
        return $this->strExtAddress;
    }

    /**
     * Get type.
     * @return string  $strType can b comma separated list of multiple types.
     */
    public function getType() : string
    {
        return $this->strType;
    }

    /**
     * Get preferred state.
     * @return bool $bPreferred
     */
    public function isPreferred() : bool
    {
        return $this->bPreferred;
    }
}

1			<?php
2			declare(strict_types=1);
3
4			namespace SKien\VCard;
5
6			/**
7			* Class representing one address within a contact.
8			*
9			* #### Add an address to a contact for writing:
10			* Create a new instance of a `VCardAdress`, set its property and add the address
11			* to a contact using `VCardContact::addAddress()`
12			*
13			* #### Retrieve an address within a contact:
14			* Use `VCardContact::getAddress()` to retrieve existing address within a given
15			* contact.
16			*
17			* @see VCardContact::addAddress()
18			* @see VCardContact::getAddress()
19			*
20			* @package VCard
21			* @author Stefanius <[email protected]>
22			* @copyright MIT License - see the LICENSE file for details
23			*/
24			class VCardAddress
25			{
26			use VCardHelper;
27
28			/** @var string street (including house number) */
29			protected string $strStr = '';
30			/** @var string city */
31			protected string $strCity = '';
32			/** @var string postcode */
33			protected string $strPostcode = '';
34			/** @var string country */
35			protected string $strCountry = '';
36			/** @var string region */
37			protected string $strRegion = '';
38			/** @var string post office box */
39			protected string $strPOBox = '';
40			/** @var string extended address (e.g. apartment or suite number) */
41			protected string $strExtAddress = '';
42			/** @var string type (VCard::HOME, VCard::WORK, VCard::POSTAL, VCard::PARCEL) */
43			protected string $strType = '';
44			/** @var bool preferred address */
45			protected bool $bPreferred = false;
46
47			/**
48			* Full address information.
49			* Build semicolon delimitered string containing:
50			* - post office address (postbox)
51			* - extended address (e.g. apartment or suite number)
52			* - street (including house number)
53			* - city
54			* - region
55			* - postal code
56			* - country
57			* @return string
58			* @internal only should be called by the VCardContactWriter
59			*/
60			public function buildFullAddress() : string
61			{
62			$strField = 'ADR;TYPE=' . $this->strType;
63			if ($this->bPreferred) {
64			$strField .= ',PREF';
65			}
66			// postbox
67			// extended address
68			// street (including house number)
69			// city
70			// region
71			// postal code
72			// country
73			// values separated by semikolon
74			$strValue = $this->maskString($this->strPOBox) . ';';
75			$strValue .= $this->maskString($this->strExtAddress) . ';';
76			$strValue .= $this->maskString($this->strStr) . ';';
77			$strValue .= $this->maskString($this->strCity) . ';';
78			$strValue .= $this->maskString($this->strRegion) . ';';
79			$strValue .= $this->maskString($this->strPostcode) . ';';
80			$strValue .= $this->maskString($this->strCountry);
81
82			return $this->buildProperty($strField, $strValue, false);
83			}
84
85			/**
86			* Build label for ther address.
87			* @return string
88			* @internal only should be called by the VCardContactWriter
89			*/
90			public function buildLabel(): string
91			{
92			$strField = 'LABEL;TYPE=' . $this->strType;
93			if ($this->bPreferred) {
94			$strField .= ',PREF';
95			}
96
97			// values separated by semikolon
98			$strValue = $this->strStr . PHP_EOL;
99			$strValue .= $this->strPostcode . ' ' . $this->strCity . PHP_EOL;
100			if (strlen($this->strRegion) > 0 \|\| strlen($this->strCountry) > 0) {
101			$strSep = (empty($this->strRegion) \|\| empty($this->strCountry)) ? '' : ' - ';
102			$strValue .= $this->strRegion . $strSep . $this->strCountry . PHP_EOL;
103			}
104
105			return $this->buildProperty($strField, $strValue);
106			}
107
108			/**
109			* explode string into address components:
110			* - post office address (postbox)
111			* - extended address (e.g. apartment or suite number)
112			* - street (including house number)
113			* - city
114			* - region
115			* - postal code
116			* - country
117			* delimitered by semicolon (be aware of masked delimiters)
118			*
119			* @param string $strValue
120			* @param array<string,string> $aParams
121			* @internal only should be called by the VCardContactReader
122			*/
123			public function parseFullAddress(string $strValue, array $aParams) : void
124			{
125			$aSplit = $this->explodeMaskedString(';', $strValue);
126
127			$this->strPOBox = $this->unmaskString($aSplit[0] ?? '');
128			$this->strExtAddress = $this->unmaskString($aSplit[1] ?? '');
129			$this->strStr = $this->unmaskString($aSplit[2] ?? '');
130			$this->strCity = $this->unmaskString($aSplit[3] ?? '');
131			$this->strRegion = $this->unmaskString($aSplit[4] ?? '');
132			$this->strPostcode = $this->unmaskString($aSplit[5] ?? '');
133			$this->strCountry = $this->unmaskString($aSplit[6] ?? '');
134			$this->strType = $aParams['TYPE'] ?? VCard::HOME;
135			}
136
137			/**
138			* Set street.
139			* @param string $strStr
140			*/
141			public function setStr(string $strStr) : void
142			{
143			$this->strStr = $strStr;
144			}
145
146			/**
147			* Set city.
148			* @param string $strCity
149			*/
150			public function setCity(string $strCity) : void
151			{
152			$this->strCity = $strCity;
153			}
154
155			/**
156			* Set Postcode
157			* @param string $strPostcode
158			*/
159			public function setPostcode(string $strPostcode) : void
160			{
161			$this->strPostcode = $strPostcode;
162			}
163
164			/**
165			* Set country.
166			* @param string $strCountry
167			*/
168			public function setCountry(string $strCountry) : void
169			{
170			$this->strCountry = $strCountry;
171			}
172
173			/**
174			* Set region.
175			* @param string $strRegion
176			*/
177			public function setRegion(string $strRegion) : void
178			{
179			$this->strRegion = $strRegion;
180			}
181
182			/**
183			* Set post office box.
184			* @param string $strPOBox
185			*/
186			public function setPOBox(string $strPOBox) : void
187			{
188			$this->strPOBox = $strPOBox;
189			}
190
191			/**
192			* Set extended address (e.g. apartment or suite number).
193			* @param string $strExtAddress
194			*/
195			public function setExtAddress(string $strExtAddress) : void
196			{
197			$this->strExtAddress = $strExtAddress;
198			}
199
200			/**
201			* Set type.
202			* Any combination of the predefined types VCard::PREF, VCard::WORK, VCard::HOME
203			* VCard::POSTAL, VCard::PARCEL, VCard::INTER or VCard::DOMESTIC can be set.
204			* @param string\|array<string> $type one single type or an array of multiple types
205			*/
206			public function setType($type) : void
207			{
208			$this->strType = is_array($type) ? implode(',', $type) : $type;
209			}
210
211			/**
212			* Set this address as preferred.
213			* @param bool $bPreferred
214			*/
215			public function setPreferred(bool $bPreferred) : void
216			{
217			$this->bPreferred = $bPreferred;
218			}
219
220			/**
221			* Get street.
222			* @return string $strStr
223			*/
224			public function getStr() : string
225			{
226			return $this->strStr;
227			}
228
229			/**
230			* Get city.
231			* @return string $strCity
232			*/
233			public function getCity() : string
234			{
235			return $this->strCity;
236			}
237
238			/**
239			* Get postcode.
240			* @return string $strPostcode
241			*/
242			public function getPostcode() : string
243			{
244			return $this->strPostcode;
245			}
246
247			/**
248			* Get country.
249			* @return string $strCountry
250			*/
251			public function getCountry() : string
252			{
253			return $this->strCountry;
254			}
255
256			/**
257			* Get region.
258			* @return string $strRegion
259			*/
260			public function getRegion() : string
261			{
262			return $this->strRegion;
263			}
264
265			/**
266			* Get post office box.
267			* @return string $strPOBox
268			*/
269			public function getPOBox() : string
270			{
271			return $this->strPOBox;
272			}
273
274			/**
275			* Get extended address (e.g. apartment or suite number).
276			* @return string $strRegion
277			*/
278			public function getExtAddress() : string
279			{
280			return $this->strExtAddress;
281			}
282
283			/**
284			* Get type.
285			* @return string $strType can b comma separated list of multiple types.
286			*/
287			public function getType() : string
288			{
289			return $this->strType;
290			}
291
292			/**
293			* Get preferred state.
294			* @return bool $bPreferred
295			*/
296			public function isPreferred() : bool
297			{
298			return $this->bPreferred;
299			}
300			}

Stefanius67 / VCard

Push — master ( 7393e4...370734 )

VCardAddress::parseFullAddress() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like