Class specifying the HL7 message, both request and response.
In general one needn't create an instance of the Message class directly, but use the HL7 factory class to create one.
When adding segments, note that the segment index starts at 0, so to get the first segment, do
php $msg->getSegmentByIndex(0)
The segment separator defaults to \015. To change this, set the global variable $SEGMENT_SEPARATOR.
| Name | Description |
|---|---|
| __construct | Constructor for Message. Consider using the HL7 factory to obtain a message instead. |
| addSegment | Append a segment to the end of the message |
| getSegmentAsString | Get the segment identified by index as string, using the messages separators. |
| getSegmentByIndex | Return the segment specified by $index. |
| getSegmentFieldAsString | Get the field identified by $fieldIndex from segment $segmentIndex. |
| getSegments | Return an array containing all segments in the right order. |
| getSegmentsByName | Return an array of all segments with the given name |
| insertSegment | Insert a segment. |
| removeSegmentByIndex | Remove the segment indexed by $index. |
| segmentToString | Convert Segment object to string |
| setSegment | Set the segment on index. |
| toString | Return a string representation of this message. |
Description
public __construct (string $msgStr, array $hl7Globals)Constructor for Message. Consider using the HL7 factory to obtain a message instead.
The constructor takes an optional string argument that is a string representation of a HL7 message. If the
string representation is not a valid HL7 message. according to the specifications, undef is returned instead of
a new instance. This means that segments should be separated within the message with the segment separator
(defaults to \015) or a newline, and segments should be syntactically correct. When using the string argument
constructor, make sure that you have escaped any characters that would have special meaning in PHP.
The control characters and field separator will take the values from the MSH segment, if set. Otherwise defaults
will be used. Changing the MSH fields specifying the field separator and control characters after the MSH has
been added to the message will result in setting these values for the message.
If the message couldn't be created, for example due to a erroneous HL7 message string, an error is raised.
Parameters
(string) $msgStr(array) $hl7Globals
Return Values
void
Description
public addSegment (\Segment $segment)Append a segment to the end of the message
Parameters
(\Segment) $segment
Return Values
bool
Description
public getSegmentAsString (int $index)Get the segment identified by index as string, using the messages separators.
Parameters
(int) $index: Index for segment to get
Return Values
string|null
String representation of segment
Description
public getSegmentByIndex (int $index)Return the segment specified by $index.
Note: Segment count within the message starts at 0.
Parameters
(int) $index: Index where segment is inserted
Return Values
\Segment
Description
public getSegmentFieldAsString (int $segmentIndex, int $fieldIndex)Get the field identified by $fieldIndex from segment $segmentIndex.
Returns empty string if field is not set.
Parameters
(int) $segmentIndex: Index for segment to get(int) $fieldIndex: Index for field to get
Return Values
mixed
String representation of field
Description
public getSegments (void)Return an array containing all segments in the right order.
Parameters
This function has no parameters.
Return Values
array
List of all segments
Description
public getSegmentsByName (string $name)Return an array of all segments with the given name
Parameters
(string) $name: Segment name
Return Values
array
List of segments identified by name
Description
public insertSegment (\Segment $segment, null|int $index)Insert a segment.
Parameters
(\Segment) $segment(null|int) $index: Index where segment is inserted
Return Values
void
Description
public removeSegmentByIndex (int $index)Remove the segment indexed by $index.
If it doesn't exist, nothing happens, if it does, all segments
after this one will be moved one index up.
Parameters
(int) $index: Index where segment is removed
Return Values
boolean
Description
public segmentToString ( $seg)Convert Segment object to string
Parameters
() $seg
Return Values
string
Description
public setSegment (\Segment $segment, int $index)Set the segment on index.
If index is out of range, or not provided, do nothing. Setting MSH on index 0 will re-validate field separator,
control characters and hl7 version, based on MSH(1), MSH(2) and MSH(12).
Parameters
(\Segment) $segment(int) $index: Index where segment is set
Return Values
boolean
Description
public toString (boolean $pretty)Return a string representation of this message.
This can be used to send the message over a socket to an HL7 server. To print to other output, use the $pretty
argument as some true value. This will not use the default segment separator, but '\n' instead.
Parameters
(boolean) $pretty: Whether to use \n as separator or default (\r).
Return Values
mixed
String representation of HL7 message