original_string: public function getHierarchyDelimiter()
      {
          if ( $this->state != self::STATE_AUTHENTICATED &&
               $this->state != self::STATE_SELECTED &&
               $this->state != self::STATE_SELECTED_READONLY )
          {
              throw new ezcMailTransportException( "Can't call getDelimiter() when not successfully logged in." );
          }
  
          $tag = $this->getNextTag();
          $this->connection->sendData( "{$tag} LIST \"\" \"\"" );
  
          // there should be only one * LIST response line from IMAP
          $response = trim( $this->getResponse( '* LIST' ) );
          $parts = explode( '"', $response );
  
          if ( count( $parts ) >= 2 )
          {
              $result = $parts[1];
          }
          else
          {
              throw new ezcMailTransportException( "Could not retrieve the hierarchy delimiter: {$response}." );
          }
  
          $response = $this->getResponse( $tag, $response );
          if ( $this->responseType( $response ) != self::RESPONSE_OK )
          {
              throw new ezcMailTransportException( "Could not retrieve the hierarchy delimiter: {$response}." );
          }
          return $result;
      }
code: public function getHierarchyDelimiter()
      {
          if ( $this->state != self::STATE_AUTHENTICATED &&
               $this->state != self::STATE_SELECTED &&
               $this->state != self::STATE_SELECTED_READONLY )
          {
              throw new ezcMailTransportException( "Can't call getDelimiter() when not successfully logged in." );
          }
  
          $tag = $this->getNextTag();
          $this->connection->sendData( "{$tag} LIST \"\" \"\"" );
  
          // there should be only one * LIST response line from IMAP
          $response = trim( $this->getResponse( '* LIST' ) );
          $parts = explode( '"', $response );
  
          if ( count( $parts ) >= 2 )
          {
              $result = $parts[1];
          }
          else
          {
              throw new ezcMailTransportException( "Could not retrieve the hierarchy delimiter: {$response}." );
          }
  
          $response = $this->getResponse( $tag, $response );
          if ( $this->responseType( $response ) != self::RESPONSE_OK )
          {
              throw new ezcMailTransportException( "Could not retrieve the hierarchy delimiter: {$response}." );
          }
          return $result;
      }
code_tokens: public function getHierarchyDelimiter ( ) { if ( $ this -> state != self :: STATE_AUTHENTICATED && $ this -> state != self :: STATE_SELECTED && $ this -> state != self :: STATE_SELECTED_READONLY ) { throw new ezcMailTransportException ( "Can't call getDelimiter() when not successfully logged in." ) ; } $ tag = $ this -> getNextTag ( ) ; $ this -> connection -> sendData ( "{$tag} LIST \"\" \"\"" ) ; // there should be only one * LIST response line from IMAP $ response = trim ( $ this -> getResponse ( '* LIST' ) ) ; $ parts = explode ( '"' , $ response ) ; if ( count ( $ parts ) >= 2 ) { $ result = $ parts [ 1 ] ; } else { throw new ezcMailTransportException ( "Could not retrieve the hierarchy delimiter: {$response}." ) ; } $ response = $ this -> getResponse ( $ tag , $ response ) ; if ( $ this -> responseType ( $ response ) != self :: RESPONSE_OK ) { throw new ezcMailTransportException ( "Could not retrieve the hierarchy delimiter: {$response}." ) ; } return $ result ; }
docstring: Returns the hierarchy delimiter of the IMAP server, useful for handling
  nested IMAP folders.
  
  For more information about the hierarchy delimiter, consult the IMAP RFCs
  {@link http://www.faqs.org/rfcs/rfc1730.html} or
  {@link http://www.faqs.org/rfcs/rfc2060.html}, section 6.3.8.
  
  Before calling this method, a connection to the IMAP server must be
  established and a user must be authenticated successfully.
  
  Example of returning the hierarchy delimiter:
  <code>
  $imap = new ezcMailImapTransport( 'imap.example.com' );
  $imap->authenticate( 'username', 'password' );
  
  $delimiter = $imap->getDelimiter();
  </code>
  
  After running the above code, $delimiter should be something like "/".
  
  @throws ezcMailMailTransportException
  if the current server state is not accepted
  or if the server sent a negative response
  @return string
docstring_tokens: Returns the hierarchy delimiter of the IMAP server useful for handling nested IMAP folders .