Mbed OS Reference | URI.h Source File

 /* mbed Microcontroller Library
  * Copyright (c) 2018 ARM Limited
  * SPDX-License-Identifier: Apache-2.0
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *     http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
 
 #ifndef NFC_COMMON_URI_H_
 #define NFC_COMMON_URI_H_
 
 #include <stdint.h>
 #include <string.h>
 
 #include "platform/Span.h"
 
 #include "nfc/ndef/RecordParser.h"
 #include "nfc/ndef/MessageBuilder.h"
 
 namespace mbed {
 namespace nfc {
 namespace ndef {
 namespace common {
 
 /**
  * @addtogroup nfc
  * @{
  */
 
 /**
  * Model the well known type URI.
  */
 class URI {
 public:
     /**
      * Identifier codes
      */
     enum uri_identifier_code_t {
         NA = 0x00, /// Not applicable
         HTTP_WWW = 0x01, /// http://www.
         HTTPS_WWW = 0x02, /// https://www.
         HTTP = 0x03, /// http://
         HTTPS = 0x04, /// https://
         TEL = 0x05, /// tel:
         MAILTO = 0x06, /// mailto:
         FTP_ANONYMOUS = 0x07, /// ftp://anonymous:anonymous@
         FTP_FTP = 0x08, /// ftp://ftp.
         FTPS = 0x09, /// ftps://
         SFTP = 0x0A, /// sftp://
         SMB = 0x0B, /// smb://
         NFS = 0x0C, /// nfs://
         FTP = 0x0D, /// ftp://
         DAV = 0x0E, /// dav://
         NEWS = 0x0F, /// news:
         TELNET = 0x10, /// telnet://
         IMAP = 0x11, /// imap:
         RSTP = 0x12, /// rstp://
         URN = 0x13, /// urn:
         POP = 0x14, /// pop:
         SIP = 0x15, /// sip:
         SIPS = 0x16, /// sips:
         TFTP = 0x17, /// tftp:
         BTSPP = 0x18, /// btspp://
         BTL2CAP = 0x19, /// btl2cap://
         BTGOEP = 0x1A, /// btgoep://
         TCPOBEX = 0x1B, /// tcpobex://
         IRDAOBEX = 0x1C, /// irdaobex://
         FILE = 0x1D, /// file://
         URN_EPC_ID = 0x1E, /// urn:epc:id:
         URN_EPC_TAG = 0x1F, /// urn:epc:tag:
         URN_EPC_PAT = 0x20, /// urn:epc:pat:
         URN_EPC_RAW = 0x21, /// urn:epc:raw:
         URN_EPC = 0x22, /// urn:epc:
         URN_NFC = 0x23, /// urn:nfc:
     };
 
     /**
      * Construct an empty URI object.
      */
     URI();
 
     /**
      * Construct a URI from an id and a uri field.
      *
      * @param id The code of the URI prefix.
      * @param uri_field The URI itself.
      *
      * @note To remove the NULL terminator of the C-string of the uri_field
      * parameter, you can use the utility function span_from_cstr.
      */
     URI(uri_identifier_code_t id, const Span<const uint8_t> &uri_field);
 
     /**
      * Construct a URI from another URI.
      * @param to_copy The uri copied.
      */
     URI(const URI &to_copy);
 
     /**
      * Destroy a URI object.
      */
     ~URI();
 
     /**
      * Replace the content by the one of an existing URI.
      * @param to_copy The URI to copy.
      * @return a reference to this object
      */
     URI &operator=(const URI &to_copy);
 
     /**
      * Replace the value of the URI.
      *
      * @param id The ID of the URI
      * @param uri_field A buffer containing the value of the URI field.
      *
      * @note To remove the NULL terminator of the C-string of the uri_field
      * parameter, you can use the utility function span_from_cstr.
      */
     void set_uri(
         uri_identifier_code_t id,
         const Span<const uint8_t> &uri_field
     );
 
     /**
      * Return the id of the uri.
      * @return The id of the uri.
      */
     uri_identifier_code_t get_id() const;
 
     /**
      * Return the current value of the uri field.
      * @return The value of the uri field.
      */
     Span<const uint8_t> get_uri_field() const;
 
     /**
      * Append into a message builder
      */
     bool append_as_record(
         MessageBuilder &message_builder,
         bool is_last_record = false
     ) const;
 
     /**
      * Compute the size of this object in a ndef record.
      *
      * @return The size of the ndef record required to store this object.
      */
     size_t get_record_size() const;
 
     /**
      * Equal operator between two URIs
      * @param lhs The URI on the left hand side
      * @param rhs The URI on the right hand side
      * @return true if lhs equals rhs or false.
      */
     friend bool operator==(const URI &lhs, const URI &rhs)
     {
         if (lhs._uri_size != rhs._uri_size) {
             return false;
         }
 
         return memcmp(lhs._uri, rhs._uri, lhs._uri_size) == 0;
     }
 
     friend bool operator!=(const URI &lhs, const URI &rhs)
     {
         return !(lhs == rhs);
     }
 
 private:
     friend class URIParser;
 
     void move_data(uint8_t *text, size_t size);
 
     uint8_t *_uri;
     size_t _uri_size;
 };
 
 /**
  * Parser of a URI.
  */
 class URIParser : public GenericRecordParser<URIParser, URI> {
 public:
     bool do_parse(const Record &record, URI &uri);
 };
 
 /**
  * @}
  */
 
 } // namespace common
 } // namespace ndef
 } // namespace nfc
 } // namespace mbed
 
 #endif /* NFC_COMMON_URI_H_ */
Important Information for this Arm website
