ms_splitsrcname man page

ms_splitsrcname — Split source names into the SEED naming nomenclature.

Synopsis

#include <libmseed.h>

char  *ms_splitsrcname ( char *srcname, char *net, char * sta,
                         char * loc, char *chan, char *qual );

Description

The ms_splitsrcname routine parses SEED channel naming components from a source name string in the following format:

"NET_STA_LOC_CHAN[_QUAL]"

The first four components are required to uniquely identify a SEED channel, generally these are always present in a srcname.  The Quality code is normally optional in a source name.

The arguments for the first four components (net, sta, loc & chan) are treated as strings but the quality code (qual) is treated as a pointer to a single character.

Memory for the requested component strings must already be allocated. If a component pointer is NULL it will not be parsed from the string.

Source names in the expected format are created, for example, by the ms_recsrcname(3), msr_srcname(3) and mst_srcname(3) routines.

Location Ids and Spaces

The source name should never include spaces.  The fixed format nature of SEED data records leads to blank or unused location IDs represented by spaces, in a source name such blank location IDs should be collapsed to nothing in the resulting sources names.  A blank location ID is parsed from a source name as an empty string (not two spaces).

Examples

This usage will result in net="IU", sta="ANMO", loc="00", chan="BHZ" and qual will remain unchanged (because it was not contained in the input srcname):

ms_splitsrcname("IU_ANMO_00_BHZ", net, sta, loc, chan, qual);

This usage will limit the parsing to only the network and station components with net="IU", sta="ANMO":

ms_splitsrcname("IU_ANMO_00_BHZ", net, sta, NULL, NULL, NULL);

The following usage illustrates a blank location ID and included quality code:

ms_splitsrcname("IU_ANMO__BHZ_Q", net, sta, loc, chan, qual);

The result is:

net = "IU"
sta = "ANMO"
loc = ""
chan = "BHZ"
qual = 'Q'

Return Values

Return 0 on success and -1 on error.

See Also

ms_recsrcname(3), msr_srcname(3) and mst_srcname(3).

Author

Chad Trabant
IRIS Data Management Center

Info

2009/12/19 Libmseed API