Unix and Linux Discussions Tagged with sms |
|
Thread / Thread Starter |
Last Post |
Replies |
Views |
Forum |
|
|
|
11 |
17,335 |
UNIX for Advanced & Expert Users |
|
|
|
3 |
6,583 |
AIX |
|
|
|
3 |
3,611 |
Shell Programming and Scripting |
|
|
|
2 |
2,502 |
AIX |
|
|
|
3 |
5,163 |
Shell Programming and Scripting |
|
|
|
1 |
4,579 |
Software Releases - RSS News |
|
|
|
4 |
5,473 |
AIX |
|
|
|
0 |
5,046 |
AIX |
|
|
|
0 |
1,769 |
Software Releases - RSS News |
|
|
|
1 |
8,040 |
IP Networking |
|
|
|
0 |
4,373 |
IT Security RSS |
|
|
|
0 |
2,008 |
Complex Event Processing RSS News |
|
|
|
2 |
2,815 |
AIX |
|
|
|
1 |
13,765 |
HP-UX |
|
|
|
1 |
6,965 |
Solaris |
|
|
|
3 |
13,690 |
UNIX for Dummies Questions & Answers |
Device::Gsm::Sms(3pm) User Contributed Perl Documentation Device::Gsm::Sms(3pm)
NAME
Device::Gsm::Sms - SMS message internal class that represents a single text SMS message
SYNOPSIS
# A list of Device::Gsm::Sms messages is returned by
# Device::Gsm messages() method.
use Device::Gsm;
...
@sms = $gsm->messages();
if( @sms ) {
foreach( @sms ) {
print $msg->storage() , "
";
print $msg->recipient() , "
";
print $msg->sender() , "
";
print $msg->content() , "
";
print $msg->time() , "
";
print $msg->type() , "
";
}
}
# Or you can instance a sms message from raw PDU data
my $msg = new Device::Gsm::Sms(
header => '+CMGL: ...',
pdu => `[encoded pdu data]',
storage=> 'ME', # or 'SC'
);
if( defined $msg ) {
print $msg->recipient() , "
";
print $msg->sender() , "
";
print $msg->content() , "
"; # or $msg->text()
print $msg->time() , "
";
print $msg->type() , "
";
}
$msg->delete();
DESCRIPTION
"Device::Gsm::Sms" class implements very basic SMS message object, that can be used to decode "+CMGL" GSM command response to build a more
friendly high-level object.
METHODS
The following is a list of methods applicable to "Device::Gsm::Sms" objects.
content()
See text() method.
decode()
Starts the decoding process of pdu binary data. If decoding process ends in success, return value is true and sms object is filled with all
proper values.
If decoding process has errors or pdu data is not provided, return value is 0 (zero).
delete()
Delete the current SMS message from sim card. Example:
$gsm = Device::Gsm->new();
...
my @msg = $gsm->messages();
$msg[0] && $msg[0]->delete();
new()
Basic constructor. You can build a new "Device::Gsm::Sms" object from the raw +CMGL header and PDU data. Those data is then decoded and a
new sms object is instanced and all information filled, to be available for subsequent method calls.
The allowed parameters to new() method are:
header
This is the raw +CMGL header string as modem outputs when you issue a +CMGL command
pdu Binary encoded sms data
storage
Tells which storage to delete the message from. Check the documentation of your phone to know valid storage values. Default values are:
"ME"
Deletes messages from gsm phone memory.
"SC"
Deletes messages from sim card.
index()
Returns the sms message index number, that is the position of message in the internal device memory or sim card. This number is used for
example to delete the message.
my $gsm = Device::Gsm->new(port=>'/dev/ttyS0');
...
my @messages = $gsm->messages();
...
# Delete the first returned message
my $msg = shift @messages;
$gsm->delete_sms( $msg->index() );
recipient()
Returns the sms recipient number (destination address = DA) as string (ex.: +39012345678).
sender()
Returns the sms sender number (originating address = OA) as string.
status()
Status of the message can be one value from the following list:
storage()
Returns the storage where SMS has been read from.
text()
Returns the textual content of sms message.
token()
Returns the given PDU token of the decoded message (internal usage).
type()
SMS messages can be of two types: SMS_SUBMIT and SMS_DELIVER, that are defined by two constants with those names. type() method returns one
of these two values.
Example:
if( $sms->type() == Device::Gsm::Sms::SMS_DELIVER ) {
# ...
}
elsif( $sms->type() == Device::Gsm::Sms::SMS_SUBMIT ) {
# ...
}
REQUIRES
o Device::Gsm
EXPORTS
None
TODO
o Complete and proof-read documentation and examples
COPYRIGHT
Device::Gsm::Sms - SMS message simple class that represents a text SMS message
Copyright (C) 2002-2009 Cosimo Streppone, cosimo@cpan.org
This program is free software; you can redistribute it and/or modify it only under the terms of Perl itself.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Perl licensing terms for details.
AUTHOR
Cosimo Streppone, cosimo@cpan.org
SEE ALSO
Device::Gsm, perl(1)
perl v5.14.2 2012-03-08 Device::Gsm::Sms(3pm)