8.12 Read phonebook entries +CPBR
27.0073GPPAT command set for User Equipment (UE)Release 18TS
Table 72: +CPBR action command syntax
|
Command |
Possible response(s) |
|
+CPBR=<index1>[,<index2>] |
[+CPBR: <index1>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>]] [[…] [<CR><LF>+CPBR: <index2>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>]]] +CME ERROR: <err> |
|
+CPBR=? |
+CPBR: (list of supported <index>s),[<nlength>],[<tlength>],[<glength>],[<slength>],[<elength>],[<siplength>],[<tellength>] +CME ERROR: <err> |
Description
Execution command returns phonebook entries in location number range <index1>… <index2> from the current phonebook memory storage selected with +CPBS. If <index2> is left out, only location <index1> is returned. Entry fields returned are location number <indexn>, phone number stored there <number> (of format <type>), text <text> associated with the number, if the selected phonebook supports hidden entries, <hidden> indicating if the entry is hidden, <group> indicating a group the entry may belong to, <adnumber> an additional number (of format <adtype>), <secondtext> a second text field associated with the number, <email> an email field, <sip_uri> SIP number and <tel_uri> TEL number. If all queried locations are empty (but available), no information text lines may be returned. If listing fails in an MT error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.
Test command returns location range supported by the current storage as a compound value and the maximum lengths of <number>, <text>, <group>, <secondtext>, <email>, <sip_uri> and <tel_uri> fields. In case of (U)SIM storage, the lengths may not be available. If MT is not currently reachable, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.
Defined values
<index1>, <index2>, <index>: integer type values in the range of location numbers of phonebook memory
<number>: string type phone number of format <type>
<type>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7)
<text>: string type field of maximum length <tlength>; character set as specified by command select TE character set +CSCS
<group>: string type field of maximum length <glength>; character set as specified by command select TE character set +CSCS
<adnumber>: string type phone number of format <adtype>
<adtype>: type of address octet in integer format (refer 3GPP TS 24.008 [8] clause 10.5.4.7)
<secondtext>: string type field of maximum length <slength>; character set as specified by command select TE character set +CSCS
<email>: string type field of maximum length <elength>; character set as specified by command select TE character set +CSCS
<sip_uri>: string type field of maximum length <siplength>; character set as specified by command select TE character set +CSCS
<tel_uri>: string type phone number of maximum length <tellength>; character set as specified by command select TE character set +CSCS
<nlength>: integer type value indicating the maximum length of field <number>
<tlength>: integer type value indicating the maximum length of field <text>
<glength>: integer type value indicating the maximum length of field <group>
<slength>: integer type value indicating the maximum length of field <secondtext>
<elength>: integer type value indicating the maximum length of field <email>
<siplength>: integer type value indicating the maximum length of field <sip_uri>
<tellength>: integer type value indicating the maximum length of field <tel_uri>
<hidden>: integer type value indicates if the entry is hidden or not
0: phonebook entry not hidden
1: phonebook entry hidden
Implementation
Optional.