Token
        
        extends HeaderPart
    
    
            
            in package
            
        
    
    
    
        
            Holds a string value token that will require additional processing by a consumer prior to returning to a client.
A Token is meant to hold a value for further processing -- for instance when consuming an address list header (like From or To) -- before it's known what type of IHeaderPart it is (could be an email address, could be a name, or could be a group.)
Tags
Table of Contents
- $charsetConverter : MbWrapper
- $value : string
- __construct() : mixed
- Initializes a token.
- __toString() : string
- Returns the value of the part (which is a string).
- getValue() : string|null
- Returns the part's value.
- ignoreSpacesAfter() : bool
- Returns true if the value is a space.
- ignoreSpacesBefore() : bool
- Returns true if the value is a space.
- isSpace() : bool
- Returns true if the value of the token is equal to a single space.
- convertEncoding() : string
- Ensures the encoding of the passed string is set to UTF-8.
Properties
$charsetConverter
    protected
        MbWrapper
    $charsetConverter
    
    
        the charset converter used for converting strings in HeaderPart::convertEncoding
$value
    protected
        string
    $value
    
    
        the value of the part
Methods
__construct()
Initializes a token.
    public
                    __construct(MbWrapper $charsetConverter, string $value) : mixed
    
        Parameters
- $charsetConverter : MbWrapper
- $value : string
- 
                    the token's value 
Return values
mixed —__toString()
Returns the value of the part (which is a string).
    public
                    __toString() : string
    
    
    
        Return values
string —the value
getValue()
Returns the part's value.
    public
                    getValue() : string|null
    
    
    
        Return values
string|null —the value of the part
ignoreSpacesAfter()
Returns true if the value is a space.
    public
                    ignoreSpacesAfter() : bool
    
    
    
        Return values
bool —ignoreSpacesBefore()
Returns true if the value is a space.
    public
                    ignoreSpacesBefore() : bool
    
    
    
        Return values
bool —isSpace()
Returns true if the value of the token is equal to a single space.
    public
                    isSpace() : bool
    
    
    
        Return values
bool —convertEncoding()
Ensures the encoding of the passed string is set to UTF-8.
    protected
                    convertEncoding(string $str[, string $from = 'ISO-8859-1' ][, bool $force = false ]) : string
        The method does nothing if the passed $from charset is UTF-8 already, or if $force is set to false and mb_check_encoding for $str returns true for 'UTF-8'.
Parameters
- $str : string
- $from : string = 'ISO-8859-1'
- $force : bool = false
Return values
string —utf-8 string