8.13 Find phonebook entries +CPBF
27.0073GPPAT command set for User Equipment (UE)Release 18TS
Table 73: +CPBF action command syntax
|
Command |
Possible response(s) |
|
+CPBF=<findtext> |
[+CPBF: <index1>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>]] [<CR><LF>+CBPF: <index2>,<number>,<type>,<text>[,<hidden>][,<group>][,<adnumber>][,<adtype>][,<secondtext>][,<email>][,<sip_uri>][,<tel_uri>] […]] +CME ERROR: <err> |
|
+CPBF=? |
+CPBF: [<nlength>],[<tlength>],[<glength>],[<slength>],[<elength>],[<siplength>],[<tellength>] +CME ERROR: <err> |
Description
Execution command returns phonebook entries (from the current phonebook memory storage selected with +CPBS) which alphanumeric field start with string <findtext>. 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 listing fails in an MT error, +CME ERROR: <err> is returned. Refer clause 9.2 for possible <err> values.
Test command returns 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>: 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)
<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
<findtext>, <text>: string type field of maximum length <tlength>; 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.